Skip to main content
GET
/
account-external-conversation
curl --request GET \
  --url 'https://sell.ia.proativia.com/api/v1/account-external-conversation?accountChatSectorId=csector001' \
  --header 'Token: SEU_TOKEN_DE_API'

[
  {
    "id": "clxyz123",
    "leadId": "clead456",
    "conversationOwnerId": "cuser789",
    "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",
    "createdAt": "2025-09-15T10:00:00.000Z",
    "ConversationOwner": {
      "User": {
        "name": "João Souza"
      }
    },
    "PlatformIntegration": {
      "name": "WhatsApp"
    },
    "accountLabelAssignments": [
      {
        "AccountLabel": {
          "id": "clabel001",
          "name": "Urgente",
          "color": "#FF0000"
        }
      }
    ]
  }
]

​
Requisição

GET https://sell.ia.proativia.com/api/v1/account-external-conversation
​
Token
string
required
Seu token de autenticação.

​
Query Parameters

​
accountChatSectorId
string
Filtra conversas pertencentes a um setor específico. Informe o ID do setor.
​
conversationOwnerId
string
Filtra conversas pelo ID do usuário responsável pela conversa.

​
Resposta

Retorna um array de objetos de conversa, ordenados do mais recente para o mais antigo. Os campos internos accountId, externalId, externalContactId, platformIntegrationId e updatedAt são omitidos.
​
id
string
Identificador único da conversa.
​
leadId
string | null
ID do lead vinculado à conversa.
​
conversationOwnerId
string | null
ID do usuário responsável pela conversa.
​
accountChatSectorId
string | null
ID do setor de chat ao qual a conversa pertence.
​
contactName
string
Nome do contato da conversa.
​
contactPhone
string | null
Telefone do contato.
​
contactUsername
string | null
Username do contato (ex: handle do Instagram).
​
lastMessage
object | null
Objeto JSON com os dados da última mensagem da conversa.
​
lastMessageAt
string | null
Data e hora da última mensagem (ISO 8601).
​
unreadCount
number
Quantidade de mensagens não lidas. Padrão: 0.
​
status
string
Status da conversa. Padrão: active.
​
createdAt
string
Data de criação da conversa (ISO 8601).
​
ConversationOwner
object | null
Dados do usuário responsável pela conversa.
​
PlatformIntegration
object
Dados da integração de plataforma associada à conversa.
​
accountLabelAssignments
array
Lista de etiquetas atribuídas à conversa.
curl --request GET \
  --url 'https://sell.ia.proativia.com/api/v1/account-external-conversation?accountChatSectorId=csector001' \
  --header 'Token: SEU_TOKEN_DE_API'

[
  {
    "id": "clxyz123",
    "leadId": "clead456",
    "conversationOwnerId": "cuser789",
    "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",
    "createdAt": "2025-09-15T10:00:00.000Z",
    "ConversationOwner": {
      "User": {
        "name": "João Souza"
      }
    },
    "PlatformIntegration": {
      "name": "WhatsApp"
    },
    "accountLabelAssignments": [
      {
        "AccountLabel": {
          "id": "clabel001",
          "name": "Urgente",
          "color": "#FF0000"
        }
      }
    ]
  }
]

Authorizations

​
Token
string
header
required

Token de autenticacao gerado na plataforma Sell.IA.

Query Parameters

​
accountChatSectorId
string

Filtra conversas pertencentes a um setor específico.

​
conversationOwnerId
string

Filtra conversas pelo ID do responsável.

Response

Lista de conversas retornada com sucesso.

​
id
string
​
contactName
string | null
​
contactPhone
string | null
​
accountChatSectorId
string | null
​
conversationOwnerId
string | null
​
status
string
​
createdAt
string<date-time>