Intervention

Allows a human team member to intervene in a chat conversation. This sends a message from a “team_member” role and can optionally trigger external notifications (e.g., via WhatsApp or Email) depending on the conversation channel.

POST /api/agents/chat/intervention

Request Body


{
  "message": "I'm stepping in to help.",
  "user_id": "123e4567-e89b-12d3-a456-426614174000",
  "conversationId": "123e4567-e89b-12d3-a456-426614174000",
  "agentId": "optional-uuid",
  "site_id": "optional-uuid"
}

Parameter	Type	Required	Description
`message`	`string`	Yes	The content of the intervention message.
`user_id`	`string`	Yes	The UUID of the team member performing the intervention.
`conversationId`	`string`	No	The UUID of the conversation.
`agentId`	`string`	No	The UUID of the agent.
`site_id`	`string`	No	The UUID of the site.

Response


{
  "success": true,
  "data": {
    "interventionId": "uuid",
    "status": "completed",
    "conversation_id": "uuid",
    "message": {
      "content": "I'm stepping in to help.",
      "role": "team_member",
      "user_id": "..."
    },
    "channel_send": {
      "success": true,
      "method": "whatsapp"
    }
  }
}