REF-901-06: Chatwoot Integration
ADR: ADR-901 — IntegrationsEscopo: Contact view via API v1, autenticação shared secret, Chatwoot PHP SDK
1. Contact View — Dados via API v1
O Chatwoot é a ferramenta de chat ao vivo (widget web + WhatsApp Business). A maior parte da integração vive no App NextJS. O plugin fornece:
- REST API endpoints que o NextJS consome para montar o contact view (dados de organizations, orders, quotes, licenses agregados)
- Chatwoot PHP SDK (
ramiroestrella/chatwoot-php-sdk) para operações server-side (criar/atualizar contato no Chatwoot a partir do plugin)
| Dado | Endpoint API v1 | Prioridade |
|---|---|---|
| Organization (nome, plano) | GET /organizations/{id} | Alta |
| Orders ativos | GET /orders?org={id} | Alta |
| Quotes pendentes | GET /quotes?org={id} | Alta |
| Licenses ativas/expirando | GET /licenses?org={id} | Média |
2. Autenticação
Contact view usa shared secret (não JWT de usuário). Header Authorization: Bearer {CHATWOOT_CONTACT_VIEW_SECRET}. Secret como env var em ambos os lados.
3. Chatwoot PHP SDK
Sincronização server-side — criar contatos, atualizar atributos custom, associar conversas a Organizations. Operações disparadas por eventos de domínio.