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:

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.