For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/guides/webhooks-in-practice.md.
  • Português
  • Webhook de entrada e de saída: quando uso cada um?

    Webhook é uma notificação automática entre sistemas: quando algo acontece, um avisa o outro na hora. A única coisa que você precisa acertar é a direção.

    Antes de começar

    • Papel: Proprietário, Administrador ou Editor.
    • Do outro lado precisa existir um sistema capaz de enviar ou receber essas chamadas.

    A direção decide tudo

    TipoQuem avisa quemUse quando
    EntradaSistema externo → ClickmaxUma plataforma de checkout externa precisa registrar vendas aqui
    SaídaClickmax → sistema externoSua ferramenta precisa saber que algo aconteceu aqui

    Regra prática: entrada traz dados para cá, saída leva dados para fora.

    Webhook de entrada

    Você cria o webhook, informa o token da plataforma que vai enviar e usa o endereço gerado lá do outro lado. É o mecanismo por trás de centralizar vendas externas.

    O passo a passo está em como configuro um webhook de entrada.

    Webhook de saída

    Você informa a URL do sistema externo e escolhe quais eventos disparam o envio. É o que permite conectar Zapier, Make ou n8n e liberar acesso em área de membros externa.

    O passo a passo está em como configuro um webhook de saída.

    Escolha os eventos com critério

    Só assine os eventos de que você precisa. Assinar tudo enche o destino de chamadas irrelevantes e dificulta encontrar a que importa quando algo falha.

    Os eventos disponíveis e o formato dos dados estão em referência de webhooks e referência de eventos.

    Teste antes de depender

    Dispare um evento real e confirme a chegada do outro lado. Webhook falha silenciosamente: nada na tela indica que a integração parou.

    Planeje a falha

    Sistemas ficam fora do ar. Defina como você percebe que as chamadas pararam e o que fazer manualmente enquanto isso — especialmente se o webhook libera acesso de cliente pagante.

    Relacionados

    Se não funcionou

    • O destino não recebeu: confira a URL e o formato em referência de webhooks.
    • A chamada retorna erro: veja códigos de erro.
    • Chega mas nada acontece: o formato provavelmente não é o esperado pelo sistema do outro lado.