मुख्य सामग्री पर जाएं

​
Messages भेजना

सभी messages एक single endpoint के माध्यम से भेजे जाते हैं। type field निर्धारित करता है कि किस प्रकार का message भेजा जाएगा, और शेष fields तदनुसार बदलते हैं। Endpoint: 
POST https://api.wappfy.io/api/instances/{instanceId}/messages/send
Headers:
HeaderValue
X-Api-Keyआपकी API key
Content-Typeapplication/json

​
Text Message

एक plain text message भेजें। 
curl -X POST https://api.wappfy.io/api/instances/inst_abc123/messages/send \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "5511999998888@s.whatsapp.net",
    "type": "text",
    "text": "Hello from Wappfy!"
  }'
Response: 
{
  "data": {
    "message_id": "BAE5F2C4D3B2A1",
    "status": "sent"
  }
}

​
Image Message

एक optional caption के साथ image भेजें। 
curl -X POST https://api.wappfy.io/api/instances/inst_abc123/messages/send \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "5511999998888@s.whatsapp.net",
    "type": "image",
    "media_url": "https://example.com/photo.jpg",
    "caption": "Check out this photo!"
  }'

​
Video Message

एक optional caption के साथ video file भेजें। 
curl -X POST https://api.wappfy.io/api/instances/inst_abc123/messages/send \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "5511999998888@s.whatsapp.net",
    "type": "video",
    "media_url": "https://example.com/clip.mp4",
    "caption": "Watch this!"
  }'

​
Audio Message

एक audio file भेजें। Audio messages WhatsApp में voice messages के रूप में दिखाई देते हैं। 
curl -X POST https://api.wappfy.io/api/instances/inst_abc123/messages/send \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "5511999998888@s.whatsapp.net",
    "type": "audio",
    "media_url": "https://example.com/voice-note.ogg"
  }'
सर्वोत्तम compatibility के लिए, voice messages के लिए Opus codec से encoded .ogg files का उपयोग करें।

​
Document Message

एक file को document attachment के रूप में भेजें। 
curl -X POST https://api.wappfy.io/api/instances/inst_abc123/messages/send \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "5511999998888@s.whatsapp.net",
    "type": "document",
    "media_url": "https://example.com/report.pdf",
    "filename": "Q1-Report.pdf",
    "caption": "Here is the quarterly report"
  }'

​
Location Message

एक geographic location pin भेजें। 
curl -X POST https://api.wappfy.io/api/instances/inst_abc123/messages/send \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "5511999998888@s.whatsapp.net",
    "type": "location",
    "latitude": -23.5505,
    "longitude": -46.6333,
    "name": "Sao Paulo",
    "address": "Sao Paulo, SP, Brazil"
  }'

​
Poll Message

एक interactive poll बनाएं। प्राप्तकर्ता WhatsApp में सीधे options पर vote कर सकते हैं। 
curl -X POST https://api.wappfy.io/api/instances/inst_abc123/messages/send \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "5511999998888@s.whatsapp.net",
    "type": "poll",
    "poll_name": "What day works best for the meeting?",
    "poll_options": ["Monday", "Wednesday", "Friday"],
    "poll_allow_multiple": false
  }'

​
Contact / vCard Message

एक contact card share करें। 
curl -X POST https://api.wappfy.io/api/instances/inst_abc123/messages/send \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "5511999998888@s.whatsapp.net",
    "type": "contact",
    "contact_name": "Maria Silva",
    "contact_phone": "+5511988887777"
  }'

​
Forward Message

किसी मौजूदा message को दूसरी chat में forward करें। 
curl -X POST https://api.wappfy.io/api/instances/inst_abc123/messages/send \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "5511888887777@s.whatsapp.net",
    "type": "forward",
    "forward_message_id": "BAE5F2C4D3B2A1",
    "forward_chat_id": "5511999998888@s.whatsapp.net"
  }'

​
Reaction

किसी message पर emoji से react करें। 
curl -X POST https://api.wappfy.io/api/instances/inst_abc123/messages/send \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "5511999998888@s.whatsapp.net",
    "type": "reaction",
    "reaction_message_id": "BAE5F2C4D3B2A1",
    "reaction": "\ud83d\udc4d"
  }'
Reaction हटाने के लिए, reaction value के रूप में एक empty string भेजें।

​
उन्नत सुविधाएं

​
किसी Message का Reply

quoted_message_id शामिल करके पिछले message को quote करें। यह किसी भी message type के साथ काम करता है। 
curl -X POST https://api.wappfy.io/api/instances/inst_abc123/messages/send \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "5511999998888@s.whatsapp.net",
    "type": "text",
    "text": "Yes, I agree with this!",
    "quoted_message_id": "BAE5F2C4D3B2A1"
  }'

​
भेजे गए Message को Edit करें

edit_message_id देकर अपने पहले भेजे गए message को edit करें। 
curl -X POST https://api.wappfy.io/api/instances/inst_abc123/messages/send \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "5511999998888@s.whatsapp.net",
    "type": "text",
    "text": "Updated message content",
    "edit_message_id": "BAE5F2C4D3B2A1"
  }'
आप केवल अपने भेजे हुए messages को edit कर सकते हैं। WhatsApp द्वारा editing पर एक समय सीमा लगाई गई है (भेजने के बाद लगभग 15 मिनट)।

​
Mentions

Group message में specific contacts को mention करें। Mentioned contacts को notification प्राप्त होगा। 
curl -X POST https://api.wappfy.io/api/instances/inst_abc123/messages/send \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "120363012345678901@g.us",
    "type": "text",
    "text": "Hey @Maria and @Carlos, please review this.",
    "mentions": [
      "5511999998888@s.whatsapp.net",
      "5511888887777@s.whatsapp.net"
    ]
  }'

​
Chat ID Formats

Formatविवरणउदाहरण
{phone}@s.whatsapp.netव्यक्तिगत chat5511999998888@s.whatsapp.net
{id}@g.usGroup chat120363012345678901@g.us

​
ब्राज़ीलियन Phone Numbers

Wappfy स्वचालित रूप से ब्राज़ीलियन 9वें अंक की समस्या को handle करता है। यदि कोई message “no LID found” error के साथ विफल होता है, तो system स्वचालित रूप से वैकल्पिक format (9वां अंक जोड़कर या हटाकर) के साथ retry करेगा।उदाहरण के लिए, यदि 5511999998888 विफल होता है, तो यह 551199998888 के साथ retry करेगा, और इसके विपरीत। यह पारदर्शी रूप से होता है — आपको इसे स्वयं handle करने की आवश्यकता नहीं है।

​
Message Type Reference

Typeआवश्यक Fieldsवैकल्पिक Fields
texttextquoted_message_id, edit_message_id, mentions
imagemedia_urlcaption, quoted_message_id
videomedia_urlcaption, quoted_message_id
audiomedia_urlquoted_message_id
documentmedia_urlfilename, caption, quoted_message_id
locationlatitude, longitudename, address, quoted_message_id
pollpoll_name, poll_optionspoll_allow_multiple
contactcontact_name, contact_phonequoted_message_id
forwardforward_message_id, forward_chat_id—
reactionreaction_message_id, reaction—

​
Error Handling

Status Codeविवरण
400अमान्य message payload (जैसे, दिए गए type के लिए आवश्यक fields गायब हैं)।
404Instance नहीं मिला या connected नहीं है।
422Message validation विफल (जैसे, अमान्य phone number format)।
429Rate limit पार हो गई। Rate Limits देखें।
502WhatsApp provider ने error लौटाया। विवरण के लिए error message जांचें।