SohojXDocumentation

Chat quickstart

Create a chat app, embed the widget, and open the agent inbox.

  1. 1Subscribe to Chat (if required)

    Dashboard → Billing → Chat. Pick a plan so you can create chat applications within your limits.

  2. 2Create a chat application

    Dashboard → Chat → Applications → New. Complete the wizard: name, domains, visitor origins, agent origins, and widget branding.

  3. 3Copy credentials

    Save chatApplicationId (cap_...), widget key (wk_...), and chatApplicationSecret (shown once) from the application detail page.

  4. 4Embed the visitor widget

    Paste the Tawk-style snippet on your site. It loads https://platform.sohojx.com/chat/embed/{cap_...}/{wk_...}.

  5. 5Create an agent

    Add an agent with email, name, role, and password. Assign one or more chat applications.

  6. 6Reply from the inbox

    Sign in at /chat/agent/login with agent credentials, or embed the agent widget on an allowed agent origin.

Test locally: add http://localhost:3000 (or your dev port) as a visitor origin. Localhost is accepted for visitor APIs in development.

Chat quickstart · Central Auth Docs | SohojX Platform