Skip to Content
CallMitraDocs
API referenceTickets

Reply to the customer

Sends a reply to the ticket's customer on WhatsApp. Within 24 hours of the customer's last message send `text`; after that send `templateEvent` to use the approved template set up for that ticket event. The reply is queued and recorded on the ticket. Retrying with the same `clientId` returns the first reply (with `replayed: true`) instead of sending again.

POST
/api/v1/tickets/{ticket_id}/replies

Sends a reply to the ticket's customer on WhatsApp. Within 24 hours of the customer's last message send text; after that send templateEvent to use the approved template set up for that ticket event. The reply is queued and recorded on the ticket. Retrying with the same clientId returns the first reply (with replayed: true) instead of sending again.

Authorization

headerX-API-Key<token>

Create in the console: Settings → API & webhooks.

Path Parameters

ticket_id*Ticket Id

Ticket id.

Request Body

application/json
  1. body
attachmentIds?array<string>

Files already uploaded to the ticket (console only).

Itemsitems <= 5
clientId*Clientid

Your unique id for this reply (8-64 chars); a retry with it never sends twice.

Length8 <= length <= 64
templateEvent?|

Ticket event (e.g. waiting_on_customer) whose approved template to send instead of text.

text?Text

Reply text (inside the 24-hour window).

Lengthlength <= 4096
Default""
version?|

The ticket version you last read (optional).

Response Body

OK

application/json
  1. response
activities*array<>

Only the activities this request added.

changed*array<string>

Fields that changed (activities when a note or reply was added).

success*Success

Always true on a 2xx response.

ticket*

The ticket after the change.

[key: string]?any
Example Request
curl -X POST 'https://api.callmitra.ai/api/v1/tickets/string/replies' \  -H 'Content-Type: application/json' \  -d '{  "clientId": "crm-reply-88213",  "text": "Hi Asha, your parcel is at our local hub and will be redelivered tomorrow before 6 pm.",  "version": 3}'
Example Response
{  "activities": [    {      "activityType": "reply",      "actorName": "Priya Nair",      "actorUserId": "c2d4e6f8-1a3b-4c5d-8e7f-9a0b1c2d3e4f",      "createdAt": "2026-01-15T11:25:00+00:00",      "id": "4e5f6a7b-8c9d-4e0f-8a1b-3c4d5e6f7a8b",      "payload": {        "clientId": "crm-reply-88213",        "jobIds": [          "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d"        ],        "mode": "text",        "note": "Hi Asha, your parcel is at our local hub and will be redelivered tomorrow before 6 pm.",        "phoneId": "6f7a8b9c-0d1e-4f2a-9b3c-4d5e6f7a8b9c"      },      "ticketId": "5f0c9a3e-2b7d-4c61-9e84-1d6a7b3c2f90"    }  ],  "changed": [    "activities"  ],  "success": true,  "ticket": {    "activityCount": 6,    "assignedToUserId": "c2d4e6f8-1a3b-4c5d-8e7f-9a0b1c2d3e4f",    "assigneeEmail": "[email protected]",    "assigneeName": "Priya Nair",    "assigneeNames": [      "Priya Nair"    ],    "assignees": [      {        "assignedAt": "2026-01-15T09:30:02+00:00",        "email": "[email protected]",        "name": "Priya Nair",        "userId": "c2d4e6f8-1a3b-4c5d-8e7f-9a0b1c2d3e4f"      }    ],    "canEdit": true,    "canManageAssignees": true,    "canReopenClosed": false,    "categoryId": "3b9f1d7e-6c2a-4e85-a0d4-7f1e2c3b4a56",    "categoryName": "Delivery",    "createdAt": "2026-01-15T09:30:00+00:00",    "createdByUserId": "c2d4e6f8-1a3b-4c5d-8e7f-9a0b1c2d3e4f",    "description": "Customer says the parcel was marked delivered but never arrived.",    "dueAt": "2026-01-16T09:30:00+00:00",    "firstResponseAt": "2026-01-15T11:25:00+00:00",    "id": "5f0c9a3e-2b7d-4c61-9e84-1d6a7b3c2f90",    "leadId": "a41e7c2d-8f35-4b09-b6d2-93c0e5f1a7b8",    "leadName": "Asha Verma",    "leadPhone": "+919812345678",    "merchantId": "9d8c7b6a-5f4e-4d3c-8b2a-1f0e9d8c7b6a",    "overdue": false,    "priority": "high",    "ref": "T-5F0C9A3E",    "sla": {      "firstResponse": {        "dueAt": "2026-01-15T13:30:00+00:00",        "state": "ok",        "warnAt": "2026-01-15T12:30:00+00:00"      },      "paused": false,      "resolution": {        "dueAt": "2026-01-16T09:30:00+00:00",        "state": "ok",        "warnAt": "2026-01-16T05:30:00+00:00"      }    },    "source": "manual",    "status": "waiting_on_customer",    "subject": "Order #1042 not delivered",    "tags": [      "order-1042"    ],    "teamId": "e7a1c3d5-9b2f-4d68-8a0c-2e4f6a8b0c1d",    "teamName": "Customer care",    "type": "support",    "updatedAt": "2026-01-15T11:25:00+00:00",    "version": 4  }}