#Avise outro sistema quando a oportunidade entrar numa etapa

A automação Webhook de saída faz o Clickmax enviar um POST para uma URL sua assim que uma oportunidade entra na etapa. É o caminho para avisar um CRM externo, um ERP ou uma automação própria de que o negócio avançou — sem ninguém precisar copiar dado na mão.

Antes de começar

• Papel do workspace: proprietário, administrador ou editor. Quem não tem esse papel não consegue criar nem editar automações da etapa. Veja o alcance de cada papel na tabela de permissões.
• Você precisa de um pipeline com pelo menos uma etapa. Se ainda não tem, comece por Monte seu primeiro pipeline.
• A URL de destino precisa ser HTTPS e estar acessível pela internet. Endereços internos (localhost, rede local) são recusados.

#Passos

1. Abra o pipeline e, na etapa que você quer automatizar, clique em Criar automação.
2. No passo Tipo, escolha Ação & Delay e clique em Continuar.
3. No passo Item, procure por Webhook de saída (categoria Fluxo & Integrações) e clique em Continuar.
4. No campo Esperar, deixe Imediato para o envio sair assim que a oportunidade entrar na etapa. Os outros tempos também valem — veja Defina quando a automação da etapa vai rodar.
5. Em URL, cole o endereço que vai receber o envio.
6. Confira em O que enviamos o corpo que vai chegar e clique em Salvar.

O método é sempre POST e o corpo vai em JSON (Content-Type: application/json) — por isso não existe campo de método nesta automação.

#Avise também quando um gatilho trouxer a oportunidade

Ação & Delay dispara para toda oportunidade que entra na etapa, não importa por onde. Se você quer avisar só quando um evento específico trouxer o card para cá — uma compra aprovada, uma perda, um campo que mudou —, configure o webhook dentro do próprio Gatilho de passagem:

1. Na etapa, clique em Criar automação e escolha Gatilho de passagem.
2. Escolha o evento que move a oportunidade para esta etapa e configure os filtros dele.
3. Em Webhook de saída (opcional), cole a URL que vai receber o envio.
4. Clique em Adicionar gatilho.

O envio sai depois de o card já estar na etapa nova, então o corpo em JSON é o mesmo descrito abaixo e já traz a etapa de destino. Deixar o campo vazio mantém o gatilho só movendo o card, como antes.

#O que chega no seu sistema

{
  "event": "opportunity.stage.entered",
  "occurredAt": "2026-08-13T18:25:43.511Z",
  "opportunity": {
    "id": "9f1c...",
    "title": "Plano Anual — Acme",
    "value": 1500.5,
    "valueCents": 150050,
    "isRecurring": false,
    "status": "open",
    "priority": "high",
    "temperature": "hot",
    "probability": 60,
    "expectedClosingDate": "2026-09-30",
    "origin": "Formulário do site",
    "lossReason": null,
    "createdAt": "2026-08-01T12:00:00.000Z"
  },
  "pipeline": { "id": "3a7b...", "name": "Vendas" },
  "stage": {
    "id": "6d2e...",
    "name": "Proposta enviada",
    "enteredAt": "2026-08-13T18:25:43.402Z"
  },
  "contact": {
    "id": "b04f...",
    "name": "Maria Souza",
    "email": "[email protected]",
    "phone": "5511999998888",
    "document": "12345678900"
  },
  "tags": [{ "id": "c91a...", "name": "Quente" }],
  "responsible": { "id": "77de...", "name": "João Lima", "email": "[email protected]" }
}

#O que cada campo significa

Campos sem valor preenchido chegam como null — a chave sempre existe. Oportunidade sem contato vinculado envia contact: null, e sem responsável envia responsible: null. Uma oportunidade sem tags envia uma lista vazia.

#Como o envio se comporta

• O envio é assíncrono: mover a oportunidade nunca fica esperando a resposta do seu sistema, e uma falha do destino não trava o card.
• Seu endpoint tem até 30 segundos para responder.
• Qualquer resposta serve para o Clickmax considerar a entrega feita — não é preciso devolver conteúdo, só responder.
• Redirecionamentos não são seguidos: a URL configurada precisa responder diretamente, sem repassar para outro endereço.
• Se a oportunidade for excluída antes do envio sair, nada é enviado.

#Proteja o endereço de recebimento

A URL é o único endereço que recebe esses dados, então trate-a como um segredo: use um endereço difícil de adivinhar e não a publique. Se desconfiar que ela vazou, gere uma URL nova no seu sistema e atualize a automação.

#Relacionados

• Defina quando a automação da etapa vai rodar
• Monte seu primeiro pipeline
• Central de contatos

#Se não funcionou

• Criar automação não aparece na etapa → seu papel não permite configurar o pipeline. Confira em Sem permissão e na tabela de permissões.
• Nada chega no seu sistema → confira se a URL começa com https:// e se ela responde a um POST vindo da internet. Endereços internos e http:// são recusados no envio.
• A oportunidade entrou na etapa mas o envio não saiu → automações valem para quem entra na etapa depois que elas foram salvas. Oportunidades que já estavam lá não disparam.
• Chegou sem contato ou sem tags → a oportunidade não tem contato vinculado nem tags no Clickmax. Preencha no card e mova de novo para testar.
• Aparece o aviso Erro ao salvar → a automação não foi criada. Confira se a URL está preenchida e tente de novo; se persistir, consulte os códigos de erro.