Nesse artigo, mostro como você pode integrar o seu chatbot, criado na plataforma Weni, integrando a Alexa. No final deste tutorial, você poderá enviar mensagens de texto pra sua Alexa a partir de um fluxo simples e construído por você.
No vídeo abaixo você confere como o seu chatbot funciona na Alexa após configurado:
Vamos começar?
Passo 1: Importe o fluxo de integração ao seu projeto
Considerando que você já possui uma conta na Weni, entre no seu projeto e importe o fluxo “Integrando Weni a Alexa”.
Passo 2: Crie uma Trigger na skill Voice Monkey
Para criar uma trigger, você precisará instalar a skill Voice Monkey na sua conta da Alexa. Para isso, siga os seguintes passos:
- Abra seu aplicativo Alexa, procure pela skill Voice Monkey e clique em Iniciar e conceda as permissões solicitadas:
- 2. Acesse o site Voice Monkey e faça login com a mesma conta cadastrada na sua Alexa.
- 3. Acesse o menu Manage Monkeys e clique em Add a monkey.
- 4. Dê um nome a sua Trigger. Aqui vamos chamar de Saldo das contas (slug: saldo-das-contas).
Passo 3: Configure sua trigger na Alexa
No aplicativo da Alexa, você deve criar uma Rotina para que sua Alexa saiba o que fazer quando a plataforma Weni disparar o fluxo que importamos.
- Abra o App Alexa e clique em Mais. Depois, acesse a opção Rotinas.
Depois é só clicar em “Adicionar nova rotina”
- Insira um nome para essa rotina. Para esse tutorial escolhemos “Alerta de saldo da conta”
- Toque em “Quando isso acontecer”, depois “Casa Inteligente” e depois ” Saldo de Contas”
- Clique em “Adicionar ação”, Skills e depois em Voice Monkey
- Por fim, escolha de qual dispositivo a Alexa vai falar e clique em “salva”
Feito isso, a sua rotina ficará configurada da seguinte maneira:
Passo 4: Configurando os tokens de integração no seu projeto
Agora que tudo parece estar conectado, precisamos copiar o access_token e o secret_token na sua conta do Voice Monkey.
Acessando novamente o site do Voice Monkey, e logando com a mesma conta da Alexa, entre no menu Dashboard e copie os dois tokens conforme a imagem abaixo:
Agora, vá até o seu projeto no Dash da Weni (Weni Plataforma) e clique em “Configurações” e depois em “Globais”.
Clique nas variáveis destacadas na imagem abaixo e cole os tokens correspondentes:
Depois clique em Update:
Vamos testar?
Agora abra o fluxo anteriormente importado (Integrando Weni a Alexa), abra os parâmetros de entrada do fluxo, e insira o nome da trigger que você criou no site Voice Monkeys.
Disparando alertas e usando seu chatbot na Alexa
Agora que você já configurou seu chatbot na assistente virtual da Alexa, vamos mostrar um passo a passo para disparar o alerta de saldo bancário que fizemos a partir de uma pergunta à Alexa e em apenas dois passos.
Vamos lá?
Passo 1: Crie uma conta no IFTTT
O IFTTT é um serviço que conecta diversas ferramentas, com ele vai ser possível conectar uma pergunta feita na Alexa com a chamada de um fluxo na Plataforma Weni.
Considerando que você já se cadastrou no o IFTTT:
- Na pagina inicial, clique em Create.
Depois, clique no primeiro bloco “If this”
Feito isso, procure por Alexa e clique no card azul com o ícone dela:
Aparecerá na sua tela quais os tipos de integrações que a Alexa tem disponível no IFTTT. Escolha a opção “Say specific phrase”:
Depois escolha uma frase de ativação para essa ação. Para esse teste, escolhemos “saldo das contas”. Em seguida, clique em create trigger.
Após isso, você será redirecionado para o passo 2. Na nova tela, clique no bloco “Then that” e procure por Webhook. Depois clique em “Make a web request”
Aqui você chamará a API flow_starts.json da Weni Plataforma. Configure de acordo com o seu projeto, como no exemplo:
Na sequência, faça os seguintes passos:
- Em additional headers coloque Authorization: token uuid-do-seu-projeto (você pode copiar na configuração do seu projeto
- Em body: {“flow”:uuid-do-seu-fluxo”,”urns”:[ext:alexa”] }.
- Onde o “uuid”-do-fluxo” é o uuid do fluxo chamado: integrando Weni à Alexa que importamos na Parte 1 desde tutorial e depois clique em “Create Action”
Passo 2: Crie a rotina no app Alexa
Para começar, insira o nome para a rotina. Neste teste, chamamos de “Saldo de Contas – Passivo”
Quando isso acontecer, clique em +, depois em voz e coloque as frases que você eventualmente pediria à Alexa para executar essa ação que configurou. Você pode adicionar várias frases e variações:
Na sequência, em Adicionar Ação, clique em + e depois em IFTTT. Depois em saldo de contas (ou na frase de ação que você criou) e salve a sua nova rotina.
Pronto! Agora é só perguntar a sua Alexa com uma das frases que criou a rotina e ela irá responder. Até o próximo tutorial!
Ficou com alguma dúvida? Use nossa comunidade para perguntar! Comunidade Weni
