Atribuições de Conversas
Atribua e remova responsáveis (agentes e equipes) de conversas.
GET
Listar Participantes
Lista todos os agentes participantes de uma conversa.
GET
https://chat.klivo.marketing/api/v1/accounts/{account_id}/conversations/{id}/participants
Parâmetros de Path
account_id
integer
obrigatório
ID da conta.
id
integer
obrigatório
ID da conversa.
CURL
curl --request GET \
--url https://chat.klivo.marketing/api/v1/accounts/{account_id}/conversations/{id}/participants \
--header 'api_access_token: '
200
{
"payload": [
{"id": 1, "name": "João Silva", "role": "agent"}
]
}
POST
Atribuir Agente
Atribui um agente como responsável pela conversa.
POST
https://chat.klivo.marketing/api/v1/accounts/{account_id}/conversations/{id}/assignments
Parâmetros de Path
account_id
integer
obrigatório
ID da conta.
id
integer
obrigatório
ID da conversa.
Body Parameters
assignee_id
integer
obrigatório
ID do agente a ser atribuído.
CURL
curl --request POST \
--url https://chat.klivo.marketing/api/v1/accounts/{account_id}/conversations/{id}/assignments \
--header 'api_access_token: ' \
--header 'Content-Type: application/json' \
--data '{
"assignee_id": 3
}'
200
{
"id": 3,
"name": "Maria Santos",
"role": "agent"
}
POST
Adicionar Labels
Adiciona labels a uma conversa.
POST
https://chat.klivo.marketing/api/v1/accounts/{account_id}/conversations/{id}/labels
Parâmetros de Path
account_id
integer
obrigatório
ID da conta.
id
integer
obrigatório
ID da conversa.
Body Parameters
labels
array
obrigatório
Array de strings com os nomes das labels.
CURL
curl --request POST \
--url https://chat.klivo.marketing/api/v1/accounts/{account_id}/conversations/{id}/labels \
--header 'api_access_token: ' \
--header 'Content-Type: application/json' \
--data '{
"labels": ["urgente", "venda"]
}'
200
{
"payload": ["urgente", "venda"]
}