Chat agents
Create agents, roles, and multi-application access.
Agents are created by the developer in the dashboard: email, display name, role, password, and one or more chat applications. Share credentials securely with your team (credential card after create).
- One ChatAgent can belong to many applications via ChatAgentApplication (role per app).
- Login uses email + password only — no application id required at login.
- GET /api/chat/agent/me returns applications: [{ id, name, role, ... }].
- If the agent has multiple apps, show an app picker; use switch-application to change the active app in the JWT.
Agent login
curl -X POST https://platform.sohojx.com/api/chat/agent/login \
-H "Content-Type: application/json" \
-d '{"email":"agent@example.com","password":"..."}'Do not mix visitor widget APIs with agent JWT APIs. Tokens are scoped to different actors.