Usuário e agente

​

Em poucas palavras

​

Quando usar USER

1. A pessoa faz login no seu app
2. Seu backend faz upsert (PUT /v1/chat/users) com o id dela
3. Seu backend emite o JWT (POST /v1/chat/users/token)
4. O app conecta o WebSocket com esse JWT e envia mensagens como ela

​

Quando usar AGENT

• Alguém da equipe responde no painel (Chat ou Inbox) — a Notifique já cria o agente agent:{idDoUsuárioDoWorkspace}
• Seu backend envia um aviso na conversa como suporte (senderExternalUserId do agente)
• Você quer métricas de enviadas (agente) vs recebidas (usuário) separadas no detalhe do Chat App

POST /v1/chat/agents
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx

{
  "chatAppId": "clxxapp...",
  "workspaceUserId": "clxxuser...",
  "externalUserId": "agent:clxxuser...",
  "name": "Ana (suporte)"
}

{
  "from": "clxxapp...",
  "to": ["cnv_xxxxx"],
  "type": "text",
  "payload": { "message": "Oi, como posso ajudar?" },
  "senderExternalUserId": "agent:clxxuser..."
}

​

O que não misturar

• Não entregue JWT de AGENT no aplicativo do cliente. O cliente fala com o JWT de USER.
• Não cadastre a equipe como USER se ela atende pelo painel — o webhook iria como chat.received (como se fosse o cliente falando).
• Dois USER na mesma conversa 1:1 é conversa entre pessoas do seu produto. Um USER e um AGENT é atendimento.

​

Flags do Chat App