O bloco de Requisição HTTP permite enviar uma requisição HTTP para um serviço de terceiros. Isso é útil para enviar informações do bot para outro serviço ou para buscar informações de outro serviço e usá-las no bot.

Fazer uma requisição à API e obter dados

Isso se torna mais técnico, pois você precisará saber mais sobre os parâmetros da requisição HTTP.

Muitos serviços oferecem uma API. Eles também provavelmente têm uma documentação da API. Dependendo dos parâmetros que você fornecer ao bloco de requisição HTTP, ele deve retornar informações diferentes do serviço de terceiros.

Body personalizado

Você pode definir um body personalizado com suas variáveis coletadas. Aqui está um exemplo funcional:

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

Exemplo com uma API fictícia: CRIAR e OBTÉM

Este vídeo fornece um guia passo a passo para configurar com sucesso blocos de requisição HTTP no Typebot.

Demonstro como configurar o bloco de requisição HTTP, incluindo o URL, método e corpo personalizado. Também mostro como testar a requisição e salvar o ID do novo funcionário criado. Finalmente, explico como implementar o ponto de extremidade para encontrar o funcionário por ID e mapear o nome do funcionário para uma variável.

Exemplo: obter informações de filme

Vamos criar um bot que pede por um filme e recupera suas informações (enviando uma requisição HTTP para a API OMDB).

A partir da documentação, sei que ao chamar este URL específico: http://www.omdbapi.com/?t=Star%20Wars&apikey=1eb4670b, ele buscará as informações do filme “Star Wars” e retornará dados JSON.

O que preciso no meu caso é, em vez de inserir “Star Wars”, gostaria de inserir uma variável do fluxo:

Variavel em URL

Então, podemos definir um valor de teste para nossa variável (ele substituirá a variável por este valor apenas para o botão “Testar a requisição”):

Variable test values

Clique no botão “Testar a requisição” e então podemos salvar o resultado em várias variáveis:

Test request

Então podemos usar essas variáveis para exibir conteúdo dinâmico nos próximos envios:

Preview

As possibilidades são infinitas quando se trata de chamadas de API, você pode literalmente chamar qualquer API e buscar qualquer dado que desejar.

Chamar um URL de Webhook

Seu serviço de terceiros (Make.com, Zapier, etc) está fornecendo a você um URL de Webhook.

Você só precisa colar este URL no bloco de Webhook e clicar em “Testar a requisição”. Por padrão, o serviço de terceiros receberá uma captura do que o bot poderia enviar.

Simple Webhook POST

Você também pode decidir personalizar a requisição enviada ao serviço de terceiros.

Timeout

Por padrão, o bloco de Webhook aguardará 10 segundos para que o serviço de terceiros responda. Se não responder a tempo, o bloco falhará. Você pode personalizar esse valor de tempo limite na seção “Parâmetros avançados” das configurações do bloco de Webhook.

Solução de Problemas

A requisição do bloco de Webhook falhou ou não pareceu ser acionada? Certifique-se de verificar os logs. Se ainda não conseguir descobrir o que deu errado, me envie uma mensagem usando o botão de chat diretamente na ferramenta 👍

O Webhook não é executado na ordem correta?

Isso é esperado, o Typebot na verdade calcula todos os blocos entre cada bloco de entrada de um servidor antes de exibir qualquer coisa.