> ## 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.

# Guia: Primeiro Dispositivo

> Tutorial completo para conectar seu primeiro dispositivo ao Portal

# Conectando Seu Primeiro Dispositivo

Este guia mostra como adicionar seu primeiro dispositivo ao Portal, desde a configuração da integração até a verificação no dashboard.

<Steps>
  <Step title="Escolha sua integração">
    Identifique a plataforma do seu dispositivo. As mais comuns são:

    | Dispositivo            | Integração |
    | ---------------------- | ---------- |
    | Lâmpadas/tomadas Tuya  | Tuya       |
    | Dispositivos Sonoff    | eWeLink    |
    | Dispositivos Shelly    | Shelly     |
    | Dispositivos com MQTT  | MQTT       |
    | Cortinas/persianas KNX | KNX        |
  </Step>

  <Step title="Adicione a integração">
    1. Va em **Configurações → Integrações**
    2. Clique em **Adicionar Integração**
    3. Selecione a plataforma do seu dispositivo
    4. Siga o fluxo de configuração (credenciais, servidor, etc.)
  </Step>

  <Step title="Aguarde a descoberta">
    Após configurar a integração, o Portal iniciara a descoberta automática de dispositivos. Isso pode levar alguns segundos.
  </Step>

  <Step title="Verifique os dispositivos">
    Va em **Configurações → Integrações → \[sua integração]** e verifique se os dispositivos foram encontrados. Clique na entrada de configuração para ver a lista.
  </Step>

  <Step title="Verifique as entidades">
    Cada dispositivo criara uma ou mais entidades. Acesse **Configurações → Entidades** para ver todas.
  </Step>

  <Step title="Adicione ao dashboard">
    1. Va para **Visao Geral** (dashboard)
    2. Entre no modo de edicao (ícone de lapis)
    3. Clique em **Adicionar Card**
    4. Selecione o tipo de card (luz, interruptor, cortina, etc.)
    5. Escolha a entidade do seu dispositivo
    6. Salve
  </Step>

  <Step title="Teste o controle">
    Clique no card para verificar se o dispositivo responde. Teste ligar, desligar, ajustar, etc.
  </Step>
</Steps>

<Warning>
  No plano Free, apenas a integração com dispositivos do domínio **cover** (cortinas/persianas) está disponível, com limite de 1 integração e 1 dispositivo.
</Warning>

<Tip>
  Se o dispositivo não aparecer na descoberta, verifique se ele está conectado a mesma rede WiFi e se as credenciais da integração estão corretas.
</Tip>