Send audio, documents, and stickers

curl --request POST \
  --url https://api.wadial.com/api/v1/sessions/{sessionId}/messages/audio \
  --header 'Authorization: Bearer <token>'

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.wadial.com/api/v1/sessions/{sessionId}/messages/audio', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.wadial.com/api/v1/sessions/{sessionId}/messages/audio"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

POST

api

sessions

{sessionId}

messages

audio

Send audio, documents, and stickers

curl --request POST \
  --url https://api.wadial.com/api/v1/sessions/{sessionId}/messages/audio \
  --header 'Authorization: Bearer <token>'

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.wadial.com/api/v1/sessions/{sessionId}/messages/audio', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.wadial.com/api/v1/sessions/{sessionId}/messages/audio"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

Use the same shape for audio, document, and sticker sends. Replace the final path segment with the content type you want:

POST /api/v1/sessions/{sessionId}/messages/audio
Authorization: Bearer <api_key>
Content-Type: application/json
Idempotency-Key: <unique-message-key>

{
  "to": "15551234567",
  "content": {
    "type": "audio",
    "mediaUrl": "https://example.com/voice.ogg",
    "mimetype": "audio/ogg; codecs=opus",
    "voice": true
  }
}

Document example:

POST /api/v1/sessions/{sessionId}/messages/document
Authorization: Bearer <api_key>
Content-Type: application/json

{
  "to": "15551234567",
  "content": {
    "type": "document",
    "mediaUrl": "https://example.com/report.pdf",
    "mimetype": "application/pdf",
    "fileName": "report.pdf",
    "caption": "Your report"
  }
}

Sticker example:

POST /api/v1/sessions/{sessionId}/messages/sticker
Authorization: Bearer <api_key>
Content-Type: application/json

{
  "to": "15551234567",
  "content": {
    "type": "sticker",
    "mediaUrl": "https://example.com/sticker.webp",
    "mimetype": "image/webp"
  }
}

You can also upload a file with multipart/form-data using fields to, media, mimetype, caption, fileName, and voice. Successful responses return the outgoing message record:

{
  "data": {
    "contentType": "audio",
    "status": "sent",
    "messageId": "3EB0A1B2C3D4E5F6"
  }
}

Get started

Guides

Build with the API

API Reference

Send audio, documents, and stickers