Olá, Cosmonauta! Você sabia que uma das soluções da plataforma é conectar o bot à API's externas?
Dentre essas soluções temos a Rest API. Ela possibilita chamar dados externos para dentro do ChatBot.
Nesse exemplo demonstraremos como utilizar dados de uma api externa.
Vamos lá!
1- Crie uma mensagem com duas opções para o usuário escolher.
Dica # 1: Você pode vincular a etapa API à diversas fases, nesse exemplo vinculamos aos botões da mensagem, mas se preferir também pode vincular às opções da mensagem criando um vinculo manual em JavaScript.
2- Clique em rest API e preencha:
Nome: Com o nome da API
Método: Nesse exemplo utilizamos o método post, mas existem outros métodos que podem ser utilizados.
URL: Endereço da API
Tipo de parâmetros: Aqui escolhemos Json, mas existem outras opções dentro da plataforma:
Dica # 2: Fique atendo à URL da API, caso ela tenha mais de uma página verifique se a url das próximas páginas sofre alteração.
3- Utilizando a variável response_x trate os dados da API para puxar apenas os dados que você quer que o bot consuma, vamos puxar os dados que a primeira pergunta irá receber:
Dica # 3 : Para retornar os dados ao usuário final, utilize If e insira quais dados você quer que a API consuma. Segue código utilizado nesse exemplo:
const starships = response__x;
context.quantidade_naves = starships.next
context.quantidade_naves = starships.count
console.log(starships.count)
context.naves_disponiveis=starships.results
if (context.naves_disponiveis){
send_message.push({
type: 'text',
text: 'Nome: '+ context.naves_disponiveis[0].name + '\n'+
'Comprimento: ' + context.naves_disponiveis[0].length
4- Agora vamos criar a api da segunda pergunta:
Observação #: Note que conforme mencionado na dica 3, tivemos uma mudança na página da API, a url da API vinculada à primeira pergunta é https://swapi.co/api/starships/?page=3 e a vinculada à segunda pergunta é https://swapi.co/api/starships/, quando as páginas mudaram os dados retornados também mudam.
4 - Agora é só criar as próximas Mensagens, Filtros e Etapas que irão compor o bot:
Vamos ver como ficou?
Observações:
API utilizada no exemplo: https://swapi.co/api/starships/
Para mais informações sobre o a utilização do bot, clique aqui.