Chatbot API: the same assistant, in your own app.

Authentication

Add an Authorization: Bearer sk_… header to every request. The API is for server-to-server use only; requests from browsers (CORS) are refused. To chat with visitors on your website, use the widget.

POSThttps://api.helovo.com/v1/chat

Request

curl https://api.helovo.com/v1/chat \
  -H "Authorization: Bearer $HELOVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bot_id": "bot_…",
    "message": "Hello",
    "user": "customer-42"
  }'

Response

{
  "id": "msg_01J…",
  "conversation_id": "conv_01J…",
  "answer": "Hello, how can I help you?",
  "model": "standard",
  "finish_reason": "stop",
  "usage": { "input_tokens": 142, "output_tokens": 18 }
}

Streaming answer

"stream": true makes the answer arrive as Server-Sent Events: meta → delta (pieces of text) → done or error.

curl -N https://api.helovo.com/v1/chat \
  -H "Authorization: Bearer $HELOVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "bot_id": "bot_…", "message": "Hello", "stream": true }'

Other endpoints

• GET /v1/chatbots — The chatbots the key can use.
• GET /v1/conversations/{id} — The messages of a conversation started through the API.

Errors and limits

Errors come back as {"error": {"code": "…", "message": "…", "request_id": "…"}}. Every response includes the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.