Oportunidade - Atualização

Evento

POST crm/lead/lead/patch

Como receber

Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload.

Payload

Content-Type: application/json

Campo	Tipo	Obrigatório	Descrição
contacts	string	Não
automations	string	Não
companies	string	Não
phones	object	Não
emails	object	Não
socials	object	Não
name	string	Não	Nome descritivo
user	string	Não
createdBy	string	Não
import	string	Não	Id da importação, caso tenha sido importado
note	string	Não	Observação associada ao lead
stage	string	Sim	Estágio atual do lead no funil
funnel	string	Sim	Funil atual do lead
source	string	Não	Id de origem do lead
archiveReason	string	Não	Motivo do arquivamento
ticket	number	Não	Ticket/valor estimado desse lead
score	number	Não	Score / Temperatura
tags	string	Não
_	object	Não
fidx1	string	Não
fidx2	string	Não
fidx3	string	Não
dtStage	string (date-time)	Não	Data da última atualização de KPIs (Uso interno)
dueDt	string (date-time)	Não	Data de previsão de fechamento do lead
tlFinishedTasks	number	Não
tlTimeline	number	Não
pendTasks	object	Não
tlPendTasks	number	Não	Total de tarefas pendentes relacionadas ao lead
dtPendTask	string (date-time)	Não	Data da tarefa pendente mais próxima
createdAt	string (date-time)	Não
system_source	string	Não	Canal/sistema que criou o lead no CRM. Exemplos: whatsapp, calendly, webhook, facebook_lead_ads, crm_automation. Não confundir com utm.provider, que representa a origem de marketing.
utm	object	Não
utmClick	object	Não
transmissionList	string	Não
ip_source	string	Não	IP de origem do lead quando conhecido. Útil para matching técnico e integrações de conversão; não é um campo analítico principal.
updatedAt	string (date-time)	Não

Estruturas internas

phones

[
  {
    "phone": "string",
    "itemType": "number"
  }
]

emails

[
  {
    "email": "string",
    "itemType": "number"
  }
]

socials

[
  {
    "link": "string",
    "itemType": "number"
  }
]

pendTasks

[
  {
    "dt": "string (date-time)"
  }
]

utm

{
  "provider": "string",
  "source": "string",
  "medium": "string",
  "clickId": "string",
  "campaignId": "string",
  "campaign": "string",
  "groupId": "string",
  "group": "string",
  "creativeId": "string",
  "creative": "string",
  "content": "string",
  "term": "string",
  "url": "string",
  "ref": "string"
}

utmClick

{
  "fbclid": "string",
  "ctwaClid": "string",
  "gclid": "string",
  "gbraid": "string",
  "wbraid": "string",
  "ttclid": "string"
}

Exemplo básico recebido:

{
  "stage": "SUBSTITUA_PELO_ID_DA_ETAPA",
  "funnel": "SUBSTITUA_PELO_ID_DO_FUNIL",
  "name": "Lead de teste",
  "emails": [
    {
      "email": "lead.teste@exemplo.com"
    }
  ],
  "phones": [
    {
      "phone": "+5511999999999"
    }
  ]
}

Respostas

Status	Descrição	Conteúdo
200	Return a 200 status to indicate that the data was received successfully

Boas práticas

Trate reenvios como possibilidade real.
Valide o payload antes de executar regras de negócio.
Registre o identificador do evento ou do registro recebido para auditoria.