Events API

अपनी दुकान या ERP से ईवेंट भेजें ताकि WhatsApp पर ऑटोमेशन ट्रिगर हो सकें।

अपने सिस्टम को WPP Marketing को कार्ट, ऑर्डर, भुगतान, शिपिंग, रद्दीकरण या ग्राहक निर्माण की सूचना देनी हो तो Events API का उपयोग करें।

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

दस्तावेज़ खोलें API डेवलपर देखें

Endpoint https://api.wppmarketing.com/events/

POST /events/
Authorization: Bearer SEU_TOKEN

{
  "event": "order.paid",
  "source": "erp",
  "external_id": "10231",
  "customer": {
    "phone": "5511999999999"
  },
  "order": {
    "id": "10231",
    "total": 189.90
  }
}

फ्लो

आपकी प्रणाली घटना की सूचना देती है। WPP Marketing स्वचालन तय करता है।

Events API कस्टम स्टोर्स, ERP, बैकऑफिस और उन इंटीग्रेशन के लिए आदर्श है जिनके पास प्लग-एंड-प्ले कनेक्टर नहीं है।

01 इवेंट होता है

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

02 सिस्टम payload भेजता है

आपका बैकएंड टोकन, पहचानकर्ता, ग्राहक, मान और उपलब्ध लिंक के साथ इवेंट भेजता है।

03 नियम का मूल्यांकन किया जाता है

WPP Marketing यह जाँचता है कि क्या उस इवेंट और ग्राहक के लिए कोई सक्रिय ऑटोमेशन मौजूद है।

04 संदेश भेज दिया गया है

ग्राहक को रिकवरी, भुगतान, आदेश, शिपिंग, अभियान या बिक्रीोपरांत के लिए WhatsApp संदेश प्राप्त होते हैं।

समर्थित व्यावसायिक घटनाएँ।

अंतिम नामकरण और अनिवार्य फ़ील्ड्स को Events API दस्तावेज़ का पालन करना चाहिए।

POST cart.created

खरीदारी की नियत दर्ज करता है और प्रारंभिक फॉलो-अप ऑटोमेशन सक्षम करता है।

Carrinho

POST cart.abandoned

उपलब्ध होने पर रिमाइंडर और वापसी लिंक के साथ कार्ट रिकवरी सक्रिय करता है।

Recuperação

POST order.created

लेन-देन संबंधी संदेशों के लिए ऑर्डर बन गया या भुगतान की प्रतीक्षा में होने की सूचना देता है।

Pedido

POST order.paid

भुगतान की पुष्टि करता है और एक पुष्टिकरण संदेश, निर्देश और अगले कदम की अनुमति देता है।

Pagamento

POST order.shipped

हाथ से बननी वाली टिकटें कम करने के लिए शिपिंग अपडेट, ट्रैकिंग या लॉजिस्टिक्स स्थिति भेजता है।

Envio

POST order.cancelled

इस ईवेंट के लिए कॉन्फ़िगर की गई संचार सक्रिय करने के लिए ऑर्डर रद्द होने को लॉग करता है।

Cancelamento

POST customer.created

स्वागत, रिश्तों के प्रबंधन, टैग और अभियान के लिए संपर्क डेटाबेस को भरता है।

Cliente

सिफारिश किए गए डेटा

जितना बेहतर इवेंट होगा, ऑटोमेशन उतना ही बेहतर होगा।

Events API को ग्राहक, खरीद, राशि, स्थिति और संदेश के लिए उपयोगी लिंक पहचानने के लिए पर्याप्त डेटा प्राप्त होना चाहिए।

ग्राहक

फोन नंबर, नाम, ईमेल, देश और बाहरी पहचानकर्ता डुप्लिकेशन को हटाने और सेगमेंटेशन में मदद करते हैं।

ऑर्डर

नंबर, बाहरी ID, कुल, मुद्रा, स्थिति, भुगतान विधि और आइटम संदेश को अधिक उपयोगी बनाते हैं।

लिंक

चेकआउट, भुगतान, ट्रैकिंग या ऑर्डर पेज का उपयोग स्वचालित संदेशों में किया जा सकता है।

समविकृति (Idempotency)

external_id या order.id प्रदान करें और स्रोत को स्थिर रखें। डीडुप्लिकेशन खाता, सामान्यीकृत स्रोत, इवेंट प्रकार और बाहरी पहचानकर्ता पर विचार करता है। दोहराए गए इवेंट HTTP 200 लौटाते हैं जिसमें Duplicate event ignored संकेत होता है। यह endpoint Messaging API के Idempotency-Key हेडर का उपयोग नहीं करता।

प्रतिक्रिया

HTTP 200 यह पुष्टि करता है कि इवेंट संसाधित किया गया है, यह नहीं कि संदेश डिलिवर हुआ है। भेजने के लिए इवेंट के लिए सक्रिय ऑटोमेशन, वैध ग्राहक डेटा और कॉन्फ़िगर किया गया कनेक्शन आवश्यक है। संदेश की ट्रैकिंग रिपोर्ट और स्टेटस वेबहुक्स के जरिए करें।

सुरक्षा

events:write वाले क्रेडेंशियल बनाएं और सर्वर से इवेंट भेजें। टोकन को फ्रंटेंड और सार्वजनिक रिपॉजिटरी से बाहर रखें। फोन के लिए customer.phone का उपयोग करें और customer व order ऑब्जेक्ट्स को उदाहरण और OpenAPI कॉन्ट्रैक्ट के अनुसार भेजें।

क्या आप एक कस्टम स्टोर या ERP कनेक्ट करना चाहते हैं?

Events API का दस्तावेज़ खोलें और प्रोडक्शन इवेंट भेजने से पहले payloads, प्रमाणीकरण और उदाहरणों को सत्यापित करें।

Swagger खोलें