Skip to content

10-messaging.md

Latest commit

 

History

History
107 lines (80 loc) · 2.12 KB

10-messaging.md

File metadata and controls

107 lines (80 loc) · 2.12 KB

10 - Messaging

Overview

Send and receive all types of WhatsApp messages.

Message Types

Type Endpoint Description
Text POST /messages/text Plain text messages
Image POST /messages/image Images with caption
Video POST /messages/video Videos with caption
Audio POST /messages/audio Voice/audio files
Document POST /messages/document Files/PDFs
Location POST /messages/location Map locations
Contact POST /messages/contact Contact cards
Poll POST /messages/poll Interactive polls

Send Text

curl -X POST http://localhost:3001/api/messages/text \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY" \
  -d '{
    "profileId": "profile-123",
    "to": "628123456789",
    "text": "Hello from MultiWA!"
  }'

Send Image

curl -X POST http://localhost:3001/api/messages/image \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY" \
  -d '{
    "profileId": "profile-123",
    "to": "628123456789",
    "url": "https://example.com/image.jpg",
    "caption": "Check this out!"
  }'

Send Poll

curl -X POST http://localhost:3001/api/messages/poll \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY" \
  -d '{
    "profileId": "profile-123",
    "to": "628123456789",
    "question": "What is your favorite color?",
    "options": ["Red", "Blue", "Green"],
    "allowMultiple": false
  }'

Phone Number Format

Both formats are accepted:

Format Example
Without suffix 628123456789
With suffix 628123456789@c.us

For groups, use the full JID: 123456789-123456@g.us

Response

{
  "success": true,
  "data": {
    "messageId": "true_628xxx_3EB0ABC",
    "status": "sent",
    "timestamp": "2026-02-05T10:00:00.000Z"
  }
}

Rate Limits

  • Per profile: 30 messages/minute (adjustable)
  • Bulk API: Use /bulk/send for high-volume

← Webhook Events · Documentation Index · Groups →