API डेवलपर

WhatsApp को आपके सिस्टम और ऐप्लिकेशन्स से जोड़ने के लिए API।

WPP Marketing की REST API का उपयोग करके CRM, ERP, ऐप्स और आंतरिक सिस्टम को WhatsApp के साथ एकीकृत करें। टेक्स्ट और मीडिया भेजें, संदेशों को क्वेरी करें और वेबहुक के जरिए डिलीवरी ट्रैक करें। अपने फ्लो को Official API से जोड़ने के लिए MCP का भी उपयोग करें। MCP के बारे में जानें.

दस्तावेज़ खोलें Events API देखें

Base URL https://api.wppmarketing.com

# autenticação
Authorization: Bearer SEU_TOKEN

# enviar mensagem pelo WhatsApp
POST /send-text
{
  "number": "5511999999999",
  "body": "Olá! Temos uma atualização para você."
}

कब उपयोग करें

जब आपका सिस्टम WhatsApp संदेश भेजना चाहिए तो मैसेजिंग API का उपयोग करें।

कॉन्टैक्ट शुरू करने के लिए अपने CRM का उपयोग करें, अपडेट भेजने के लिए अपने ERP का या ग्राहक को सूचित करने के लिए अपने ऐप का। कब भेजना है यह लॉजिक आपके सिस्टम में रहती है; API खाते में कॉन्फ़िगर किए गए कनेक्शन के जरिए भेजने को अंजाम देती है। तैयार व्यावसायिक ऑटोमेशन के लिए Events API का उपयोग करें।

01 प्रमाणित करें

Developers > Credentials में messages:write इंटीग्रेशन के लिए एक टोकन बनाएँ। इसे बनाते समय कॉपी करें, अपने बैकएंड में सुरक्षित रखें और भेजने से पहले डैशबोर्ड में WhatsApp कनेक्शन कॉन्फ़िगर करें।

02 संदेश भेजें

टेक्स्ट के लिए POST /send-text या मीडिया के लिए POST /send-media का उपयोग करें। आधिकारिक कनेक्शन में, टेक्स्ट और इमेज कॉन्फ़िगर किए गए टेम्पलेट्स का उपयोग करते हैं; ऑडियो, वीडियो और डॉक्यूमेंट्स के लिए पिछले 24 घंटों में ग्राहक की प्राप्त संदेश की आवश्यकता होती है।

03 संदेश देखें

HTTP 200 स्वीकृति इंगित करता है, डिलीवरी नहीं। messages:read के साथ GET /messages का उपयोग करें और चैनल के उपलब्ध स्टेटस जांचें।

04 वेबहुक्स ट्रैक करें

HTTPS URL दर्ज करें और डैशबोर्ड में इवेंट्स सक्षम करें। GET /webhooks पर प्रयासों को क्वेरी करने के लिए webhooks:read का उपयोग करें; यह endpoint डिलीवरी सूचीबद्ध करता है, सब्सक्रिप्शन रजिस्टर नहीं करता।

टोकन से लेकर पहला शामिल शिपमेंट तक।

अपने सर्वर पर SEU_TOKEN को क्रेडेंशियल से और नंबर को परीक्षण के लिए अधिकृत प्राप्तकर्ता से बदलें। प्रत्येक भेजने के लिए एक अद्वितीय कुंजी का उपयोग करें और केवल उसी अनुरोध को दोहराने पर वही कुंजी पुन: उपयोग करें।

HTTP स्थिति और प्रतिक्रिया बॉडी की जाँच करें। 401 के लिए, टोकन और उसकी वैधता की समीक्षा करें; 403 के लिए, स्कोप्स और खाते की शर्तें जाँचें। 409 में, जाँचें कि क्या कुंजी पहले किसी अन्य सामग्री के साथ उपयोग की जा चुकी है। 429 में, फिर से प्रयास करने से पहले Retry-After का पालन करें।

इसके बाद messages:read के साथ GET /messages देखें या कॉन्फ़िगर किए गए वेबहुक्स की निगरानी करें। डिलीवरी की पुष्टि चैनल की प्रतिक्रिया पर निर्भर करती है।

cURLPOST /send-text

curl --request POST 'https://api.wppmarketing.com/send-text' \
  --header 'Authorization: Bearer SEU_TOKEN' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: pedido-10231-aviso-1' \
  --data '{"number":"5511999999999","body":"Olá! Seu pedido foi atualizado."}'

टेक्स्ट, मीडिया, इतिहास और भेजे गए संदेशों की ट्रैकिंग।

REST endpoints का उपयोग करके WhatsApp को अपने ऐप्लिकेशन के साथ इंटीग्रेट करें। WPP Marketing API खाते में कॉन्फ़िगर किए गए कनेक्शन का उपयोग करती है; Official WhatsApp API के साथ काम करने के लिए उस कनेक्शन को डैशबोर्ड में कॉन्फ़िगर करें। प्रत्येक ऑपरेशन के फॉर्मेट, स्कोप, सीमाएँ और रिस्पॉन्स के लिए OpenAPI देखें।

POST /send-text

WhatsApp नंबर पर एक टेक्स्ट संदेश भेजता है।

Texto

POST /send-media

सार्वजनिक HTTPS URL के जरिए छवि, ऑडियो, वीडियो या दस्तावेज़ भेजें, प्रारूप और कनेक्शन की शर्तों के अनुसार। ऑडियो के लिए वही endpoint उपयोग होता है।

Mídia

GET /messages

भेजे गए संदेशों का इतिहास स्थिति और पेजिनेशन के साथ देखें।

Histórico

GET /webhooks

इवेंट, HTTP परिणाम, प्रयास और पेजिनेशन के साथ वेबहुक डिलीवरी देखें।

Webhooks

DOC Swagger / OpenAPI

अन interactive दस्तावेज़ीकरण जिसमें अनुबंध, उदाहरण, अनिवार्य फ़ील्ड और अपेक्षित प्रतिक्रियाएँ शामिल हैं.

Docs

तकनीकी पृथक्करण

इंटीग्रेशन के प्रत्येक चरण के लिए सही फ़ीचर चुनें।

Messaging API से संदेश भेजें, Events API के साथ व्यावसायिक ऑटोमेशन ट्रिगर करें और webhooks के जरिए कॉलबैक प्राप्त करें। आपकी एप्लिकेशन आवश्यक फ़्लो के अनुसार इन सुविधाओं को संयोजित कर सकती है।

החיבור הרשמי הוא ערוץ התקשורת; ממשק ה‑API של WPP Marketing הוא הממשק שבו משתמש המערכת שלכם. עיינו בדרישות ב־ WhatsApp आधिकारिक API और सह-अवस्थिति.

API डेवलपर

आपकी प्रणाली WPP Marketing को टेक्स्ट या मीडिया संदेश भेजने और संदेश इतिहास व webhook डिलीवरियों को query करने के लिए कॉल करती है।

Events API

आपकी प्रणाली व्यावसायिक घटनाएँ भेजती है जैसे आदेश बनाया गया, भुगतान स्वीकृत, शिपमेंट या परित्यक्त कार्ट।

उपलब्ध इवेंट्स और ऑटोमेशन को समझें

स्थिति वेबहुक्स

WPP Marketing आपके द्वारा प्रदान किए गए URL पर निर्माण, डिलीवरी, पढ़ा गया और त्रुटि जैसे मानकीकृत ईवेंट भेजता है।

वापसी घटनाएँ और डिलीवरी ट्रैकिंग देखें

डॉक्यूमेंटेशन और Swagger

उत्पादन में डालने से पहले payloads, प्रमाणीकरण और प्रतिक्रियाओं को सत्यापित करने के लिए इंटरैक्टिव दस्तावेज़ीकरण का उपयोग करें।

सुरक्षा

टोकन बैकएंड में ही रखने चाहिए। सार्वजनिक पृष्ठों, फ्रंट-एंड ऐप्स या रिपॉजिटरी में क्रेडेंशियल्स उजागर न करें।

उत्पादन

/send-text और /send-media में, Idempotency-Key आपको उसी अनुरोध को सफल प्रतिक्रिया के साथ 48 घंटे तक दोहराने की अनुमति देता है। किसी अलग सामग्री के साथ कुंजी का पुन: उपयोग करने पर 409 लौटता है। बिना कुंजी के, कॉल को दोहराने से भेजना डुप्लिकेट हो सकता है। RateLimit और Retry-After हेडरों का पालन करें; अनुरोध सीमा योजना की कोटा से अलग होती है।

प्रत्येक एकीकरण के लिए एक क्रेडेंशियल, आवश्यक अनुमतियों के साथ।

डैशबोर्ड में टोकन को एक नाम दें, स्कोप चुनें और वैकल्पिक समाप्ति निर्धारित करें। पूर्ण टोकन निर्माण के समय केवल एक बार दिखाई देता है। सूची से आप अंतिम उपयोग, समाप्ति और आवश्यक होने पर पहुंच रद्द कर सकते हैं।

किसी क्रेडेंशियल को बदलते समय अपने सर्वर पर सीक्रेट अपडेट करें और पिछले क्रेडेंशियल को रद्द करें। कभी भी WhatsApp प्रदाता के टोकन का उपयोग API क्रेडेंशियल की जगह न करें।

messages:write

टेक्स्ट और मीडिया भेजने की अनुमति देता है। केवल उन एकीकरणों को दें जिन्हें भेजना शुरू करने की आवश्यकता है।

messages:read / webhooks:read

ये क्रमशः संदेशों का इतिहास और webhook डिलिवरियाँ देखने की अनुमति देते हैं। एक भेजने की क्रेडेंशियल को ये अनुमतियाँ स्वचालित रूप से नहीं मिलतीं।

events:write

Events API के माध्यम से खाते में कॉन्फ़िगर की गई ऑटोमेशन में ग्राहक, कार्ट और ऑर्डर भेजने की अनुमति देता है।

app:read · GET /app-context

निदान के लिए संग्रहीत सेटिंग्स, automations, गणना और हाल के लॉग की जाँच करता है। इसमें व्यक्तिगत डेटा और संदेशों की सामग्री शामिल हो सकती है: केवल अधिकृत इंटीग्रेशन और सपोर्ट को ही अनुमति दें। यह क्वेरी प्रदाता से लाइव कनेक्शन की जाँच नहीं करती।

MCP और WhatsApp की आधिकारिक API।

WPP Marketing के MCP के साथ अपनी WhatsApp संचालन में AI उपकरण कनेक्ट करें। अपने असिस्टेंट्स और एजेंट्स के फ्लो में WhatsApp को जोड़ें, संदेश कनेक्शन के रूप में Official API का उपयोग करते हुए।

MCP आपके एजेंट्स के फ्लो को इंटीग्रेशन से जोड़ता है; मैसेजिंग API भेजने का कार्य करती है और आधिकारिक कनेक्शन WhatsApp के नियमों का पालन करता है। इससे MCP एक नेटिव चैटबॉट नहीं बनता और न ही यह अकाउंट सेटअप की जगह लेता है। टीम आपके उपयोग केस के लिए इंटीग्रेशन की कार्रवाइयों और आवश्यकताओं का मार्गदर्शन करती है।

आपके संचालन के साथ एकीकरण

AI टूल्स और WhatsApp के बीच एकीकरण मार्ग के रूप में MCP का उपयोग करें, अपने सिस्टम और टीम के फ्लोज़ को पूरक करते हुए।

अपनी MCP एकीकरण योजना बनाएं

हमारी टीम से उस AI टूल के बारे में बात करें जिसे आप उपयोग करते हैं और वे क्रियाएँ जो आप WhatsApp से जोड़ना चाहते हैं। अपनी ऑपरेशन के लिए आवश्यकताएँ और उपयुक्त स्कोप देखें।

MCP एकीकरण के बारे में बात करें

क्या आप अपना सिस्टम WPP Marketing के साथ एकीकृत करने के लिए तैयार हैं?

Messaging API के endpoints, payload उदाहरण, bearer token प्रमाणीकरण और अपेक्षित प्रतिक्रियाएँ देखने के लिए Swagger खोलें। दुकान की घटनाओं और डिलीवरी फीडबैक के लिए भी देखें Events API और Webhooks de status.

Swagger खोलें