PEPINO ZAPdocs
Referência da APIDepartamentos

Transfere a conversa para um departamento

Ver como Markdown
POST
/v1/inbox/conversations/{id}/department

Move a conversa para o departamento informado e SOLTA o atendente atual (a conversa volta para a fila do novo departamento, sem dono). Envie departmentId: null para mandar para a fila geral (sem departamento, visivel a todos). O departamento precisa pertencer ao Projeto. Responde 204.

Authorization

bearerAuth
AuthorizationBearer <token>

API key enviada como Authorization Bearer pzk_live_... ou pzk_test_...

In: header

Path Parameters

id*string

Identificador da conversa.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

departmentId?string

Id do departamento de destino. null = fila geral (sem departamento).

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/inbox/conversations/string/department" \  -H "Content-Type: application/json" \  -d '{    "departmentId": "dep_01HXYZ"  }'
Empty
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Body invalido"
  }
}
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "API key ausente ou invalida"
  }
}
{
  "error": {
    "code": "FORBIDDEN",
    "message": "Projeto inativo ou sem permissao"
  }
}
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Instancia nao encontrada"
  }
}