Caixas de Entrada (Inboxes)

Inboxes representam canais de atendimento como WhatsApp, Email, Web Chat e outros. Cada inbox pode ter agentes atribuidos e configuracoes especificas do canal.

GET/api/v1/accounts/{account_id}/inboxes

Lista todas as caixas de entrada (inboxes) da conta.

Parametros

Nome	Tipo	Obrigatorio	Descricao
`account_id`(path)	`integer`	Sim	ID numerico da conta

curl -s "https://chat.seudominio.com/api/v1/accounts/1/inboxes" \
  -H "api_access_token: YOUR_TOKEN" | jq .

200Lista de inboxes

json

{
  "payload": [
    {
      "id": 1,
      "name": "WhatsApp Suporte",
      "channel_type": "Channel::Whatsapp",
      "phone_number": "+5511999999999",
      "greeting_enabled": true,
      "greeting_message": "Ola! Como posso ajudar?"
    },
    {
      "id": 2,
      "name": "Email Suporte",
      "channel_type": "Channel::Email",
      "email": "suporte@empresa.com"
    }
  ]
}

GET/api/v1/accounts/{account_id}/inboxes/{id}

Retorna os detalhes de um inbox especifico.

Parametros

Nome	Tipo	Obrigatorio	Descricao
`account_id`(path)	`integer`	Sim	ID numerico da conta
`id`(path)	`integer`	Sim	ID do inbox

bash

curl -s "https://chat.seudominio.com/api/v1/accounts/1/inboxes/1" \
  -H "api_access_token: YOUR_TOKEN" | jq .

POST/api/v1/accounts/{account_id}/inboxes

Cria um novo inbox (canal de atendimento).

Body

Nome	Tipo	Obrigatorio	Descricao
`name`	`string`	Sim	Nome do inbox
`channel`	`object`	Sim	Configuracao do canal (varia por tipo)
`greeting_enabled`	`boolean`	Nao	Habilitar saudacao automatica
`greeting_message`	`string`	Nao	Mensagem de saudacao

curl -X POST "https://chat.seudominio.com/api/v1/accounts/1/inboxes" \
  -H "api_access_token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Widget do Site",
    "channel": {
      "type": "web_widget",
      "website_url": "https://meusite.com"
    },
    "greeting_enabled": true,
    "greeting_message": "Ola! Em que posso ajudar?"
  }'

PATCH/api/v1/accounts/{account_id}/inboxes/{id}

Atualiza configuracoes de um inbox existente.

Body

Nome	Tipo	Obrigatorio	Descricao
`name`	`string`	Nao	Nome do inbox
`enable_auto_assignment`	`boolean`	Nao	Auto-atribuicao de conversas
`greeting_enabled`	`boolean`	Nao	Saudacao automatica
`greeting_message`	`string`	Nao	Mensagem de saudacao
`out_of_office_message`	`string`	Nao	Mensagem fora do horario

bash

curl -X PATCH "https://chat.seudominio.com/api/v1/accounts/1/inboxes/1" \
  -H "api_access_token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "greeting_message": "Ola! Bem-vindo ao suporte.",
    "enable_auto_assignment": true
  }'

DELETE/api/v1/accounts/{account_id}/inboxes/{id}

Remove um inbox e todas as conversas associadas.

bash

curl -X DELETE "https://chat.seudominio.com/api/v1/accounts/1/inboxes/1" \
  -H "api_access_token: YOUR_TOKEN"

Atencao

Deletar um inbox remove permanentemente todas as conversas e mensagens associadas.

Agentes do Inbox

GET/api/v1/accounts/{account_id}/inbox_members/{inbox_id}

Lista os agentes atribuidos a um inbox.

200Lista de agentes

json

{
  "payload": [
    { "id": 1, "name": "Maria", "role": "agent", "availability_status": "online" },
    { "id": 2, "name": "Pedro", "role": "agent", "availability_status": "offline" }
  ]
}

POST/api/v1/accounts/{account_id}/inbox_members

Adiciona ou atualiza agentes de um inbox.

Body

Nome	Tipo	Obrigatorio	Descricao
`inbox_id`	`integer`	Sim	ID do inbox
`user_ids`	`array`	Sim	Array de IDs dos agentes

bash

curl -X POST "https://chat.seudominio.com/api/v1/accounts/1/inbox_members" \
  -H "api_access_token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "inbox_id": 1, "user_ids": [1, 2, 3] }'

Tipos de Canal

Canal	channel_type	Descricao
Web Widget	`Channel::WebWidget`	Chat ao vivo no site
WhatsApp	`Channel::Whatsapp`	WhatsApp Business API
Email	`Channel::Email`	Caixa de email
API	`Channel::Api`	Canal via API para integracoes customizadas
Telegram	`Channel::Telegram`	Bot do Telegram
Facebook	`Channel::FacebookPage`	Pagina do Facebook Messenger
Instagram	`Channel::Instagram`	DMs do Instagram
SMS	`Channel::Sms`	Mensagens SMS via Twilio