> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unicontrol.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Toptic

> Integre o controle de acesso Toptic ao Portal via API cloud

# Toptic

A integração Toptic conecta o **sistema de controle de acesso Toptic** ao Portal via **API cloud**, expondo cada ponto de acesso como uma fechadura e sincronizando pessoas com um **grupo de acesso padrão**.

## Pre-requisitos

* Conta Toptic com um usuário de **perfil API** ativo
* Ao menos **um grupo de acesso** cadastrado no Toptic
* Ao menos **um ponto de acesso** ativo
* URL base da API (padrão `https://accessus.toptic.com.br`)

## Configurar

<Steps>
  <Step title="Adicione a integração">
    Va em **Configurações → Integrações → Adicionar → Toptic**.
  </Step>

  <Step title="Autentique-se">
    Preencha URL base, usuário API e senha.
  </Step>

  <Step title="Escolha o grupo de acesso padrão">
    Selecione o **grupo de acesso** onde o Portal irá sincronizar as pessoas. Este grupo passa a receber automaticamente cada nova pessoa cadastrada no Lock Manager.
  </Step>
</Steps>

## Recursos

* **`lock`** — uma entidade por ponto de acesso (Access Point) cadastrado no Toptic
* Sincronização automática de pessoas para o grupo padrão via **Lock Manager**

## Como Funciona

O token da API tem tempo de vida definido e é renovado automaticamente. Se a conta não tiver **grupos de acesso** ou **pontos de acesso** cadastrados, o config flow aborta com uma mensagem explicativa.

<Info>
  Combine com o **Lock Manager** para provisionar pessoas em massa — cada pessoa criada entra no grupo padrão escolhido no config flow.
</Info>