Integrações

O que é

É a forma de integrar o seu chatbot a outros sistemas com o objetivo de obter informações de interesse de seus usuários ou que são relevantes para o contexto da conversação.

Na prática

O Serprobots permite que seu chatbot se conecte a serviços externos de forma segura e rápida por meio de webhooks.

Fica a dica

Quando criar e salvar uma Nova Integração e receber a mensagem significa que existe uma pendência porque o endereço do serviço está sendo bloqueado pelas regras de segurança do SERPRO.

Solicite a liberação do endereço junto ao time de Suporte do Serprobots. A integração será exibida com o marcador até que seja resolvida a pendência.

Detalhes da tela

Deve-se acionar a opção Nova Integração e informar os parâmetros:

Campo	Descrição
Nome	Informe um nome para a integração e anote-o. Este nome será utilizado para referenciar a integração tanto no Watson Assistant, como no Rivescript
Método HTTP	O Serprobots provê suporte aos métodos POST, PUT, DELETE e GET.
Endereço Base	Endereço base para a API que será consultada. Este endereço pode ser tanto de um sistema interno ao Serpro, como de um externo.
Porta	Número da porta em que a API estará disponível.
Caminho	Indique o caminho (path) que deve ser usado para chegar a uma API. Por exemplo, considerando que você cadastrou o endereço base da sua API para https://api.serpro.gov.br e você tem um endpoint com /cpf, então, você deve cadastrar no campo caminho apenas /cpf. O Serprobots remove qualquer barra ao final do caminho.
Cabeçalho da Requisição	Adicione todos os cabeçalhos que serão necessários para acessar a API, informando o nome e o valor para cada um.