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.

Chat agents · Central Auth Docs | SohojX Platform