सीधे मुख्य सामग्री पर जाएँ

मैसेज के प्रकार

नौ प्रकार के मैसेज, एक ही रिक्वेस्ट बॉडी

सेंड रिक्वेस्ट में एक चैनल, एक प्राप्तकर्ता और एक प्रकार बताया जाता है और कॉन्टेंट उसी प्रकार के नाम वाली key के नीचे होता है। यह पेज हर प्रकार, उसे बनाने वाली बॉडी और वह कहाँ सपोर्टेड है, दिखाता है।

सपोर्ट मैट्रिक्स

कौन-सा चैनल कौन-सा प्रकार स्वीकार करता है

चैनल capabilities में बताता है कि वह क्या स्वीकार करता है। ऐसा प्रकार भेजने पर जिसे चैनल सपोर्ट नहीं करता, 400 unsupported_message_type मिलता है और कोई शुल्क नहीं लगता।

चैनल के प्रकार के अनुसार मैसेज प्रकारों का सपोर्ट
प्रकारWhatsAppSMSSMS OTPTelegramMessengerInstagramTikTok
टेक्स्टtextसपोर्टेडसपोर्टेडसपोर्टेडसपोर्टेडसपोर्टेडसपोर्टेडसपोर्टेड
अटैचमेंटattachmentsसपोर्टेडसपोर्टेडसपोर्टेड नहींसपोर्टेडसपोर्टेडसपोर्टेडसपोर्टेड
टेम्पलेटtemplateसपोर्टेडसपोर्टेड नहींसपोर्टेड नहींसपोर्टेड नहींसपोर्टेड नहींसपोर्टेड नहींसपोर्टेड नहीं
रिप्लाई बटनbuttonसपोर्टेडसपोर्टेड नहींसपोर्टेड नहींसपोर्टेडसपोर्टेडसपोर्टेडसपोर्टेड
सूचीlistसपोर्टेडसपोर्टेड नहींसपोर्टेड नहींसपोर्टेड नहींसपोर्टेड नहींसपोर्टेड नहींसपोर्टेड नहीं
URL बटनcta_urlसपोर्टेडसपोर्टेड नहींसपोर्टेड नहींसपोर्टेड नहींसपोर्टेड नहींसपोर्टेड नहींसपोर्टेड नहीं
लोकेशनlocationसपोर्टेडसपोर्टेड नहींसपोर्टेड नहींसपोर्टेडसपोर्टेड नहींसपोर्टेड नहींसपोर्टेड नहीं
संपर्कcontactsसपोर्टेडसपोर्टेड नहींसपोर्टेड नहींसपोर्टेडसपोर्टेड नहींसपोर्टेड नहींसपोर्टेड नहीं
पोलpollसपोर्टेड नहींसपोर्टेड नहींसपोर्टेड नहींसपोर्टेडसपोर्टेड नहींसपोर्टेड नहींसपोर्टेड नहीं
type: "text"

टेक्स्ट

सादा टेक्स्ट, जिसे हर प्रकार का चैनल स्वीकार करता है। चैनल से लिंक प्रीव्यू दिखवाने के लिए preview_url सेट करें।

body: 1 से 4,096 वर्ण।

  • WhatsApp Business
  • SMS
  • SMS OTP
  • Telegram
  • Messenger
  • Instagram
  • TikTok
POST /v1/messages
{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "text",
  "text": {
    "body": "आपका ऑर्डर #1042 भेज दिया गया है। इसे यहाँ ट्रैक करें: https://example.com/t/1042",
    "preview_url": true
  },
  "reference": "order-1042"
}
type: "attachments"

अटैचमेंट

हर मैसेज में एक मीडिया आइटम, जिसे https URL से रेफ़र किया जाता है: इमेज, वीडियो, दस्तावेज़, ऑडियो, वॉइस या स्टिकर, वैकल्पिक कैप्शन के साथ।

ठीक एक आइटम। caption: 1,024 वर्ण तक।

  • WhatsApp Business
  • SMS
  • Telegram
  • Messenger
  • Instagram
  • TikTok
POST /v1/messages
{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "attachments",
  "attachments": [
    {
      "type": "image",
      "url": "https://example.com/receipts/1042.jpg",
      "caption": "ऑर्डर #1042 की आपकी रसीद।"
    }
  ]
}
type: "template"

टेम्पलेट

वेरिएबल वाला स्वीकृत WhatsApp टेम्पलेट। 24 घंटे की कस्टमर सर्विस विंडो के बाहर WhatsApp सिर्फ़ टेम्पलेट मैसेज ही स्वीकार करता है।

name और language चैनल के किसी स्वीकृत टेम्पलेट से मेल खाने चाहिए।

  • WhatsApp Business
POST /v1/messages
{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "template",
  "template": {
    "name": "order_out_for_delivery",
    "language": {
      "code": "en"
    },
    "components": [
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "प्रिया"
          },
          {
            "type": "text",
            "text": "#1042"
          },
          {
            "type": "text",
            "text": "18:00"
          }
        ]
      }
    ]
  }
}
type: "button"

रिप्लाई बटन

तीन तक क्विक रिप्लाई वाला मैसेज। टैप किए गए बटन की ID message.received इवेंट में आपके वेबहुक पर वापस आती है।

1 से 3 बटन। title: 20 वर्ण तक।

  • WhatsApp Business
  • Telegram
  • Messenger
  • Instagram
  • TikTok
POST /v1/messages
{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "button",
  "button": {
    "body": {
      "text": "दो लोगों के लिए आपकी टेबल आज रात 19:30 बजे के लिए बुक है। क्या आप अब भी आ पाएँगे?"
    },
    "action": {
      "buttons": [
        {
          "reply": {
            "id": "confirm",
            "title": "पुष्टि करें"
          }
        },
        {
          "reply": {
            "id": "reschedule",
            "title": "समय बदलें"
          }
        },
        {
          "reply": {
            "id": "cancel",
            "title": "बुकिंग रद्द करें"
          }
        }
      ]
    }
  }
}
type: "list"

सूची

एक बटन से खुलने वाला मेन्यू, जिसकी पंक्तियाँ शीर्षक वाले सेक्शन में बँटी होती हैं।

action.button: 20 वर्ण तक।

  • WhatsApp Business
POST /v1/messages
{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "list",
  "list": {
    "body": {
      "text": "आज कौन-सी टीम आपकी मदद कर सकती है?"
    },
    "action": {
      "button": "टीम चुनें",
      "sections": [
        {
          "title": "टीमें",
          "rows": [
            {
              "id": "orders",
              "title": "ऑर्डर",
              "description": "डिलीवरी, रिटर्न और रिफ़ंड"
            },
            {
              "id": "billing",
              "title": "बिलिंग",
              "description": "इनवॉइस और भुगतान के तरीके"
            },
            {
              "id": "technical",
              "title": "तकनीकी सपोर्ट",
              "description": "सेटअप और समस्या निवारण"
            }
          ]
        }
      ]
    }
  }
}
type: "cta_url"

URL बटन

एक बटन वाला मैसेज जो URL खोलता है; ट्रैकिंग पेज, भुगतान और साइन-इन लिंक के लिए।

हर मैसेज में एक बटन।

  • WhatsApp Business
POST /v1/messages
{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "cta_url",
  "cta_url": {
    "body": {
      "text": "आपका पार्सल रास्ते में है। इसे रियल टाइम में ट्रैक करें।"
    },
    "action": {
      "parameters": {
        "display_text": "ऑर्डर ट्रैक करें",
        "url": "https://example.com/t/1042"
      }
    }
  }
}
type: "location"

लोकेशन

नाम और पते वाला पिन, जो प्राप्तकर्ता के मैप ऐप में खुलता है।

latitude और longitude दशमलव डिग्री में होते हैं।

  • WhatsApp Business
  • Telegram
POST /v1/messages
{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "location",
  "location": {
    "latitude": 25.2048,
    "longitude": 55.2708,
    "name": "पिकअप पॉइंट",
    "address": "शेख़ ज़ायद रोड, दुबई"
  }
}
type: "contacts"

संपर्क

एक या ज़्यादा कॉन्टैक्ट कार्ड। ऐरे को जैसा है वैसा ही चैनल को फ़ॉरवर्ड कर दिया जाता है, इसलिए इसमें प्रोवाइडर का अपना कॉन्टैक्ट फ़ॉर्मैट इस्तेमाल होता है।

उदाहरण में WhatsApp का कॉन्टैक्ट फ़ॉर्मैट दिखाया गया है।

  • WhatsApp Business
  • Telegram
POST /v1/messages
{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "contacts",
  "contacts": [
    {
      "name": {
        "formatted_name": "सपोर्ट डेस्क",
        "first_name": "सपोर्ट"
      },
      "phones": [
        {
          "phone": "+971800123456",
          "type": "WORK"
        }
      ]
    }
  ]
}
type: "poll"

पोल

एक सवाल और कुछ विकल्पों वाला नेटिव Telegram पोल।

सिर्फ़ Telegram।

  • Telegram
POST /v1/messages
{
  "channel": "ch_4Tn8rW2yK6dF9sA1mQ5v",
  "to": "584201337",
  "type": "poll",
  "poll": {
    "question": "हम आपका ऑर्डर कब डिलीवर करें?",
    "options": [
      "सुबह, 09:00 से 12:00",
      "दोपहर, 12:00 से 17:00",
      "शाम, 17:00 से 21:00"
    ]
  }
}

हर प्रकार को सैंडबॉक्स में आज़माएँ

हर अकाउंट में हर चैनल प्रकार के लिए एक सैंडबॉक्स चैनल होता है। टेस्ट कुंजी से कोई भी सपोर्टेड प्रकार भेजें; न कुछ डिलीवर होगा, न कोई शुल्क लगेगा।