Messages
Send DMs and read conversations.
Send a DM to a customer and read the account’s conversations. Instagram only lets a business message someone within 24 hours of that person’s last message. Customers are identified by their Instagram-scoped ID (IGSID), the id in the conversation participants and message senders.
DMs can only be sent within 24 hours of the customer’s last message (Instagram policy).
Copy this section as context for your AI coding agent
curl -X POST 'https://api.chatverse.io/v1/instagram/messages' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"recipient_id": "17841400000000001",
"text": "Thanks for your order! It ships tomorrow."
}'Response · 200
json
{
"success": true,
"message": "Message sent.",
"data": {
"message_id": "aWdfZAG1faXRlbToxOklH…",
"recipient_id": "17841400000000001"
}
}text up to 1,000 characters. 502 SEND_FAILED when Instagram refuses it (usually the 24-hour window has closed). Counts towards the tighter limit of 10 a minute.
curl -X GET 'https://api.chatverse.io/v1/instagram/conversations' \
-H 'Authorization: Bearer YOUR_API_KEY'Response · 200
json
{
"success": true,
"message": "Conversations fetched successfully",
"data": {
"data": [
{
"id": "aWdfZAG06MTpJR01lc3NhZA2VUaHJlYWQ…",
"participants": {
"data": [
{
"username": "yourbrand",
"id": "17841401234567890"
},
{
"username": "maya.comments",
"id": "17841400000000001"
}
]
}
}
],
"paging": {
"cursors": {
"after": "QVFIUm…"
}
}
}
}curl -X GET 'https://api.chatverse.io/v1/instagram/conversations/{conversation_id}/messages' \
-H 'Authorization: Bearer YOUR_API_KEY'Response · 200
json
{
"success": true,
"message": "Messages fetched successfully",
"data": {
"messages": [
{
"id": "aWdfZAG1faXRlbToxOklH…",
"created_time": "2026-11-15T10:42:11+0000",
"from": {
"username": "maya.comments",
"id": "17841400000000001"
},
"to": {
"data": [
{
"username": "yourbrand",
"id": "17841401234567890"
}
]
},
"message": "How much for the blue one?"
}
],
"pagination": {
"cursors": {
"after": "QVFIUm…"
}
}
}
}Pass ?after= with pagination.cursors.after for the next page.