curl --request POST \
--url 'https://crm.wavups.com/api/v1/account-external-conversation' \
--header 'Token: SEU_TOKEN_DE_API' \
--header 'Content-Type: application/json' \
--data '{
"leadId": "clead12345",
"accountChatSectorId": "csector001",
"contactPhone": "5511988887777",
"contactName": "Carlos Eduardo"
}'
{
"id": "clconv123",
"contactName": "Carlos Eduardo",
"contactPhone": "5511988887777",
"contactUsername": null,
"leadId": "clead12345",
"accountChatSectorId": "csector001",
"status": "active",
"state": "NEW",
"unreadCount": 0,
"createdAt": "2026-02-20T10:00:00.000Z",
"AccountChatSector": {
"id": "csector001",
"name": "Vendas",
"color": "#10B981"
},
"PlatformIntegration": {
"id": "cplat001",
"name": "WhatsApp"
}
}
Conversas
Criar Conversa
Cria uma nova conversa externa vinculada obrigatoriamente a um lead existente e atribui ao setor de atendimento desejado.
POST
/
account-external-conversation
curl --request POST \
--url 'https://crm.wavups.com/api/v1/account-external-conversation' \
--header 'Token: SEU_TOKEN_DE_API' \
--header 'Content-Type: application/json' \
--data '{
"leadId": "clead12345",
"accountChatSectorId": "csector001",
"contactPhone": "5511988887777",
"contactName": "Carlos Eduardo"
}'
{
"id": "clconv123",
"contactName": "Carlos Eduardo",
"contactPhone": "5511988887777",
"contactUsername": null,
"leadId": "clead12345",
"accountChatSectorId": "csector001",
"status": "active",
"state": "NEW",
"unreadCount": 0,
"createdAt": "2026-02-20T10:00:00.000Z",
"AccountChatSector": {
"id": "csector001",
"name": "Vendas",
"color": "#10B981"
},
"PlatformIntegration": {
"id": "cplat001",
"name": "WhatsApp"
}
}
Padrão Estrito de Telefone (DDI + DDD + Número)Os números de telefone devem ser enviados exclusivamente no formato de dígitos com DDI + DDD/Código de Área + Número (exemplo Brasil:
5547999999999, exemplo EUA: 14155552671), sem espaços, traços, parênteses ou o símbolo +.Qualquer divergência neste formato causará falhas nos disparos da API do WhatsApp e duplicação de leads no sistema.Fluxo de Criação em Duas Etapas:
Para direcionar um lead a um setor específico antes do primeiro contato:
- Primeiro registre o lead através do endpoint Criar Lead para obter o
iddo lead. - Em seguida, utilize este endpoint enviando o
leadIde oaccountChatSectorIddesejado (ex: Setor de Vendas).
Requisição
POST https://crm.wavups.com/api/v1/account-external-conversation
string
required
Seu token de autenticação.
Body
string
required
ID do Lead retornado na criação do lead (
POST /lead). Campo obrigatório.string
ID do setor do chat para atribuir a conversa (ex: Setor de Vendas, Suporte).
string
Telefone do contato no formato estrito internacional (
5547999999999). Caso não informado, o telefone cadastrado no Lead será utilizado.string
Nome do contato da conversa. Caso não informado, o nome cadastrado no Lead será utilizado.
string
Username ou identificador social do contato (ex: username do Instagram).
string
ID da integração da conta (consulte Listar Integrações). Opcional caso o setor já possua integração associada.
string
ID do membro da conta responsável pela conversa. Caso não informado, utilizará o
leadOwner do lead.string
Status da conversa (padrão:
active).string
Estado inicial do atendimento da conversa (padrão:
NEW). Valores aceitos: NEW, AI_ANSWERING, NEEDS_HUMAN, NO_RESPONSE, COMPLETED, ARCHIVED.Resposta
Retorna o objeto da conversa criada (status HTTP 201).string
Identificador único da conversa.
string
Nome do contato.
string | null
Telefone do contato formatado.
string
ID do lead associado.
string | null
ID do setor associado.
string
Status da conversa.
string
Estado atual do atendimento da conversa. Padrão:
NEW. Valores possíveis: NEW, AI_ANSWERING, NEEDS_HUMAN, NO_RESPONSE, COMPLETED, ARCHIVED.string
Data e hora de criação (ISO 8601).
Exemplos
curl --request POST \
--url 'https://crm.wavups.com/api/v1/account-external-conversation' \
--header 'Token: SEU_TOKEN_DE_API' \
--header 'Content-Type: application/json' \
--data '{
"leadId": "clead12345",
"accountChatSectorId": "csector001",
"contactPhone": "5511988887777",
"contactName": "Carlos Eduardo"
}'
{
"id": "clconv123",
"contactName": "Carlos Eduardo",
"contactPhone": "5511988887777",
"contactUsername": null,
"leadId": "clead12345",
"accountChatSectorId": "csector001",
"status": "active",
"state": "NEW",
"unreadCount": 0,
"createdAt": "2026-02-20T10:00:00.000Z",
"AccountChatSector": {
"id": "csector001",
"name": "Vendas",
"color": "#10B981"
},
"PlatformIntegration": {
"id": "cplat001",
"name": "WhatsApp"
}
}
Authorizations
Token de autenticacao gerado na plataforma WavUps CRM.
Body
application/json
Nome do contato.
Telefone do contato.
Username do contato.
ID do lead vinculado.
ID do setor vinculado.
ID da integração.
ID do responsável.
Status (padrão: active).
Estado inicial do atendimento (padrão: NEW).
Available options:
NEW, AI_ANSWERING, NEEDS_HUMAN, NO_RESPONSE, COMPLETED, ARCHIVED Response
Conversa criada com sucesso.