# Criar Conversa para Lead

> Cria uma nova conversa vinculada a um lead existente, com suporte à definição de setor de atendimento.

`POST https://crm.wavups.com/api/v1/lead/{id}/conversation`

Página: https://crm.wavups.com/docs/api/leads/criar-conversa

## Requisição

`POST https://crm.wavups.com/api/v1/lead/{id}/conversation`

- `Token` (string, obrigatório, header):
  Seu token de autenticação.

### Path Parameters

- `id` (string, obrigatório, path):
  ID do lead que será vinculado à conversa.

### Body

- `accountChatSectorId` (string, body):
  ID do setor do chat ao qual a conversa deve ser atribuída (consulte [Listar Setores](https://crm.wavups.com/docs/api/setores/listar)). Se informado, a conversa é criada diretamente vinculada a esse setor.

- `accountIntegrationId` (string, body):
  ID da integração da conta (consulte [Listar Integrações](https://crm.wavups.com/docs/api/integracoes/listar)). Se não informado, utiliza a integração do setor ou a integração ativa padrão da conta.

- `contactName` (string, body):
  Nome do contato na conversa (padrão: nome do lead).

- `contactPhone` (string, body):
  Telefone do contato na conversa (padrão: telefone do lead).

- `contactUsername` (string, body):
  Username ou identificador social do contato.

- `conversationOwnerId` (string, body):
  ID do membro da conta responsável pela conversa.

- `status` (string, body):
  Status inicial da conversa (padrão: `active`).

---

## Resposta

Retorna o objeto da conversa criada (status HTTP 201).

- `id` (string):
  Identificador único da conversa criada.

- `leadId` (string):
  ID do lead associado à conversa.

- `accountChatSectorId` (string | null):
  ID do setor atribuído à conversa.

- `contactName` (string):
  Nome do contato.

- `contactPhone` (string | null):
  Telefone do contato.

- `status` (string):
  Status da conversa.

- `createdAt` (string):
  Data e hora de criação (ISO 8601).

---

## Exemplos

### Exemplo de requisição

```bash Criar Conversa com Setor
curl --request POST \
  --url 'https://crm.wavups.com/api/v1/lead/clead12345/conversation' \
  --header 'Token: SEU_TOKEN_DE_API' \
  --header 'Content-Type: application/json' \
  --data '{
  "accountChatSectorId": "csector001",
  "contactName": "Maria Silva",
  "contactPhone": "+5511999990000"
  }'
```

```javascript Node.js
const res = await fetch('https://crm.wavups.com/api/v1/lead/clead12345/conversation', {
  method: 'POST',
  headers: {
  'Token': 'SEU_TOKEN_DE_API',
  'Content-Type': 'application/json'
  },
  body: JSON.stringify({
  accountChatSectorId: 'csector001',
  contactName: 'Maria Silva'
  })
});
const data = await res.json();
console.log(data);
```

```python Python
import requests

response = requests.post(
  'https://crm.wavups.com/api/v1/lead/clead12345/conversation',
  headers={
  'Token': 'SEU_TOKEN_DE_API',
  'Content-Type': 'application/json'
  },
  json={
  'accountChatSectorId': 'csector001',
  'contactName': 'Maria Silva'
  }
)
print(response.json())
```

### Exemplo de resposta

```json 201
{
  "id": "clconv98765",
  "leadId": "clead12345",
  "accountChatSectorId": "csector001",
  "contactName": "Maria Silva",
  "contactPhone": "+5511999990000",
  "contactUsername": null,
  "conversationOwnerId": null,
  "status": "active",
  "unreadCount": 0,
  "createdAt": "2026-02-20T10:00:00.000Z",
  "AccountChatSector": {
  "id": "csector001",
  "name": "Comercial",
  "color": "#3B82F6"
  },
  "PlatformIntegration": {
  "id": "cplat001",
  "name": "WhatsApp"
  }
}
```

```json 404
{
  "error": "Lead not found"
}
```