Exemplo de utilização da etapa Rest API

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:

OBS #: 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?

OBS #: API utilizada no exemplo: https://swapi.co/api/starships/