Chatbot - Requisições no B4B – Sustentação New Way

Para realizar requisições no Builder4Bots é só selecionar o tipo de caixa "Requisição":

Logo após aparecerá no canto lateral direito as opções de configuração da requisição:

Segue abaixo um descritivo sobre cada campo:

TÍTULO

O título não tem influência sobre a requisição, podendo ser inserido qualquer identificação para facilitar a análise do fluxo.

URL

Na URL tem de ser inserido uma rota com "https", no padrão Rest, sendo possível também utilizar variáveis do próprio B4B ou coletadas durante o fluxo para realizar as requisições.
Por exemplo: https://apibuscacpf.com.br/cpf/@cpf

CORPO

No corpo (Body) deve ser inserido os dados no padrão JSON. Exemplo:
{

"cpf": "@cpf"

}

CABEÇALHO

Para habilitar o cabeçalho (Header), deve ser ativado na flag abaixo:

No cabeçalho, conforme a utilização do corpo, deve ser utilizado o padrão JSON.
Por exemplo:
{

"authorization": "Basic d93b2c6007d15f89b21ef9569347d44632714b25912f2a419017a0f46cb7e123"

}

TEMPO LIMITE
No tempo limite é possível configurar quanto tempo levará cada tentativa.
Obs.: Evitar colocar mais que 60 segundos, pois pode impactar na velocidade de retorno do Bot.

QUANTIDADE DE TENTATIVAS

Na quantidade de Tentativas é possível informar quantas vezes será repetida a requisição em caso de falha.

Obs.: Evitar colocar muitas tentativas, pois pode impactar na velocidade de retorno do Bot.

MÉTODO

Para habilitar a troca de Método HTTP na requisição, deve ser ativado no botão abaixo:

Caso não seja alterado, será considerado o método GET.

ARMAZENAR STATUS CODE

Nesse campo pode ser inserido qualquer identificação, onde retornará a string "Sucesso" ou "Falha".

Criar variáveis para receber o retorno da requisição

Para configurar uma variável com o intuito de receber o retorno da requisição, basta clicar no botão abaixo:

Após clicar nesse botão, abrirá a opção de cadastro da variável, conforme abaixo:

DEFINIR CAMINHO

Nesse campo deve ser inserido qual informação você deseja coletar da API.
Por exemplo, a API retorna os dados abaixo:
{
    "channels":
    [
        {
            "name": "Home",
            "type": "b4b"
        },
        {
            "name": "Whatsapp office",
            "type": "whatsapp"
        }
    ]
}

Caso eu queira coletar todos os dados na variável, basta eu inserir [] no campo "DEFINIR CAMINHO". Para posteriormente acessar alguma informação dentro do JSON, é só seguir o padrão @nome_da_variavel.propriedade_desejada.
Exemplo: @response.channels.0.type

Caso queira definir uma informação absoluta dentro do JSON já no "DEFINIR CAMINHO" é só informar no padrão o caminho dentro de [], separando por vírgula simples.
Exemplo: ["channels", 0, "type"]

SALVAR RESPOSTA NO CAMPO

Nesse campo você pode inserir o nome que será utilizado para os dados coletados. Há possibilidade de utilizar uma variável já criada ou inserir um novo nome. Para acessar essa variável em outro local, basta utilizar o padrão @nome_da_variavel.

TIPO

Nesse campo deve ser informado qual o tipo da variável. Por padrão vem como tipo Texto, contudo pode ser alterado para outros tipos.

Decisão de Sucesso ou falha

Após clicar em salvar sua requisição, a mesma apresentará da seguinte forma:

Sendo assim, será considerado como sucesso os retornos com Status_Code 2XX, no padrão Rest
Exemplo: 200, 201, etc.

E para falha o que for diferente do retorno 2XX.
Exemplo: 402, 504, etc.

Artigos nessa seção

Artigos relacionados