GG.chatbot
FluxoBlocosLógica

Webhook

O bloco Webhook é frequentemente confundido com o bloco de requisição HTTP.

  • Use o bloco Webhook quando quiser que o GG.chatbot pause e aguarde até que um serviço externo chame o GG.chatbot de volta.
  • Use o bloco de requisição HTTP quando quiser que o GG.chatbot chame uma API imediatamente, dispare um cenário no N8N e afins, e receba a resposta na hora.

O bloco Webhook pausa a conversa até que a URL de webhook informada seja chamada.

É útil quando você precisa executar uma ação demorada, que pode levar vários minutos.

URLs

Teste

  • Web:
https://ggchatbot.com/api/v1/typebots/{typebotId}/blocks/{blockId}/web/executeTestWebhook
  • WhatsApp:
https://ggchatbot.com/api/v1/typebots/{typebotId}/blocks/{blockId}/whatsapp/{phone}/executeTestWebhook

Onde {phone} é o número em que você testa o bot. Por exemplo, se você informou +55 11 91234-5678, o {phone} deve ser 5511912345678, sem espaços e sem o +.

Produção

Independentemente do ambiente, a URL do webhook é sempre a mesma:

https://ggchatbot.com/api/v1/typebots/{typebotId}/blocks/{blockId}/results/{resultId}/executeWebhook

Onde {resultId} é o ID do resultado do usuário atual. Você obtém esse ID dentro do próprio fluxo, com um bloco Variável usando o valor ID do resultado.

Autenticação

A URL do webhook precisa ser autenticada para funcionar. Veja Autenticação da API para mais detalhes.

On this page