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/features/integrations/outgoing-webhooks.md.
  • Português
  • Integrações de saída (webhooks)

    Enquanto as integrações de checkout trazem dados de fora para a Clickmax, uma integração de saída faz o contrário: quando algo acontece na sua conta (uma venda, um contato criado, uma tag aplicada), a Clickmax envia esse evento para a URL que você escolher — Zapier, Make, n8n, Slack, um sistema próprio, etc.

    Papel de workspace: Proprietário, Administrador, Editor ou Colaborador.

    Vários gatilhos na mesma integração

    Uma integração pode escutar quantos eventos você quiser. Ao criar ou editar, o campo de gatilhos aceita seleção múltipla, e todos os eventos selecionados são enviados para a mesma URL, com o mesmo token e as mesmas credenciais.

    Isso substitui o comportamento antigo, em que cada integração escutava um único evento — para reagir a cinco eventos era preciso criar cinco integrações, cada uma com seu próprio histórico e token.

    Selecione pelo menos um gatilho. Uma integração sem gatilho fica ativa mas nunca dispara.

    Gatilhos disponíveis por plataforma

    A maioria das plataformas (Zapier, Make, n8n, Slack, Notion, RD Station…) aceita todos os eventos, porque apenas repassa o conteúdo recebido.

    Algumas plataformas têm uma tradução própria e por isso aceitam só os eventos que sabem interpretar:

    PlataformaGatilhos aceitos
    ActiveCampaignContato criado, Contato captado, Tag aplicada, Tag removida
    UTMify, Notazz, Nota do Infoprodutor, Somos BiuCompra realizada, Compra cancelada, Reembolso efetuado, Chargeback solicitado

    Se você selecionar um evento que a plataforma não aceita, a Clickmax avisa na hora em vez de salvar uma configuração que nunca entregaria nada.

    O que o ActiveCampaign exige em cada grupo de evento

    Os dois grupos de evento do ActiveCampaign vão para lugares diferentes na sua conta, e cada um pede uma configuração própria. Uma integração pode escutar os dois ao mesmo tempo — e aí precisa das duas.

    Se você selecionarPrecisa informar
    Contato criado, Contato captadoa lista de contatos e o funil
    Tag aplicada, Tag removidaa tag

    Faltando qualquer um desses, a Clickmax não deixa salvar. É proteção: sem eles a integração ficaria ativa sem nunca entregar nada, e sem erro visível para você.

    Uma integração só de tags não pede lista — a lista só é usada quando o evento cria ou capta um contato.

    Contatos sem e-mail não vão para o ActiveCampaign

    O ActiveCampaign identifica cada contato pelo e-mail. Contatos que existem na Clickmax só com telefone ou Instagram não são enviados — nem nos eventos de contato, nem nos de tag. Não é erro: a entrega é simplesmente descartada, sem aparecer no Histórico.

    Ver e editar uma integração

    No card da integração, clique no ícone de edição para abrir a página de detalhe. Ela tem duas abas:

    • Configuração — nome, URL de destino, gatilhos, credenciais e ativar/desativar.
    • Histórico — todas as entregas já feitas.

    Alterações valem para os próximos eventos; entregas já registradas não mudam.

    Credenciais

    Por segurança, a Clickmax nunca exibe de volta as credenciais salvas (chaves de API, tokens). Na tela de edição os campos de credencial aparecem vazios, indicando apenas quais já estão configuradas.

    • Deixe em branco para manter a credencial atual.
    • Digite um valor novo para substituir.

    Histórico de entregas

    A aba Histórico lista cada envio com o gatilho que o originou, a data e o status. A coluna de gatilho é o que permite distinguir as entregas quando a integração escuta vários eventos.

    Clicando na lupa de uma entrega você vê:

    • o request que a Clickmax enviou (corpo e cabeçalhos);
    • a resposta da plataforma de destino, por tentativa — incluindo o código e a mensagem de erro quando a entrega falhou.

    Isso é o que permite descobrir por que uma entrega falhou, em vez de só ver que ela falhou.

    Reenviar uma entrega

    Cada linha do histórico tem a ação Reenviar. Use quando a falha foi do lado da outra plataforma (instabilidade, credencial expirada, URL temporariamente fora do ar) e você já corrigiu o problema.

    O reenvio manda exatamente o mesmo conteúdo já registrado — nada é recalculado. Cada reenvio entra no histórico como uma tentativa nova, então o rastro fica completo.

    O botão responde imediatamente e a entrega acontece em seguida, de forma assíncrona: a linha passa para "processando" e o resultado aparece quando a plataforma responde.

    Quando uma integração é desativada sozinha

    Depois de 15 tentativas seguidas com falha, a Clickmax desativa a integração para parar de insistir num destino que não responde. Isso vale para a integração inteira, não por gatilho, porque a URL e as credenciais são compartilhadas por todos os eventos dela.

    Corrija o destino, reative a integração na aba Configuração e, se quiser recuperar o que ficou para trás, use Reenviar nas entregas que falharam.

    Relacionados