# Agilize Docs para IA - Página atual

Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize.
Use esta versão quando a pergunta do usuário estiver restrita ao documento atual.

Última geração: 2026-05-27T06:58:19.931Z

## Página

- Título: Oportunidade - Atualização
- URL humana: https://agilize.app/docs/desenvolvedores/webhooks/crm-lead/oportunidade/post-crm-lead-lead-patch
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload.

## Seções

- Evento
- Como receber
- Payload
- Respostas
- Boas práticas

## Conteúdo da página

## Evento

```http
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 | Valores / Exemplo | 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**

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

**emails**

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

**socials**

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

**pendTasks**

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

**utm**

```json
{
  "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**

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

Exemplo básico recebido:

```json
{
  "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.