curl --request GET \
--url 'https://crm.wavups.com/api/v1/account-external-conversation?accountChatSectorId=csector001' \
--header 'Token: SEU_TOKEN_DE_API'
[
{
"id": "clxyz123",
"leadId": "clead456",
"accountChatSectorId": "csector001",
"contactName": "Maria Silva",
"contactPhone": "+5511999990000",
"contactUsername": null,
"lastMessage": { "type": "text", "text": "Olá, tudo bem?" },
"lastMessageAt": "2025-10-01T14:30:00.000Z",
"unreadCount": 2,
"status": "active",
"state": "NEW",
"createdAt": "2025-09-15T10:00:00.000Z",
"AccountCRMLead": {
"id": "clead456",
"leadOwner": "cuser789",
"LeadOwner": {
"User": {
"name": "João Souza"
}
}
},
"PlatformIntegration": {
"name": "WhatsApp"
},
"accountLabelAssignments": [
{
"AccountLabel": {
"id": "clabel001",
"name": "Urgente",
"color": "#FF0000"
}
}
]
}
]
{
"error": "Error to get external conversations"
}
Conversas
Listar Conversas
Retorna a lista de conversas externas da conta autenticada, com suporte a filtros por setor e responsável.
GET
/
account-external-conversation
curl --request GET \
--url 'https://crm.wavups.com/api/v1/account-external-conversation?accountChatSectorId=csector001' \
--header 'Token: SEU_TOKEN_DE_API'
[
{
"id": "clxyz123",
"leadId": "clead456",
"accountChatSectorId": "csector001",
"contactName": "Maria Silva",
"contactPhone": "+5511999990000",
"contactUsername": null,
"lastMessage": { "type": "text", "text": "Olá, tudo bem?" },
"lastMessageAt": "2025-10-01T14:30:00.000Z",
"unreadCount": 2,
"status": "active",
"state": "NEW",
"createdAt": "2025-09-15T10:00:00.000Z",
"AccountCRMLead": {
"id": "clead456",
"leadOwner": "cuser789",
"LeadOwner": {
"User": {
"name": "João Souza"
}
}
},
"PlatformIntegration": {
"name": "WhatsApp"
},
"accountLabelAssignments": [
{
"AccountLabel": {
"id": "clabel001",
"name": "Urgente",
"color": "#FF0000"
}
}
]
}
]
{
"error": "Error to get external conversations"
}
Requisição
GET https://crm.wavups.com/api/v1/account-external-conversation
string
required
Seu token de autenticação.
Query Parameters
string
Filtra conversas pertencentes a um setor específico. Informe o ID do setor.
string
Filtra conversas pelo ID do usuário responsável pelo Lead da conversa. Também aceita
conversationOwnerId.Resposta
Retorna um array de objetos de conversa, ordenados do mais recente para o mais antigo. Os campos internosaccountId, externalId, externalContactId, platformIntegrationId e updatedAt são omitidos.
string
Identificador único da conversa.
string | null
ID do lead vinculado à conversa.
string | null
ID do setor de chat ao qual a conversa pertence.
string
Nome do contato da conversa.
string | null
Telefone do contato.
string | null
Username do contato (ex: handle do Instagram ou nome de usuário do WhatsApp).
object | null
Objeto JSON com os dados da última mensagem da conversa.
string | null
Data e hora da última mensagem (ISO 8601).
number
Quantidade de mensagens não lidas. Padrão:
0.string
Status da conversa. Padrão:
active.string | null
Estado atual do atendimento da conversa. Padrão:
NEW. Valores possíveis:NEW: conversa recém-criada, ainda não iniciada.AI_ANSWERING: a IA está respondendo automaticamente ao contato.NEEDS_HUMAN: a conversa precisa de atendimento humano.NO_RESPONSE: o contato não respondeu.COMPLETED: o atendimento foi concluído.ARCHIVED: a conversa foi arquivada.
string
Data de criação da conversa (ISO 8601).
object | null
Objeto do Lead vinculado à conversa contendo os dados do responsável (
leadOwner).object
Dados da integração de plataforma associada à conversa.
Show Propriedades da integração
Show Propriedades da integração
string
Nome da plataforma de integração (ex:
WhatsApp, Instagram).array
curl --request GET \
--url 'https://crm.wavups.com/api/v1/account-external-conversation?accountChatSectorId=csector001' \
--header 'Token: SEU_TOKEN_DE_API'
[
{
"id": "clxyz123",
"leadId": "clead456",
"accountChatSectorId": "csector001",
"contactName": "Maria Silva",
"contactPhone": "+5511999990000",
"contactUsername": null,
"lastMessage": { "type": "text", "text": "Olá, tudo bem?" },
"lastMessageAt": "2025-10-01T14:30:00.000Z",
"unreadCount": 2,
"status": "active",
"state": "NEW",
"createdAt": "2025-09-15T10:00:00.000Z",
"AccountCRMLead": {
"id": "clead456",
"leadOwner": "cuser789",
"LeadOwner": {
"User": {
"name": "João Souza"
}
}
},
"PlatformIntegration": {
"name": "WhatsApp"
},
"accountLabelAssignments": [
{
"AccountLabel": {
"id": "clabel001",
"name": "Urgente",
"color": "#FF0000"
}
}
]
}
]
{
"error": "Error to get external conversations"
}
Authorizations
Token de autenticacao gerado na plataforma WavUps CRM.
Query Parameters
Filtra conversas pertencentes a um setor específico.
Filtra conversas pelo ID do responsável.
Response
Lista de conversas retornada com sucesso.