curl "https://zeplo.ai/api/conversations/1/messages?search=msg_42" \
-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": 42,
"conversationId": 1,
"type": "text",
"content": {
"text": "Hello from Zeplo!"
},
"direction": "outbound",
"status": "delivered",
"senderId": 1,
"senderName": "Admin",
"senderPhone": null,
"contactPhone": "919876543210",
"whatsappMessageId": "wamid.HBgMOTE5ODc2NTQzMjEwFQIAERgS...",
"mediaUrl": null,
"templateName": null,
"createdAt": "2026-01-15T10:30:00Z",
"updatedAt": "2026-01-15T10:30:01Z"
}
}
Messages
GET Get Message
Retrieve a single message by its ID.
GET
/
api
/
conversations
/
:conversationId
/
messages
curl "https://zeplo.ai/api/conversations/1/messages?search=msg_42" \
-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": 42,
"conversationId": 1,
"type": "text",
"content": {
"text": "Hello from Zeplo!"
},
"direction": "outbound",
"status": "delivered",
"senderId": 1,
"senderName": "Admin",
"senderPhone": null,
"contactPhone": "919876543210",
"whatsappMessageId": "wamid.HBgMOTE5ODc2NTQzMjEwFQIAERgS...",
"mediaUrl": null,
"templateName": null,
"createdAt": "2026-01-15T10:30:00Z",
"updatedAt": "2026-01-15T10:30:01Z"
}
}
Get Message
GET /api/conversations/:conversationId/messages
Retrieve details of a specific message within a conversation.
Authorization
| Header | Required | Description |
|---|---|---|
x-api-key | Yes | Your API key |
x-api-secret | Yes | Your API secret key |
x-channel-id | Yes | WhatsApp channel ID |
curl "https://zeplo.ai/api/conversations/1/messages?search=msg_42" \
-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": 42,
"conversationId": 1,
"type": "text",
"content": {
"text": "Hello from Zeplo!"
},
"direction": "outbound",
"status": "delivered",
"senderId": 1,
"senderName": "Admin",
"senderPhone": null,
"contactPhone": "919876543210",
"whatsappMessageId": "wamid.HBgMOTE5ODc2NTQzMjEwFQIAERgS...",
"mediaUrl": null,
"templateName": null,
"createdAt": "2026-01-15T10:30:00Z",
"updatedAt": "2026-01-15T10:30:01Z"
}
}
Message object
| Field | Type | Description |
|---|---|---|
id | integer | Unique message ID |
conversationId | integer | Parent conversation ID |
type | string | Message type (text, image, document, etc.) |
content | object | Message content (varies by type) |
direction | string | inbound or outbound |
status | string | Delivery status |
senderId | integer|null | User ID of the sender (for outbound) |
senderName | string | Name of the sender |
senderPhone | string|null | Phone of the sender (for inbound) |
contactPhone | string | Contact phone number |
whatsappMessageId | string|null | WhatsApp message ID |
mediaUrl | string|null | Media file URL |
templateName | string|null | Template name (if template message) |
createdAt | string | ISO 8601 timestamp |
updatedAt | string | ISO 8601 timestamp |