Integrando seu chatbot na assistente virtual Alexa

Daniel Amaral

|

7 de julho de 2022
5 min. de leitura
Conteúdo
Avatar
Daniel Amaral

|

7 de julho de 2022
5 min. de leitura
Integrando seu chatbot na assistente virtual Alexa

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:

  1. Abra seu aplicativo Alexa, procure pela skill Voice Monkey e clique em Iniciar e conceda as permissões solicitadas:
voice monkey alexa
  • 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.
manage monkey alexa
  • 4. Dê um nome a sua Trigger. Aqui vamos chamar de Saldo das contas (slug: saldo-das-contas).
new monkey voice monkey

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.

  1. Abra o App Alexa e clique em Mais. Depois, acesse a opção Rotinas.
criar rotina alexa

Depois é só clicar em “Adicionar nova rotina”

adicionar nova rotina alexa
  1. Insira um nome para essa rotina. Para esse tutorial escolhemos “Alerta de saldo da conta”
  2. Toque em “Quando isso acontecer”, depois “Casa Inteligente” e depois ” Saldo de Contas”
  3. Clique em “Adicionar ação”, Skills e depois em Voice Monkey
  4. Por fim, escolha de qual dispositivo a Alexa vai falar e clique em “salva”
adicionar rotina echo dot

Feito isso, a sua rotina ficará configurada da seguinte maneira:

editar rotina alexa

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:

token voice monkey

Agora, vá até o seu projeto no Dash da Weni (Weni Plataforma) e clique em “Configurações” e depois em “Globais”.

configurações weni plataforma

Clique nas variáveis destacadas na imagem abaixo e cole os tokens correspondentes:

manage globais weni plataforma

Depois clique em Update:

update token weni plataforma

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.

entrar em um fluxo weni plataforma

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:

  1. Na pagina inicial, clique em Create.
ifttt

Depois, clique no primeiro bloco “If this”

create ifttt alexa

Feito isso, procure por Alexa e clique no card azul com o ícone dela:

choose alexa in ifttt

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”:

integrações alexa

Depois escolha uma frase de ativação para essa ação. Para esse teste, escolhemos “saldo das contas”. Em seguida, clique em create trigger.

create trigger ifttt

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”

webhook alexa ifttt

Aqui você chamará a API flow_starts.json da Weni Plataforma. Configure de acordo com o seu projeto, como no exemplo:

web request amazon

Na sequência, faça os seguintes passos:

  1. Em additional headers coloque Authorization: token uuid-do-seu-projeto (você pode copiar na configuração do seu projeto
  2. Em body: {“flow”:uuid-do-seu-fluxo”,”urns”:[ext:alexa”]}.
  3. 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”
additional headers

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”

criando nova rotina para alexa

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:

variações de frases alexa

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.

salvando nova rotina alexa

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

Conteúdos relacionados

Copyright © 2022 Weni. All rights reserved.