Pular para o conteúdo

POST /v1/conversations/open-by-contacts

POST
/v1/conversations/open-by-contacts
curl --request POST \
--url https://seu-endereco-da-api/v1/conversations/open-by-contacts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "contactIds": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ] }'

Permissão que a Chave de acesso precisa: Ler conversas (conversations:read).

Media typeapplication/json
object
contactIds
required
Array<string>
>= 1 items

Example generated

{
"contactIds": [
"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
]
}
Media typeapplication/json
object
items
required
Array<object>
object
contactId
required
string
visible
required

Falso quando a conversa existe num setor que a pessoa nao acompanha: so o canal e devolvido

boolean
conversationId
required
string
nullable
channelId
required

Canal que a conversa ocupa; nulo quando a conta junta as conversas de todos os canais

string
nullable
departmentId
required
string
nullable
departmentName
required
string
nullable
assigneeId
required
string
nullable
assigneeName
required
string
nullable
openedAt
required

Quando o atendimento atual foi aberto

string format: date-time
nullable

Example generated

{
"items": [
{
"contactId": "example",
"visible": true,
"conversationId": "example",
"channelId": "example",
"departmentId": "example",
"departmentName": "example",
"assigneeId": "example",
"assigneeName": "example",
"openedAt": "2026-04-15T12:00:00Z"
}
]
}