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"
}'
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);
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())
{
"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"
}
}
{
"error": "Lead not found"
}
Leads
Criar Conversa para Lead
Cria uma nova conversa vinculada a um lead existente, com suporte à definição de setor de atendimento.
POST
/
lead
/
{id}
/
conversation
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"
}'
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);
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())
{
"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"
}
}
{
"error": "Lead not found"
}
Requisição
POST https://crm.wavups.com/api/v1/lead/{id}/conversation
string
required
Seu token de autenticação.
Path Parameters
string
required
ID do lead que será vinculado à conversa.
Body
string
ID do setor do chat ao qual a conversa deve ser atribuída (consulte Listar Setores). Se informado, a conversa é criada diretamente vinculada a esse setor.
string
ID da integração da conta (consulte Listar Integrações). Se não informado, utiliza a integração do setor ou a integração ativa padrão da conta.
string
Nome do contato na conversa (padrão: nome do lead).
string
Telefone do contato na conversa (padrão: telefone do lead).
string
Username ou identificador social do contato.
string
ID do membro da conta responsável pela conversa.
string
Status inicial da conversa (padrão:
active).Resposta
Retorna o objeto da conversa criada (status HTTP 201).string
Identificador único da conversa criada.
string
ID do lead associado à conversa.
string | null
ID do setor atribuído à conversa.
string
Nome do contato.
string | null
Telefone do contato.
string
Status da conversa.
string
Data e hora de criação (ISO 8601).
Exemplos
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"
}'
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);
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())
{
"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"
}
}
{
"error": "Lead not found"
}
Authorizations
Token de autenticacao gerado na plataforma WavUps CRM.
Path Parameters
ID do lead que será vinculado à conversa.
Body
application/json
ID do setor do chat para atribuir a conversa.
ID da integração.
Nome do contato.
Telefone do contato.
Username do contato.
ID do responsável.
Status inicial (padrão: active).
Response
Conversa criada com sucesso.

