Skip to main content
POST
Transferir para equipe

Authorizations

Authorization
string
header
required

API key de conta, no formato ApiKey <token> (ex.: ApiKey zk_live_...). Criada em Configurações → API Keys por um usuário com a permissão api_keys:manage. O token é exibido uma única vez. Cada rota exige um scope; key sem o scope, ou recurso fora dos canais permitidos da key, responde 404.

Path Parameters

id
string
required

ID do chat (ObjectId).

Example:

"66f2a1c9e4b0a1b2c3d4e5f6"

Body

application/json
teamId
string
required

Equipe de destino (veja Listar equipes).

reasonCode
string

Código do motivo, registrado no evento de transferência.

Maximum string length: 100
reason
string

Motivo em texto livre.

Maximum string length: 500

Response

Conversa após a transferência.

id
string
Example:

"66f2a1c9e4b0a1b2c3d4e5f6"

status
string
Example:

"open"

queue
string

Fila atual: Espera (aguardando atendente da equipe), Em Atendimento, Automação, API ou a fila configurada no canal.

Example:

"Espera"

channelId
string | null
Example:

"66f1f0c2e4b0a1b2c3d4e001"

teamId
string | null
Example:

"66f1f0c2e4b0a1b2c3d4e100"

userId
string | null

Atendente atual; null quando ninguém está atendendo.

Example:

null

contact
object | null
unreadMessages
integer
Example:

2

lastMessage
object | null

Resumo da última mensagem (origin, content).

createdAt
string<date-time>
updatedAt
string<date-time>