Messages
Omdaa API supports different message types including text, images and documents over WhatsApp.
Send a text message
"function">curl "keyword">-X POST https://omdaa.com/api/v1/messages/send class="keyword">-text \
"keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN" \
"keyword">-H "Content"keyword">-Type: application/json" \
"keyword">-d '{
"sessionId": "sess_xxxxxxxx",
"to": "966501234567",
"message": "Hello from Omdaa API"
}'Send an image
"function">curl "keyword">-X POST https://omdaa.com/api/v1/messages/send class="keyword">-image \
"keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN" \
"keyword">-H "Content"keyword">-Type: application/json" \
"keyword">-d '{
"sessionId": "sess_xxxxxxxx",
"to": "966501234567",
"imageUrl": "https://example.com/image.jpg",
"caption": "Image caption"
}'Send a document
"function">curl "keyword">-X POST https://omdaa.com/api/v1/messages/send class="keyword">-document \
"keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN" \
"keyword">-H "Content"keyword">-Type: application/json" \
"keyword">-d '{
"sessionId": "sess_xxxxxxxx",
"to": "966501234567",
"fileUrl": "https://example.com/document.pdf",
"filename": "document.pdf",
"caption": "File caption"
}'Send a video
To send a video:
"function">curl "keyword">-X POST https://omdaa.com/api/v1/messages/send class="keyword">-video \
"keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN" \
"keyword">-H "Content"keyword">-Type: application/json" \
"keyword">-d '{
"sessionId": "sess_xxxxxxxx",
"to": "966501234567",
"videoUrl": "https://example.com/video.mp4",
"caption": "Video caption"
}'Send an audio message
To send an audio message:
"function">curl "keyword">-X POST https://omdaa.com/api/v1/messages/send class="keyword">-audio \
"keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN" \
"keyword">-H "Content"keyword">-Type: application/json" \
"keyword">-d '{
"sessionId": "sess_xxxxxxxx",
"to": "966501234567",
"audioUrl": "https://example.com/audio.ogg"
}'Interactive Messages
Omdaa API supports interactive messages such as buttons, lists, and polls.
Send button message
"function">curl "keyword">-X POST https://omdaa.com/api/v1/interactive/buttons \
"keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN" \
"keyword">-H "Content"keyword">-Type: application/json" \
"keyword">-d '{
"sessionId": "sess_xxxxxxxx",
"to": "966501234567",
"message": "Choose an option:",
"buttons": [
{ "id": "1", "text": "Option 1" },
{ "id": "2", "text": "Option 2" }
]
}'Send list message
"function">curl "keyword">-X POST https://omdaa.com/api/v1/interactive/lists \
"keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN" \
"keyword">-H "Content"keyword">-Type: application/json" \
"keyword">-d '{
"sessionId": "sess_xxxxxxxx",
"to": "966501234567",
"title": "Choose from list",
"description": "Select one of the following options",
"buttonText": "Show list",
"sections": [
{
"title": "Section 1",
"rows": [
{ "id": "1", "title": "Option 1", "description": "Description 1" },
{ "id": "2", "title": "Option 2", "description": "Description 2" }
]
}
]
}'Reactions
You can add reactions (emojis) to messages:
"function">curl "keyword">-X POST https://omdaa.com/api/v1/messages/reactions \
"keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN" \
"keyword">-H "Content"keyword">-Type: application/json" \
"keyword">-d '{
"sessionId": "sess_xxxxxxxx",
"messageId": "message_id",
"reaction": "👍"
}'Read Receipts
You can mark messages as read programmatically:
"function">curl "keyword">-X POST https://omdaa.com/api/v1/messages/read class="keyword">-receipts \
"keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN" \
"keyword">-H "Content"keyword">-Type: application/json" \
"keyword">-d '{
"sessionId": "sess_xxxxxxxx",
"remoteJid": "966501234567@s.whatsapp.net"
}'Get Messages
To get received or sent messages:
# Received messages
"function">curl "keyword">-X GET "https://omdaa.com/api/v1/messages/received?sessionId=sess_xxxxxxxx" \
"keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN"
# Sent messages
"function">curl "keyword">-X GET "https://omdaa.com/api/v1/messages/sent?sessionId=sess_xxxxxxxx" \
"keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN"