Messages

All message endpoints require messages:send scope. Phone numbers should be E.164 (e.g. +255712345678).

POST /messages/text

POST https://whatsapp.s.co.tz/api/v1/messages/text
{
  "instance_id": "inst_xxxxxxxxxxxx",
  "to": "+255712345678",
  "text": "Your message"
}

POST /messages/image

POST https://whatsapp.s.co.tz/api/v1/messages/image
{
  "instance_id": "inst_xxxxxxxxxxxx",
  "to": "+255712345678",
  "media": "https://example.com/image.jpg",
  "caption": "Optional caption",
  "file_name": "photo.jpg",
  "mimetype": "image/jpeg"
}

POST /messages/document

Same body as image; set file_name and mimetype for documents.

POST https://whatsapp.s.co.tz/api/v1/messages/document
{
  "instance_id": "inst_xxxxxxxxxxxx",
  "to": "+255712345678",
  "media": "https://example.com/invoice.pdf",
  "caption": "Optional caption",
  "file_name": "invoice.pdf",
  "mimetype": "application/pdf"
}

POST /messages/audio

POST https://whatsapp.s.co.tz/api/v1/messages/audio
{
  "instance_id": "inst_xxxxxxxxxxxx",
  "to": "+255712345678",
  "media": "https://example.com/https://example.com/note.ogg",
  "caption": "Optional caption",
  "file_name": "note.ogg",
  "mimetype": "audio/ogg"
}

POST /messages/video

POST https://whatsapp.s.co.tz/api/v1/messages/video
{
  "instance_id": "inst_xxxxxxxxxxxx",
  "to": "+255712345678",
  "media": "https://example.com/https://example.com/clip.mp4",
  "caption": "Optional caption",
  "file_name": "clip.mp4",
  "mimetype": "video/mp4"
}

Success response

{
  "success": true,
  "data": {
    "message": { ... },
    "mode": "live"
  }
}