AI

AI-powered conversations: view drafts, approve/edit responses, and monitor usage.

AI agents automatically classify inbound messages, generate draft responses, and can auto-reply when confidence is high. Use the API to list conversations, review drafts, approve or edit responses, and monitor AI usage across your organization.

Endpoints

Method	Description	Permission
GET	List AI conversations	ai.conversations
GET	Get conversation detail	ai.conversations
GET	Get conversation messages	ai.conversations
POST	Approve a draft message	ai.drafts
POST	Edit and approve a draft	ai.drafts
POST	Send a manual reply	ai.drafts
GET	List AI agents	ai.agents_read
GET	Get AI usage statistics	ai.conversations

List Conversations

GET /api/v1/ai/conversations

Request

Response

{
  "success": true,
  "data": [
    {
      "id": "conv-uuid-1",
      "subject": "Question about pricing",
      "from": "prospect@example.com",
      "status": "pending_review",
      "confidence": 0.82,
      "category": "sales",
      "sentiment": "positive",
      "agentName": "Support Bot",
      "created_at": "2026-03-18T10:00:00Z",
      "draftId": "draft-uuid-1"
    },
    {
      "id": "conv-uuid-2",
      "subject": "Cannot login to my account",
      "from": "user@example.com",
      "status": "auto_replied",
      "confidence": 0.95,
      "category": "support",
      "sentiment": "negative",
      "agentName": "Support Bot",
      "created_at": "2026-03-18T09:30:00Z",
      "draftId": null
    }
  ],
  "meta": { "page": 1, "per_page": 20, "total": 34, "total_pages": 2 }
}

json

Approve Draft

POST /api/v1/ai/drafts/:id/approve • POST /api/v1/ai/drafts/:id/edit

Request

Response

{
  "success": true,
  "data": {
    "id": "draft-uuid-1",
    "status": "approved",
    "sentVia": "email",
    "approved_at": "2026-03-18T10:05:00Z"
  }
}

json