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"