WhatsApp संदेश भेजना

एक न्यूनतम सेंड

const msg = await bird.whatsapp.send({
  to: "+15551234567",
  template: {
    slug: "bird_otp",
    components: [{ type: "body", parameters: [{ type: "text", text: "123456" }] }],
  },
});
console.log(msg.id, msg.status);

msg = client.whatsapp.send(
    to="+31612345678",
    template="bird_otp",
    language="en",
    components=[{"type": "body", "parameters": [{"type": "text", "text": "123456"}]}],
)
print(msg.id, msg.status)

code := "123456"
msg, err := client.Whatsapp.Send(context.Background(), bird.WhatsappSendParams{
	To:       "+15551234567",
	Template: "bird_otp",
	Language: "en",
	Components: []bird.WhatsAppMessageTemplateComponent{{
		Type:       "body",
		Parameters: &[]bird.WhatsAppMessageTemplateComponentParameter{{Type: "text", Text: &code}},
	}},
})
if err != nil {
	log.Fatal(err)
}
fmt.Println(msg.Id, *msg.Status)

$message = $bird->whatsapp->send(
    to: '+15551234567',
    template: 'bird_otp',
    language: 'en',
    components: [
        (new WhatsAppMessageTemplateComponent())
            ->setType('body')
            ->setParameters([
                (new WhatsAppMessageTemplateComponentParameter())->setType('text')->setText('123456'),
            ]),
    ],
);
echo $message->getId(), ' ', $message->getStatus();

bird whatsapp send \
  --components '[{"parameters":[{"text":"1234","type":"text"}],"type":"body"},{"parameters":[{"text":"1234","type":"text"}],"type":"button"}]' \
  --language en \
  --template bird_otp \
  --to +31612345678

curl -X POST "https://{region}.platform.bird.com/v1/whatsapp/messages" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+31612345678",
    "template": {
      "slug": "bird_otp",
      "language": "en",
      "components": [
        {
          "type": "body",
          "parameters": [
            {
              "type": "text",
              "text": "1234"
            }
          ]
        },
        {
          "type": "button",
          "parameters": [
            {
              "type": "text",
              "text": "1234"
            }
          ]
        }
      ]
    }
  }'

कस्टमर सर्विस विंडो

पेलोड बनाना

प्राप्तकर्ता

टेम्पलेट

• slug (आवश्यक): टेम्पलेट का slug, जैसे bird_order_confirmation। यह आपके कैटलॉग में किसी टेम्पलेट से मैच होना चाहिए (lowercase अक्षर, अंक, और अंडरस्कोर)।
• language: टेम्पलेट का language tag, जैसे en या pt-BR। टेम्पलेट की डिफ़ॉल्ट भाषा भेजने के लिए इसे छोड़ दें; जो भाषा टेम्पलेट में नहीं है उसे नाम देने पर 422 लौटता है जो उपलब्ध भाषाओं की सूची देता है। स्वीकृत संदेश resolved भाषा को echo करता है।
• components: वे वैल्यूज़ जो टेम्पलेट के वेरिएबल्स को भरती हैं (देखें कम्पोनेंट और पैरामीटर)। बिना वेरिएबल्स वाले टेम्पलेट के लिए इसे छोड़ दें।

कम्पोनेंट और पैरामीटर

{
  "components": [
    { "type": "body", "parameters": [{ "type": "text", "text": "481920" }] },
    { "type": "button", "parameters": [{ "type": "text", "text": "481920" }] }
  ]
}

कैटेगरी और सेंडर

• एक Bird-managed टेम्पलेट (जिसका slug bird_ से शुरू होता है) उस नंबर से भेजता है जो Bird उस कैटेगरी के लिए रखता है, इसलिए from को छोड़ दें। इसे सेट करने पर 422 WhatsAppSenderNotAllowed लौटता है।
• बाकी सब कुछ from में अपना सेंडर निर्दिष्ट करता है: किसी भी प्रकार का सर्विस मैसेज, और आपके वर्कस्पेस द्वारा बनाया गया कोई भी टेम्पलेट। नंबर आपके वर्कस्पेस के स्वामित्व वाला होना चाहिए। इसे छोड़ने पर 422 WhatsAppSenderRequired लौटता है, और जिस नंबर से वर्कस्पेस भेज नहीं सकता उसके लिए 422 WhatsAppSenderNotFound लौटता है। बनाए गए टेम्पलेट को उसी WhatsApp Business Account पर भी होना चाहिए जिस पर नंबर है, अन्यथा सेंड 422 WhatsAppSenderWABAMismatch लौटाता है।

सर्विस मैसेज

• text: { "body": "..." }, अधिकतम 4,096 अक्षर। body में पहले URL का लिंक प्रीव्यू रेंडर करने के लिए "preview_url": true जोड़ें।
• image, video, audio, sticker, document: हर एक सेंड के समय WhatsApp द्वारा फ़ेच किया जाने वाला एक पब्लिक https URL लेता है (url), इसलिए signed URL को सेंड से ज़्यादा समय तक वैध रहना चाहिए। http URL सीधे अस्वीकार कर दिया जाता है। WhatsApp फ़ाइल को खुद फ़ेच करता है, इसलिए जो URL पहुँच से बाहर है, जो असमर्थित टाइप सर्व करता है, या जो फ़ाइल अपने टाइप की साइज़ सीमा से बड़ी है, वह स्वीकार होकर बाद में विफल होती है, संदेश के last_error पर media_rejected के साथ और description में WhatsApp का अपना कारण। image, video, और document एक वैकल्पिक caption भी लेते हैं; document एक वैकल्पिक filename भी लेता है; audio वॉइस-नोट रेंडरिंग के लिए एक वैकल्पिक voice फ़्लैग लेता है।
• location: { "latitude": ..., "longitude": ... } (दोनों आवश्यक, दशमलव डिग्री) साथ ही वैकल्पिक name और address।
• contact_cards: एक संदेश में शेयर किए गए अधिकतम पाँच contacts की array। हर कार्ड के name को formatted_name और कम से कम एक अन्य भाग (first_name, last_name, middle_name, prefix, या suffix) चाहिए; phone_numbers, emails, urls, और addresses प्रत्येक में अधिकतम दस एंट्री हो सकती हैं, और org तथा birthday (YYYY-MM-DD के रूप में) वैकल्पिक हैं। E.164 में phone_number उस कार्ड पर एक बटन देता है जो उससे चैट खोलता है।
• interactive: body text और टैप करने योग्य कुछ, छह प्रकारों में से एक में: reply buttons, एक list menu, एक link button, एक media carousel, या एक सिंगल बटन जो प्राप्तकर्ता से उनकी लोकेशन या फ़ोन नंबर माँगता है। Interactive messages हर प्रकार की वायर शेप, टैप से उत्पन्न रिप्लाइज़, और सीमाओं को कवर करता है।

{
  "to": "+16505551234",
  "from": "+13124495648",
  "text": { "body": "Your order shipped: https://example.com/track/A1B2C3", "preview_url": true }
}

संदेश को उद्धृत करना

{
  "to": "+16505551234",
  "from": "+13124495648",
  "in_reply_to_message_id": "wam_01kya19eknftrs2s6p82asmvnh",
  "text": { "body": "Yes, that slot is still free." }
}

टैग और मेटाडेटा

• tags: low-cardinality dimensions के लिए अधिकतम 20 structured { "name": ..., "value": ... } labels जिनके आधार पर आप फ़िल्टर और रिपोर्ट करते हैं (कोई कैम्पेन, कोई experiment variant)। नाम और वैल्यू ASCII अक्षर, अंक, अंडरस्कोर, और हाइफ़न लेते हैं; नाम अधिकतम 32 अक्षर और एक सेंड में अद्वितीय, वैल्यू अधिकतम 64। टैग से संदेश सूची फ़िल्टर करें (?tag=campaign या ?tag=campaign:launch-week), और Metrics पेज टैग के अनुसार डिलीवरी का विश्लेषण करता है।
• metadata: एक arbitrary JSON object, serialized रूप में अधिकतम 2 KB, प्रति-सेंड संदर्भ के लिए जिसे आपको फ़िल्टर dimension के रूप में नहीं चाहिए (कोई internal order ID, कोई session reference)।

{
  "tags": [{ "name": "campaign", "value": "order-confirmations" }],
  "metadata": { "order_id": "ord_8271" }
}

फ़ील्ड रेफ़रेंस

async मॉडल: 202 का मतलब

सुरक्षित रूप से फिर से प्रयास करना

रिप्लाई प्राप्त करना

लागत और बिलिंग

Note: a service message carries no Meta share until September 30th 2026, and neither does a utility template delivered inside an open customer service window. From October 1st 2026 Meta charges for both, except inside a 72-hour free entry point window, and with 1,000 free service messages per business phone number per month: October 2026 pricing changes.

• 202 पर, cost null है। कुछ भी प्राइस नहीं हुआ है।
• प्रोसेसिंग के बाद, transaction_amount सेट हो जाता है और amount उसके बराबर होता है। passthrough_amount null रहता है।
• एक applicable delivered या read रसीद के बाद, सफलतापूर्वक रिकॉर्ड किया गया Meta चार्ज passthrough_amount को पॉप्युलेट करता है, और amount रिकॉर्ड किए गए कम्पोनेंट्स को दर्शाता है।

अगले कदम

• सर्विस मैसेज: कस्टमर सर्विस विंडो के अंदर टेक्स्ट, मीडिया और इंटरैक्टिव कंटेंट भेजें
• टेम्पलेट: टेम्पलेट चुनें और उसके वेरिएबल सप्लाई करें
• WhatsApp मैसेज प्राप्त करना: रिप्लाई पढ़ें और इनबाउंड मीडिया फ़ेच करें
• मैसेज स्टेटस वेबहुक: डिलीवरी और फ़ेलियर अपडेट प्राप्त करें
• Idempotency: Idempotency-Key हेडर के साथ सुरक्षित रूप से फिर से प्रयास करें