Reference
Authentication
O widget usa token público da instalação. A API mobile usa Bearer token temporário via Sanctum.
Authentication
O widget usa token público da instalação. A API mobile usa Bearer token temporário via Sanctum.
Pagination
Os endpoints de listagem usam page e per_page, com retorno padrão em meta.
Widget API
Fluxo público do widget: carregar config, registar heartbeat, criar visitante, abrir conversa e trocar mensagens.
Mobile API
Camada pronta para app iOS/Android, com auth, fila, atribuição, transferência e encerramento.
Security
Integração simples, mas com regras explícitas para não expor o sistema.
Webhooks
Eventos outbound assinados por HMAC, com envelope versionado para parceiros.
Summary
Widget: envie o token público da instalação em requests públicas do chat.
Mobile API: faça login em /api/mobile/login e use o Bearer token retornado.
Não publique tokens bearer em frontend, repositórios públicos ou apps sem armazenamento seguro.
cURL
Back to developerscurl --request POST \
--url https://chatbeep.app/api/mobile/login \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{
"email": "seu-utilizador@empresa.com",
"password": "SUA_PASSWORD",
"device_name": "sandbox-cli"
}'