POST /v1/conversations/open-by-contacts
POST
/v1/conversations/open-by-contacts
const url = 'https://seu-endereco-da-api/v1/conversations/open-by-contacts';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"contactIds":["2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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).
Authorizations
Seção intitulada “Authorizations”Request Bodyrequired
Seção intitulada “Request Bodyrequired”Media typeapplication/json
object
contactIds
required
Array<string>
Example generated
{ "contactIds": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ]}Responses
Seção intitulada “Responses”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
channelId
required
Canal que a conversa ocupa; nulo quando a conta junta as conversas de todos os canais
string
departmentId
required
string
departmentName
required
string
assigneeId
required
string
assigneeName
required
string
openedAt
required
Quando o atendimento atual foi aberto
string format: date-time
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" } ]}