Amazon Alexa
O Portal se integra com a Alexa Smart Home Skill v3 para controle de dispositivos por voz.Tipos de Dispositivos Suportados
Vincular a Alexa
1
Exponha as entidades
Va em Configurações → Assistentes de Voz → Expor Entidades e selecione os dispositivos que deseja controlar pela Alexa.
2
Ative a Skill
No app da Alexa, busque a skill do Portal e ative-a. Você será redirecionado para autenticar sua conta.
3
Descubra dispositivos
Diga “Alexa, descubra meus dispositivos” ou va em Dispositivos no app Alexa e clique em Descobrir.
4
Pronto!
Seus dispositivos expostos agora podem ser controlados por voz.
Discovery (Descoberta)
O processo de discovery funciona assim:- A Alexa envia uma requisição de descoberta ao Portal
- O Portal busca as entidades expostas do usuário
- As entidades são filtradas pelos domínios permitidos do plano
- Para cada entidade, um endpoint Alexa e criado com os controllers apropriados
- A lista de endpoints e retornada para a Alexa
Comandos de Exemplo
Estes comandos usam a Smart Home Skill, que responde sem precisar citar o nome da skill. É o caminho recomendado para controlar dispositivos.A skill de voz (“flex home”) também aceita comandos diretos — “Alexa, pede pra flex home ligar a luz da sala” — mas só verbos de ação, e não responde a perguntas.
Pedidos de Voz como Gatilho
Além de controlar dispositivos, a Alexa pode disparar automações quando alguém fala um pedido reconhecido. O Portal não decide o que fazer — quem decide é a automação que você montar.Urgência
Bem-estar e rotina
Por que tantos pedidos separados em vez de um só. Cada um dispara uma resposta diferente: dor aciona enfermagem, solidão aciona companhia, e “preciso ir ao banheiro” precisa de alguém antes que a pessoa tente levantar sozinha. Se todos virassem um “chamado” genérico, a automação não teria como distinguir.Dor no peito é emergência, não dor. Falta de ar e dor torácica ficam no pedido de Emergência — podem ser infarto e não entram em fila de chamados.
Como usar
1
Crie a automação
Em Automações → Nova, escolha o gatilho Voz da Alexa e selecione o pedido que quer reconhecer.
2
Defina o que acontece
Adicione as ações — notificar alguém, anunciar num Echo, acender uma luz. Use Aguardar entre as ações para criar escalonamento.
3
Teste falando
Diga “Alexa, pede socorro pra flex home”. A automação dispara e o histórico mostra de qual Echo veio.
4
Restrinja por cômodo (opcional)
Copie o
device_id do histórico e cole no gatilho para criar automações específicas por ambiente.Emergência nunca espera. O pedido de socorro dispara mesmo que a conta Alexa não esteja vinculada a um usuário do Portal — negar ajuda por burocracia não é aceitável. A automação é identificada pela organização.
Falar sem citar a skill
Por padrão é preciso invocar a skill: “Alexa, pede socorro pra flex home”. Sob estresse, ninguém lembra disso. Para falar apenas “Alexa, socorro”, crie uma Rotina no app da Alexa:- App Alexa → Mais → Rotinas → +
- Quando isso acontecer → Voz → digite
socorro - Adicionar ação → Skills → Portal → o pedido desejado
Formas de falar
A skill aceita o pedido de duas maneiras:
Depois de aberta, a skill continua ouvindo — dá para dizer “estou bem” ou “já tomei o remédio” sem reinvocar.
Na forma direta, várias construções funcionam:
A Alexa entrega à skill tudo que vem depois do nome dela — incluindo preposições e conjunções. Por isso “por socorro” e “que estou bem” precisam ser reconhecidos como frases próprias, e não apenas “socorro” e “estou bem”.Se uma construção sua não for reconhecida, ela cai no “não entendi” e a skill pede para repetir — a sessão continua aberta.
Exemplo: escalonamento de emergência
Exemplo: prevenção de queda
O pedido de ajuda para levantar é o mais preventivo do conjunto — o banheiro concentra a maior parte das quedas, e o gatilho costuma ser a tentativa solitária de sair da cama.Exemplo: lembrete de medicação com confirmação
O Portal pode anunciar num Echo usando a integraçãoalexa_devices. Combinado com o pedido “Remédio tomado”, fecha o ciclo: