Inbox de API customizada

Para canais que não estão na lista nativa — ou para construir um canal próprio. Você manda JSON pra plataforma e recebe JSON quando o atendente responde.

Quando usar

🔌

App próprio

Você tem um app mobile/web e quer trazer o chat do app pro Help Desk.

📦

Canal não suportado

Plataformas locais (Olx, Mercado Livre, marketplaces) ou redes específicas.

🤖

Bots em outras plataformas

Você roda um bot Discord/Slack próprio e quer centralizar atendimento humano.

🧪

Testes e protótipos

Para validar fluxos sem precisar conectar canal real.

Como funciona

Configuração

1. Crie a inbox

   **+ Nova Inbox → API**. Coloque um nome e (opcional) URL do webhook de saída.
2. Pegue as credenciais

   A inbox gera um **API Inbox Identifier** e um **HMAC Token**. Use-os para autenticar requisições.
3. Mande mensagens via API

   Endpoint:

   POST https://desk.cosmobots.io/api/v1/accounts/{account_id}/inboxes/{inbox_id}/messages

   Header:

   api_access_token: {seu_token}
   Content-Type: application/json

   Body:

   {
     "content": "Olá, preciso de ajuda",
     "message_type": "incoming",
     "contact": {
       "name": "Fulano",
       "identifier": "user-123"
     }
   }

4. Receba respostas via webhook

   Configure o webhook de saída pra receber as respostas do atendente em tempo real.

Documentação técnica completa

A seção de Desenvolvedores está em construção. Por ora, a API segue o padrão Chatwoot (a base do Cosmobots) — você pode usar a doc do Chatwoot como referência: chatwoot.com/developers/api.

Próximos passos

• Webhooks (lista de eventos)
• Bloco Webhook em fluxos