Requisições web e webhooks

GetMyBot se integra com sistemas externos via HTTP nos dois sentidos: requisições de entrada acionam reações, enquanto ações de saída chamam APIs externas. Isso conecta o bot a CRMs, sistemas de pagamento, formulários de sites e quaisquer serviços.

Webhook de entrada (gatilho)

O gatilho "Requisição web de entrada (webhook)" inicia uma reação por requisição HTTP externa:

  • Caminho — endereço do receptor (a URL completa é formada a partir do endereço do bot e do caminho).
  • Token secreto — protege o endpoint de terceiros.
  • Método — POST / GET / PUT / ANY.

Os dados da requisição (campos de formulário ou corpo) entram no contexto de execução e ficam disponíveis nas ações via {{ctx.campo}}. Assim um site ou serviço pode "empurrar" um evento ao bot — por exemplo, pagamento efetuado → enviar acesso ao usuário.

Requisição web de saída (ação)

A ação "Requisição web" faz uma requisição HTTP a partir de uma reação:

  • método (GET/POST/PUT/DELETE), cabeçalhos, corpo (JSON ou formulário);
  • códigos de sucesso, timeout e número de tentativas em caso de erro;
  • salvamento da resposta em parâmetro ou ctx via JSONPath;
  • modo assíncrono (não bloqueia a reação) e início de reações em caso de sucesso/erro.

Ações relacionadas: "Carregar URL" (baixar texto de página em ctx) e "Consulta à fonte" / "Gravação na fonte" para conectores salvos — veja Fontes e chaves.

Integração via webhook

Para envio regular de dados a um serviço, é mais conveniente configurar a integração "Webhook" (URL + assinatura HMAC) — veja Integrações.

Segurança

Os endpoints de entrada são protegidos por token secreto; as requisições de saída passam por proteção contra SSRF (não é possível acessar a rede interna), e o tamanho da resposta é limitado.

Próximos passos