Requisição HTTP
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:
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:
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”):
Clique no botão “Testar a requisição” e então podemos salvar o resultado em várias variáveis:
Então podemos usar essas variáveis para exibir conteúdo dinâmico nos próximos envios:
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.
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.