BOboei
Chatbot Messages

Request Live Chat Escalation

Explicitly escalate a conversation to a human agent. The visitor's subsequent messages (via POST /messages) will be delivered to the agent instead of generating AI responses. The client should poll GET /conversations/{id}/messages for agent replies.

post/chatbots/{chatbot_id}/conversations/{conversation_id}/escalate

Request

  • Base URL
    https://app.boei.help/api/v1
  • Auth
    HTTP bearer

Request body

reasonstring nullable

Optional short reason shown to agents.

Example request

{
  "reason": "User asked to speak to support"
}

Response

OR

Example response

{
  "conversation_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "mode": "waiting_for_agent",
  "message": "You're in the queue. An agent will join shortly."
}

Changes

No recorded changes to this operation across all 2 revisions of this API.