Agentes e Times

Agentes são os usuários que atendem na conta. Times agrupam agentes para roteamento e organização (ex.: "Comercial", "Suporte").

Base e autenticação

As rotas desta página são relativas a /api/v1/accounts/{account_id} na base https://appchat01.interleads.chat e exigem o cabeçalho api_access_token.

Agentes

Endpoints

Método	Rota	Descrição
GET	/agents	Lista os agentes da conta
POST	/agents	Adiciona um agente à conta
PATCH	/agents/{id}	Atualiza um agente
DELETE	/agents/{id}	Remove um agente da conta

Listar agentes

curl "https://appchat01.interleads.chat/api/v1/accounts/3/agents" \
  -H "api_access_token: $INTERLEADS_TOKEN"

Adicionar um agente

Campos: name, email e role (agent ou administrator) são obrigatórios. Opcionais: availability (online / busy / offline), auto_offline.

curl -X POST "https://appchat01.interleads.chat/api/v1/accounts/3/agents" \
  -H "api_access_token: $INTERLEADS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Maria", "email": "maria@empresa.com", "role": "agent" }'

Adicionar ≠ criar do zero

Este endpoint adiciona à conta um usuário que já existe na plataforma. A criação de um usuário totalmente novo (com senha) é uma operação administrativa da plataforma — fale com o suporte se precisar provisionar usuários em massa.

Times

Endpoints

Método	Rota	Descrição
GET	/teams	Lista os times
POST	/teams	Cria um time
GET	/teams/{id}	Detalhes de um time
PATCH	/teams/{id}	Atualiza um time
DELETE	/teams/{id}	Exclui um time
GET	/teams/{id}/team_members	Lista os agentes do time
POST	/teams/{id}/team_members	Adiciona agentes ao time
PATCH	/teams/{id}/team_members	Redefine os agentes do time
DELETE	/teams/{id}/team_members	Remove agentes do time

Criar um time

Campos: name, description, allow_auto_assign.

curl -X POST "https://appchat01.interleads.chat/api/v1/accounts/3/teams" \
  -H "api_access_token: $INTERLEADS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Comercial", "allow_auto_assign": true }'

Gerenciar membros

curl -X POST "https://appchat01.interleads.chat/api/v1/accounts/3/teams/9/team_members" \
  -H "api_access_token: $INTERLEADS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "user_ids": [7, 11] }'

Erros comuns

Código	Significado
401	Token ausente ou inválido
403	Sem permissão (ex.: token de agente tentando ação de administrador)
404	Agente ou time não encontrado
422	Dados inválidos (ex.: e-mail já é agente, role inválido)