Trilha Avançada

Criando Chatbots Transacionais

1. Analisar exemplo de API

Neste tutorial, vamos fazer uma integração com uma API pública e gratuita que pode ser chamada para obter os dados de um determinado CEP.

Para observar um exemplo da saída dessa API, acesse: exemplo viacep.

2. Criar a integração

1. Acessar o chatbot criado a partir do tutorial Criação de Chatbot.

2. No menu lateral, acionar INTEGRAÇÕES.

3. Na página Integrações, acionar a opção NOVA INTEGRAÇÃO.

4. Na tela para criar uma nova integração, preencher os seguintes campos:

   • Nome: obterCEP
   • Método HTTP: GET
   • Endereço Base: http://viacep.com.br
   • Porta: 80
   • Caminho: /ws/{cep}/json/

   

5. Clicar no botão Salvar. Você será redirecionado para a tela de listagem das integrações.

6. Nesta tela, habilitar a integração.

   

3. Usar a integração em um Motor RiveScript

1. No menu lateral, acionar MOTORES DE CONVERSAÇÃO.

2. Na página Motores de conversação, acionar a opção NOVO MOTOR.

3. Escolher o motor Rivescript e clique em Criar.

4. Escrever um nome para o motor, por exemplo, Rivescript com Integrações.

5. Copiar e colar as regras a seguir no campo Regras.

   +CEP *
   
   *<call>obterCEP "{'cep': '<star>'}"</call> != undefined => Consultei o CEP <star>. Seu logradouro é <get logradouro>.
   

   

4. Testar a integração

1. Clicar em Salvar.

2. Clicar no botão Teste seu chatbot no meu da esquerda.

3. Digitar a mensagem: "CEP 40290280".

4. Verificar a resposta: "Consultei o CEP 40290280. Seu logradouro é Rua Cruz e Souza".

Para saber mais

Consulte a documentação da plataforma Serprobots.