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

# Amazon Alexa

> Integre seus dispositivos do Portal com a Amazon Alexa

# Amazon Alexa

O Portal se integra com a **Alexa Smart Home Skill v3** para controle de dispositivos por voz.

## Tipos de Dispositivos Suportados

| Tipo                          | Controller Alexa            | Comandos                              |
| ----------------------------- | --------------------------- | ------------------------------------- |
| **Light** (Luz)               | PowerController             | "Alexa, ligue a luz da sala"          |
| **Switch** (Interruptor)      | PowerController             | "Alexa, ligue a tomada"               |
| **Cover** (Cortina)           | PercentageController        | "Alexa, feche a cortina"              |
| **Lock** (Fechadura)          | LockController              | "Alexa, tranque a porta"              |
| **Climate** (Ar Condicionado) | ThermostatController        | "Alexa, ajuste para 23 graus"         |
| **Media Player**              | PlaybackController, Speaker | "Alexa, pause a música"               |
| **Fan** (Ventilador)          | RangeController             | "Alexa, ajuste o ventilador para 50%" |
| **Button** (Botão)            | SceneController             | "Alexa, ativar botão"                 |
| **Select** (Seletor)          | ModeController              | "Alexa, mude o modo para..."          |
| **Script**                    | SceneController             | "Alexa, ativar Rotina da Manha"       |

## Vincular a Alexa

<Steps>
  <Step title="Exponha as entidades">
    Va em **Configurações → Assistentes de Voz → Expor Entidades** e selecione os dispositivos que deseja controlar pela Alexa.
  </Step>

  <Step title="Ative a Skill">
    No app da Alexa, busque a skill do **Portal** e ative-a. Você será redirecionado para autenticar sua conta.
  </Step>

  <Step title="Descubra dispositivos">
    Diga "Alexa, descubra meus dispositivos" ou va em Dispositivos no app Alexa e clique em Descobrir.
  </Step>

  <Step title="Pronto!">
    Seus dispositivos expostos agora podem ser controlados por voz.
  </Step>
</Steps>

## Discovery (Descoberta)

O processo de discovery funciona assim:

1. A Alexa envia uma requisição de descoberta ao Portal
2. O Portal busca as entidades expostas do usuário
3. As entidades são filtradas pelos **domínios permitidos** do plano
4. Para cada entidade, um endpoint Alexa e criado com os controllers apropriados
5. A lista de endpoints e retornada para a Alexa

## Comandos de Exemplo

```
"Alexa, ligue a luz da sala"
"Alexa, ajuste a luz do quarto para 50%"
"Alexa, feche a cortina da varanda"
"Alexa, qual a temperatura do quarto?"
"Alexa, tranque a porta da frente"
"Alexa, ajuste o ar condicionado para 22 graus"
"Alexa, ativar Rotina da Noite"
```

<Tip>
  Use nomes claros e únicos para suas entidades. Nomes como "Luz 1" e "Luz 2" podem confundir a Alexa. Prefira "Luz da Sala" e "Luz do Quarto".
</Tip>