Chat9
APIWidget

Widget Session Init

Start a widget session. Optional `user_hints` attaches untrusted personalization fields (name/email/locale/...) supplied by the tenant frontend; sessions still work without them.

POST
/widget/session/init
/widget/session/init

Request Body

application/jsonRequired

bot_id
Required
Bot Id

Minimum length: 1

user_hintsUser Hints

localeLocale

curl -X POST "https://api.getchat9.live/widget/session/init" \
  -H "Content-Type: application/json" \
  -d '{
    "bot_id": "string",
    "user_hints": {},
    "locale": "string"
  }'

Successful Response

{
  "session_id": "1ffd059c-17ea-40a8-8aef-70fd0307db82",
  "mode": "hints",
  "resumed": false
}