HTTP Request

O bloco HTTP Request permite que você envie requisições HTTP para serviços de terceiros. Isso é útil para:

  • Enviar informações do bot para outro serviço.

  • Buscar informações de outro serviço e utilizá-las no bot

🔧 Atenção! Para configurar este bloco corretamente, é importante contar com o apoio de alguém com conhecimentos técnicos. Isso porque ele envolve integração com APIs externas, uso de variáveis e, em alguns casos, autenticação.

Como Configurar uma Requisição HTTP

1. Adicionar o Bloco HTTP Request

No editor do chatbot, adicione o bloco HTTP Request ao seu fluxo.

2. Definir a URL de Destino

Insira a URL do serviço externo para o qual deseja enviar a requisição.

3. Escolher o Método HTTP

Selecione o método apropriado para sua requisição:

  • GET: Recuperar dados.

  • POST: Enviar novos dados.

  • PUT: Atualizar dados existentes.

  • DELETE: Remover dados.

4. Configurar o Corpo da Requisição (Body)

Você pode definir um corpo personalizado utilizando variáveis coletadas no bot. Exemplo:

{
  "name": "{{Name}}",
  "email": "{{Email}}"
}

5. Testar a Requisição

Utilize a opção "Testar a requisição" para verificar se a integração está funcionando corretamente.

6. Salvar Respostas em Variáveis

Você pode mapear os dados retornados pela API para variáveis do chatbot, permitindo o uso dessas informações em outras partes do fluxo.

🧾 Exemplo Prático: Buscar Informações de um Endereço a partir do CEP

Suponha que você queira criar um bot que pergunte ao usuário o CEP e, em seguida, recupere o endereço correspondente usando a API pública do ViaCEP.

Solicite o CEP ao usuário e salve em uma variável, por exemplo, {{cep}}

Configure a URL da requisição como:

https://viacep.com.br/ws/{{cep}}/json/

Use o método GET e não é necessário configurar headers ou body, pois a API do ViaCEP não exige autenticação.

Teste a requisição e mapeie os dados retornados (como logradouro, bairro, localidade e uf) para variáveis do Typebot, como:

  • {{rua}} = logradouro

  • {{bairro}} = bairro

  • {{cidade}} = localidade

  • {{estado}} = uf

Utilize essas variáveis para exibir as informações ao usuário:

🔍 Aqui está o endereço encontrado:

• Rua: {{rua}}
• Bairro: {{bairro}}
• Cidade: {{cidade}} - {{estado}}

Parâmetros Avançados

  • Timeout: Por padrão, o bloco aguardará 10 segundos por uma resposta do serviço externo. Se não houver resposta nesse tempo, a requisição falhará. Você pode ajustar esse valor nas configurações avançadas do bloco.

Solução de Problemas:

  • Requisição falhou ou não foi acionada: Verifique os logs disponíveis no construtor para identificar possíveis erros.

  • Ferramentas de Depuração: Utilize ferramentas como Webhook Tester para visualizar os payloads das requisições e facilitar a depuração.

AnteriorSheetsPróximoE-mail

Atualizado