Requisição HTTP

O bloco de requisição HTTP envia uma requisição para um serviço externo. Serve tanto para mandar informações do bot para outro serviço quanto para buscar dados em outro serviço e usá-los no bot.

Fazer uma requisição de API e buscar dados

Esta parte é mais técnica, porque exige conhecer os parâmetros de uma requisição HTTP.

Muitos serviços oferecem uma API e, quase sempre, uma documentação dela. Conforme os parâmetros que você passar ao bloco de requisição HTTP, o serviço externo devolverá informações diferentes.

Corpo personalizado

Você pode montar um corpo personalizado com as variáveis coletadas. Veja um exemplo funcional:

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

Exemplo com uma API de teste: CREATE e GET

Este vídeo traz um passo a passo para configurar corretamente os blocos de requisição HTTP no GG.chatbot.

Demonstro como configurar o bloco — URL, método e corpo personalizado —, como testar a requisição e salvar o ID do funcionário recém-criado. Por fim, explico como implementar o endpoint de busca por ID e mapear o nome do funcionário para uma variável.

Exemplo: buscar informações de um filme

Vamos criar um bot que pergunta o nome de um filme e busca seus dados, enviando uma requisição HTTP para a API do OMDB.

Pela documentação, sei que chamar esta URL — http://www.omdbapi.com/?t=Star%20Wars&apikey=1eb4670b — busca as informações do filme "Star Wars" e devolve dados em JSON.

No meu caso, em vez de "Star Wars" fixo, quero inserir uma variável do GG.chatbot:

Em seguida, definimos um valor de teste para a variável (ele substitui a variável apenas no botão "Testar a requisição"):

Clique em "Testar a requisição" e então salve o resultado em várias variáveis:

Depois, use essas variáveis para exibir conteúdo dinâmico nos balões seguintes:

As possibilidades são infinitas quando se trata de chamadas de API: você pode literalmente chamar qualquer uma e buscar os dados que quiser.

Se tiver dificuldade para configurar um bloco de Webhook, peça ajuda à comunidade.

Chamar uma URL de webhook

Seu serviço externo (Make.com, Zapier e outros) fornece uma URL de webhook.

Basta colar essa URL no bloco de Webhook e clicar em "Testar a requisição". Por padrão, o serviço externo recebe uma amostra do que o bot poderia enviar.

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

Tempo limite

Por padrão, o bloco de Webhook aguarda 10 segundos pela resposta do serviço externo. Se ele não responder a tempo, o bloco falha. Esse tempo limite pode ser ajustado na seção "Parâmetros avançados" das configurações do bloco.

Solução de problemas

A requisição do bloco de Webhook falhou ou parece não ter sido disparada? Confira os registros. Se ainda assim não descobrir o que houve, me mande uma mensagem pelo botão de chat dentro da própria ferramenta 👍

Ferramentas como o Webhook Tester ajudam a inspecionar o conteúdo dos webhooks durante a depuração.