Chatbot Streaming and Custom Apps

How to get there: For the website widget, go to Setup → AI agent, select your chatbot, then open Install. For API access, open your profile menu → API Keys.

The Boei website widget streams answers as they arrive. Install the widget and use the JavaScript SDK to open it, ask a question or pass visitor details.

Build your own chat interface

For a custom website interface, mobile app or backend integration, use the authenticated REST API and Native App SDK guide.

curl https://app.boei.help/api/v1/chatbots/CHATBOT_UUID/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"How long does shipping take?"}'

This endpoint returns JSON. Save the returned conversation_id and send it with the next message to continue that conversation. It also supports human takeover, as explained in the native app guide. Keep the API key on your server, outside public browser code.

About the widget's streaming requests

The widget uses its own visitor-session protocol, including an access token and a conversation ID. Its internal /api/ai_chat/send endpoint is not an anonymous public API for custom apps. A conversation ID alone does not grant access. Use the installed widget for streamed browser chat and the REST API for your own interface.

See Cookies for visitor storage, cookie banners and logout behavior.