Skip to main content

​
Visão Geral

O webhook de Mudança de Etapa é enviado pela Morada.ai para o endpoint configurado pelo parceiro sempre que um deal avança ou retrocede no funil de vendas.
Este webhook é enviado para uma URL configurada pelo parceiro. Você deve implementar um endpoint POST para recebê-lo.

​
Payload

{
  "event": "deal_stage_changed",
  "dealId": "string",
  "previousStage": "string",
  "currentStage": "string",
  "timestamp": "string",
  "metadata": {
    "partnerId": "string",
    "changedBy": "system | user",
    "userId": "string | null"
  }
}

​
Campos

CampoTipoDescrição
eventstringTipo do evento — sempre deal_stage_changed
dealIdstringID do deal que mudou de etapa
previousStagestringEtapa anterior do deal
currentStagestringNova etapa do deal
timestampstringData/hora da mudança (ISO 8601)
metadata.partnerIdstringID do parceiro
metadata.changedBystringQuem realizou a mudança: system (automático) ou user (manual)
metadata.userIdstring | nullID do usuário que fez a mudança (null se automática)

​
Resposta Esperada

Retorne um status HTTP 200 para confirmar o recebimento: 
{
  "received": true
}
Se o endpoint retornar um status diferente de 2xx, a Morada.ai tentará reenviar o webhook até 3 vezes com intervalo exponencial.