curl https://zeplo.ai/api/conversations/1 \
-H "x-api-key: YOUR_API_KEY" \
-H "x-api-secret: YOUR_API_SECRET" \
-H "x-channel-id: YOUR_CHANNEL_ID"
{
"success": true,
"data": {
"id": 1,
"channelId": "647015955153740",
"contactId": 5,
"contact": {
"id": 5,
"name": "John Doe",
"phone": "919876543210",
"email": "john@example.com",
"avatar": null
},
"status": "open",
"assignedTo": 2,
"assignedToName": "Agent Smith",
"lastMessage": "Hello, I need help",
"lastMessageAt": "2026-01-15T10:30:00Z",
"unreadCount": 3,
"tags": ["support", "billing"],
"metadata": {},
"automationStatus": null,
"createdAt": "2026-01-14T08:00:00Z",
"updatedAt": "2026-01-15T10:30:00Z"
}
}
Conversations
GET Get Conversation
Retrieve a single conversation by ID.
GET
/
api
/
conversations
/
:id
curl https://zeplo.ai/api/conversations/1 \
-H "x-api-key: YOUR_API_KEY" \
-H "x-api-secret: YOUR_API_SECRET" \
-H "x-channel-id: YOUR_CHANNEL_ID"
{
"success": true,
"data": {
"id": 1,
"channelId": "647015955153740",
"contactId": 5,
"contact": {
"id": 5,
"name": "John Doe",
"phone": "919876543210",
"email": "john@example.com",
"avatar": null
},
"status": "open",
"assignedTo": 2,
"assignedToName": "Agent Smith",
"lastMessage": "Hello, I need help",
"lastMessageAt": "2026-01-15T10:30:00Z",
"unreadCount": 3,
"tags": ["support", "billing"],
"metadata": {},
"automationStatus": null,
"createdAt": "2026-01-14T08:00:00Z",
"updatedAt": "2026-01-15T10:30:00Z"
}
}
Get Conversation
GET /api/conversations/:id
Retrieve details of a specific conversation.
Headers
string
required
Your API key
string
required
Your API secret key
string
required
WhatsApp channel ID
curl https://zeplo.ai/api/conversations/1 \
-H "x-api-key: YOUR_API_KEY" \
-H "x-api-secret: YOUR_API_SECRET" \
-H "x-channel-id: YOUR_CHANNEL_ID"
Path parameters
integer
required
Conversation ID.
{
"success": true,
"data": {
"id": 1,
"channelId": "647015955153740",
"contactId": 5,
"contact": {
"id": 5,
"name": "John Doe",
"phone": "919876543210",
"email": "john@example.com",
"avatar": null
},
"status": "open",
"assignedTo": 2,
"assignedToName": "Agent Smith",
"lastMessage": "Hello, I need help",
"lastMessageAt": "2026-01-15T10:30:00Z",
"unreadCount": 3,
"tags": ["support", "billing"],
"metadata": {},
"automationStatus": null,
"createdAt": "2026-01-14T08:00:00Z",
"updatedAt": "2026-01-15T10:30:00Z"
}
}
Conversation object
| Field | Type | Description |
|---|---|---|
id | integer | Unique conversation ID |
channelId | string | WhatsApp channel ID |
contactId | integer | Contact ID |
contact | object | Contact details |
status | string | open, resolved, or closed |
assignedTo | integer|null | Assigned team member user ID |
assignedToName | string|null | Assigned team member name |
lastMessage | string | Preview of last message |
lastMessageAt | string | ISO 8601 timestamp |
unreadCount | integer | Unread message count |
tags | string[] | Conversation tags |
metadata | object | Custom metadata |
automationStatus | string|null | Active automation status |
createdAt | string | ISO 8601 timestamp |
updatedAt | string | ISO 8601 timestamp |
