Eventos de webhook

Um novo deal foi criado.

Disparado em qualquer criação de deal — via UI, API ou automação. Para detalhes do deal, faça GET em `/deals/{dealId}`.

{
  "dealId": "ad8e3f9b-3b5d-4d6e-9d8c-c0d3f1a2b3c4"
}

Um deal foi atualizado (qualquer campo).

Disparado em PATCH de deal. **Não dispara** em mudanças de stage — pra essas, use `deal.stage_changed`.

{
  "dealId": "ad8e3f9b-..."
}

O stage de um deal mudou.

Granular de `deal.updated` quando o que mudou foi o stage. Útil pra automações de notificação. Não dispara em ganhos/perdas — esses têm eventos próprios.

{
  "dealId": "ad8e3f9b-..."
}

Um deal foi marcado como ganho.

Disparado quando o stage muda pra um stage do tipo `won`. Boa âncora pra integrações de onboarding (criar conta no produto, enviar contrato, etc.).

{
  "dealId": "ad8e3f9b-..."
}

Um deal foi marcado como perdido.

Disparado quando o stage muda pra um stage do tipo `lost`. Útil pra dashboards de churn.

{
  "dealId": "ad8e3f9b-..."
}

Uma nova pessoa foi cadastrada.

Disparado em qualquer criação — UI, API, formulário de landing page, importação. Para detalhes, faça GET em `/people/{personId}`.

{
  "personId": "1f0c87e8-..."
}

Uma pessoa foi atualizada.

Disparado em PATCH de pessoa. **Não dispara** em mudanças de tag — use `person.tag_added`.

{
  "personId": "1f0c87e8-..."
}

Uma tag foi adicionada a uma pessoa.

Granular de `person.updated`. Bom pra disparar segmentações em ferramentas de marketing.

{
  "personId": "1f0c87e8-...",
  "tag": "ICP-A"
}

Uma nova empresa foi cadastrada.

Disparado em qualquer criação. Para detalhes, faça GET em `/companies/{companyId}`.

{
  "companyId": "5a2c3d4e-..."
}

Uma empresa foi atualizada.

Disparado em PATCH de empresa.

{
  "companyId": "5a2c3d4e-..."
}

Uma nova atividade foi criada.

Disparado em criação de task, call, email ou meeting. Para detalhes, faça GET em `/activities/{activityId}`.

{
  "activityId": "8f3d4c5e-..."
}

Uma atividade foi marcada como concluída.

Disparado quando `completedAt` deixa de ser null. Bom pra recompensar squads ('closer fez X calls esta semana').

{
  "activityId": "8f3d4c5e-..."
}

Uma atividade passou da data de vencimento.

Disparado pelo scheduler interno quando `dueDate < now()` e `completedAt is null`. Latência típica: até 5 minutos.

{
  "activityId": "8f3d4c5e-..."
}

Uma nova mensagem chegou em uma conversa.

Mensagens de WhatsApp, e-mail ou chat web. Use pra integrações de helpdesk ou alertas em Slack.

{
  "conversationId": "9e1f2a3b-...",
  "messageId": "7c8d9e0f-..."
}

Uma conversa foi atribuída a um usuário.

Disparado em atribuição manual ou via regra de roteamento (round-robin, skill-based).

{
  "conversationId": "9e1f2a3b-...",
  "assignedToUserId": "..."
}

Um e-mail entrou na caixa do usuário (sync IMAP/Gmail/Outlook).

Disparado quando o sync detecta um e-mail novo nos accounts conectados.

{
  "messageId": "...",
  "threadId": "..."
}

Uma tag foi adicionada a qualquer objeto (person, company ou deal).

Genérico — abrange tags em pessoas, empresas e deals. Pra granularidade em pessoas, prefira `person.tag_added`.

{
  "objectType": "deal",
  "objectId": "ad8e3f9b-...",
  "tag": "expansão"
}

Uma nota foi criada em qualquer objeto.

Inclui o objeto pai. Para conteúdo, faça GET em `/notes/{noteId}`.

{
  "noteId": "..."
}

Um formulário de landing page foi submetido.

Disparado quando uma landing page hospedada no MIX recebe um submit. Já cria a pessoa automaticamente.

{
  "landingPageId": "...",
  "personId": "1f0c87e8-..."
}