> ## 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: Configurar Alexa

> Tutorial completo para integrar o Portal com a Amazon Alexa

# Configurando a Alexa

Siga este guia para controlar seus dispositivos do Portal usando a Amazon Alexa.

## Pre-requisitos

* Conta no Portal com dispositivos configurados
* Dispositivo com Alexa (Echo, Echo Dot, app Alexa)
* Plano Padrão (ou plano Free com dispositivos cover)

<Steps>
  <Step title="Exponha as entidades">
    1. Va em **Configurações → Assistentes de Voz**
    2. Clique em **Expor Entidades**
    3. Selecione os dispositivos que deseja controlar pela Alexa
    4. Salve

    <Info>
      No plano Free, você pode expor até 5 entidades, apenas do domínio cover.
    </Info>
  </Step>

  <Step title="Ative a Skill Portal">
    1. Abra o app **Amazon Alexa** no celular
    2. Va em **Mais → Skills e Jogos**
    3. Busque por **Portal** ou **Portal Unicontrol**
    4. Toque em **Ativar**
    5. Faca login com sua conta do Portal quando solicitado
  </Step>

  <Step title="Descubra dispositivos">
    Diga: **"Alexa, descubra meus dispositivos"**

    Ou va em **Dispositivos → Descobrir** no app Alexa. A descoberta pode levar até 45 segundos.
  </Step>

  <Step title="Teste os comandos">
    Experimente comandos de voz:

    * "Alexa, ligue a luz da sala"
    * "Alexa, feche a cortina do quarto"
    * "Alexa, ajuste o ar para 22 graus"
    * "Alexa, ativar Rotina da Manha" (para scripts)
  </Step>
</Steps>

## Solucao de Problemas

| Problema                   | Solucao                                           |
| -------------------------- | ------------------------------------------------- |
| Dispositivos não aparecem  | Verifique se estão expostos em Assistentes de Voz |
| "Dispositivo não responde" | Verifique se a entidade está online no Portal     |
| Skill não conecta          | Verifique suas credenciais OAuth                  |
| Apenas covers aparecem     | Você esta no plano Free (upgrade para Padrão)     |

<Tip>
  Após expor novas entidades, sempre execute uma nova descoberta de dispositivos na Alexa.
</Tip>