AI Chatbot
Drive conversations with Boltly's AI chatbot: send messages, configure the agent graph, and check readiness.
/v1/chatbot/chat Send chat
Send a message to the AI chatbot for a conversation and receive the generated reply.
Parameters
conversation_id string required ID of the conversation the message belongs to.
message string required The user message for the chatbot to respond to.
contact_phone string Contact phone number in E.164 format, used for contact-aware responses.
Request
curl -X POST https://api.boltly.online/v1/chatbot/chat \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"conversation_id": "conv_01H...",
"message": "What are your business hours?",
"contact_phone": "+1234567890"
}'Response
{
"data": {
"conversation_id": "conv_01H...",
"response": "We are open Monday to Friday, 9am to 6pm.",
"agent_used": "faq_agent"
}
}/v1/chatbot/config Configure
Create or update the chatbot configuration for your organization, including the agent graph definition.
Parameters
name string Display name for this chatbot configuration.
graph_definition object required The agent graph definition describing nodes, edges, and entry point.
Request
curl -X POST https://api.boltly.online/v1/chatbot/config \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Support bot",
"graph_definition": {
"entry": "greet",
"nodes": [{ "id": "greet", "type": "llm" }],
"edges": []
}
}'Response
{
"data": {
"id": "cfg_01H...",
"name": "Support bot",
"graph_definition": {
"entry": "greet",
"nodes": [{ "id": "greet", "type": "llm" }],
"edges": []
},
"is_active": true
}
}/v1/chatbot/status Get status
Check whether the chatbot is ready to answer, along with its knowledge base counts.
Parameters
— No parameters. The organization is derived from your API key.
Request
curl https://api.boltly.online/v1/chatbot/status \
-H "X-API-Key: $API_KEY"Response
{
"data": {
"ready": true,
"doc_count": 12,
"qa_count": 48
}
}