Spun तुसेंगी उसै नंबर पर इक REST API दिंदा ऐ जिस पर तुंʼदी टीम अपने सांझे WhatsApp इनबाक्स च जवाब दिंदी ऐ: टैक्स्ट ते मीडिया भेजो, सनेहां पढ़ो, संपर्क ते लेबल अपडेट करो, ते वैबहुक सब्सक्राइब करो। एह् उस नंबर दे अग्गें बैठदा ऐ जेह्ड़ा तुसें QR स्कैन कन्नै लिंक कीता ऐ, इस करी इसगी Business API दी लोड़ नेईं ते एह् प्रति सनेहा कोई फीस नेईं लैंदा।
WhatsApp API थमां जेह्ड़े कम्म करोआए जंदे न, उंʼदे चा मते सारे चार गल्लें पर आई मुकदे न: सनेहा भेजना, किश तुपना, कोई रिकार्ड बदलना, ते किश होने पर खबर पाना। Spun एह् चारै कम्म सादे HTTP पर उसै नंबर आस्तै दिंदा ऐ जिस पर तुंʼदी टीम इनबाक्स च जवाब दिंदी ऐ, ते ऑथेंटिकेशन उस कुंजी कन्नै होंदा ऐ जेह्ड़ी तुस आपूं बनांदे ओ ते ठीक उन्ने गै स्कोप तगर सीमत करदे ओ जिन्ने दी एकीकरण गी लोड़ ऐ।
एह् पेज इसदा अमली रूप ऐ: एंडपॉइंट केह्ड़े न, ऑथेंटिकेशन ते स्कोप कियां कम्म करदे न, कॉल करदे बेल्लै जेकर तुंʼदी WhatsApp लाइन ऑफलाइन होऐ तां केह् होंदा ऐ, ते मशीन आसेआ पढ़ेआ जाई सकने आह्ला कॉन्ट्रैक्ट कुʼत्थै ऐ।
कुंजियां, स्कोप ते लीक होने पर नुकसान दा दायरा
ऑथेंटिकेशन इक बेयरर टोकन कन्नै होंदा ऐ। तुस ऐप च इक कुंजी बनांदे ओ, ओह् तुसेंगी सिर्फ इक बारी दस्सी जंदी ऐ, ते हर रिक्वेस्ट उसगी Authorization हेडर च लेई जंदी ऐ। Spun कुंजी दा सिर्फ इक हैश स्टोर करदा ऐ, इस करी गुआची दी कुंजी बापस नेईं मिली सकदी, सिर्फ बदली जाई सकदी ऐ।
जिस हिस्से पर इक मिंट लाना फायदेमंद ऐ, ओह् ऐ स्कोपिंग। कुंजी दा मतलब सिर्फ "खाते दा एक्सेस" नेईं: उसदे कन्नै स्कोप दी इक लिस्ट होंदी ऐ, ते हर एंडपॉइंट उस खास स्कोप दी जांच करदा ऐ जिसदी उसगी लोड़ ऐ। सिर्फ read_contacts आह्ली कुंजी सनेहा नेईं भेजी सकदी। सिर्फ send_message आह्ली कुंजी तुंʼदी संपर्क लिस्ट इक-इक करियै नेईं कड्ढी सकदी। स्कोप दे अलावा, कुंजी पर इक मियाद खत्म होने दी तरीक ते इक IP अलाउलिस्ट बी लग्गी सकदी ऐ, तां जे कुसै पक्के पते आह्ले सर्वर गी दित्ती गेदी कुंजी जिʼयां गै कुतै होर थमां बरती जा, उसै पल कम्म करना बंद करी देऐ।
- send_message च टैक्स्ट ते मीडिया भेजना, ते कतार च रक्खे गेदे सनेहे दी जानकारी बापस पढ़ना शामल ऐ।
- read_contacts, read_messages ते read_labels पढ़ने आह्ला हिस्सा न, ते इʼनें गी बक्ख-बक्ख दित्ता जाई सकदा ऐ।
- manage_contacts ते manage_labels च बनाना, अपडेट करना ते लेबल लाना शामल ऐ।
- check_phone दसदा ऐ जे कुसै नंबर तगर WhatsApp पर पुज्जेआ जाई सकदा ऐ जां नेईं।
- manage_webhooks वैबहुक सब्सक्रिप्शन बनांदा ऐ, उंʼदी लिस्ट दसदा ऐ ते उʼनें गी डिलीट करदा ऐ।
रिक्वेस्ट
curl -X POST https://api.spun.com/api/integrations/send-message \
-H "Authorization: Bearer wap_0f3c9a1d7b524e86a1c05d9e2f7b48ac" \
-H "Content-Type: application/json" \
-d '{
"to": "+14155550142",
"text": "Your appointment is confirmed for Thursday at 10:00.",
"idempotency_key": "booking-8871"
}'रिस्पॉन्स
HTTP/1.1 200 OK
Content-Type: application/json
{
"success": true,
"message_id": "yq0Zt9C1sK2mfE7x"
}Spun MCP सर्वर आस्तै बनाई गेदियां कुंजियां इस API पर जानी-बुज्झियै नकारी दित्तियां जंदियां न, भामें ओह् जायज कुंजियां होन। दौनें इंटरफेसें दे मंजूरी दे नियम बक्खरे न, ते इक आस्तै जारी कीती गेदी कुंजी चुपचाप दूए पर नेईं बरती जाई सकदी।
WhatsApp API दे एंडपॉइंट असल च केह्-केह् कवर करदे न
इंटरफेस जानी-बुज्झियै छोटा ते स्थिर रक्खेआ गेदा ऐ, एह् प्रोडक्ट दी हर चीज दी पूरी नकल नेईं। एह् इस आस्तै ऐ तां जे कोई बाह्रला सिस्टम ओह् कम्म करी सकै जेह्ड़े बाह्रले सिस्टमें गी सच्चें गै करने पौंदे न।
- भेजना: इक टैक्स्ट सनेहा, जां URL जां base64 दे रूप च मीडिया, वैकल्पिक कैप्शन कन्नै।
- संपर्क: संपर्क बनाओ, कुसै संपर्क गी अपडेट करो, ते कर्सर पेजिनेशन कन्नै संपर्कें दी लिस्ट दिक्खो।
- लेबल: वर्कस्पेस दे लेबलें दी लिस्ट दिक्खो, कुसै गल्लबात पर लेबल लाओ, लेबल हटाओ।
- सनेहां: कर्सर पेजिनेशन कन्नै सनेहाएं दी लिस्ट, कुसै डेटा वेयरहाउस जां CRM च सिंक करने आस्तै।
- फोन जांच: कुसै नंबर दे आसपास लिस्ट बनाने शा पैह्लें पक्का करो जे ओह् WhatsApp पर ऐ।
- कतार: लाइन ऑफलाइन होने करी कतार च रक्खेआ गेदा कोई सनेहा दिक्खो।
- वैबहुक: सब्सक्रिप्शन बनाओ, उंʼदी लिस्ट दिक्खो ते उʼनें गी डिलीट करो।
मशीन आसेआ पढ़ेआ जाई सकने आह्ला कॉन्ट्रैक्ट /api/integrations/openapi.json पर प्रकाशत ऐ ते उसगी पढ़ने आस्तै कुसै कुंजी दी लोड़ नेईं, इस करी n8n नोड लिखने आह्ला, Zapier ऐप बनाने आह्ला जां तुंʼदा अपना जनरेटर कुसै गी क्रेडेंशियल जारी होने शा पैह्लें गै स्पेक लेई सकदा ऐ।
जदूं WhatsApp लाइन ऑफलाइन होऐ तां केह् होंदा ऐ
इʼऐ हिस्सा लोकें गी हरान करदा ऐ, इस करी इसगी साफ-साफ दस्सना ठीक ऐ। Spun इक लाइव WhatsApp सेशन राहें भेजदा ऐ, ते लाइव सेशन ठीक उसै सकिंट बंद होई सकदा ऐ जदूं तुंʼदा कोड कॉल करदा ऐ। API इसदे उलट दखावा नेईं करदा, ते जानी-बुज्झियै टैक्स्ट ते मीडिया कन्नै बक्ख-बक्ख बर्ताव करदा ऐ।
ऑफलाइन लाइन पर टैक्स्ट भेजने पर एरर दे बजाए 202 मिलदा ऐ, कन्नै इक कतार id। सनेहा रोकियै रक्खेआ जंदा ऐ ते लाइन परतियै जुड़ने पर पुजाया जंदा ऐ, ते तुस उसदा नतीजा जानने आस्तै कतार एंडपॉइंट गी पोल करी सकदे ओ। ऑफलाइन लाइन पर मीडिया भेजने पर इसदे बजाए कॉन्फ्लिक्ट मिलदा ऐ, ते किश बी नेईं भेजेआ जंदा। एह् फर्क जानी-बुज्झियै ऐ: कतार सनेहाएं गी टैक्स्ट दे रूप च भेजदी ऐ, इस करी कतार च रक्खी गेदी इमेज बिना तस्वीर दे सिर्फ कैप्शन बनियै पुजदी। खुल्लियै फेल होना बेहतर नतीजा ऐ, ते अग्गें केह् करना ऐ एह् तुंʼदा रीट्राई लॉजिक तैऽ करदा ऐ।
रेट लिमिट हर कुंजी आस्तै 60 रिक्वेस्ट प्रति मिंट ऐ, ते हर रिस्पॉन्स पर स्टैंडर्ड रेट-लिमिट हेडर होंदे न, तां जे क्लाइंट कुसै अनचाहे 429 दे बजाए हेडर दिक्खियै रफ्तार घट्ट करी सकै।
वैबहुक: पोलिंग दे बजाए खबर पाना
टाइमर पर सनेहा एंडपॉइंट गी बार-बार पोल करना गल्लबात आस्तै सही तरीका नेईं, इस करी API आपूं पुश करी सकदा ऐ। तुस इक URL ते ओह् इवेंट रजिस्टर करदे ओ जेह्ड़े तुंʼदे कम्म दे न, ते जिʼयां-जिʼयां ओह् होंदे न, Spun उस URL पर इक JSON बॉडी पोस्ट करदा ऐ।
हर डिलीवरी दे हेडरें च इवेंट दा नांऽ ते इक यूनिक डिलीवरी id होंदी ऐ, ते जेकर सब्सक्रिप्शन च साइनिंग सीक्रेट ऐ तां ठीक उसै बॉडी दा HMAC-SHA256 सिग्नेचर बी। पेलोड पर भरोसा करने शा पैह्लें सिग्नेचर दी जांच करो: इʼऐ इक चीज तुंʼदे एंडपॉइंट गी हर उस माह्नू शा बक्ख करदी ऐ जिसगी URL दा पता लग्गी जा। सीक्रेट सिर्फ इक बारी, सब्सक्रिप्शन बनांदे बेल्लै, बापस दित्ता जंदा ऐ, फ्ही कदें नेईं।
- सनेहा इवेंट, औने आह्ले ते जाने आह्ले।
- संपर्क बनाया गेआ, अपडेट कीता गेआ ते डिलीट कीता गेआ।
- लेबल असाइन कीता गेआ।
- चैट फ्लो पूरा होआ, कतार आह्ला सनेहा प्रोसेस होआ, लीड क्वालिफाई होई।
- गल्लबात बंद होई, काल पूरी होई, ते पाइपलाइन दा चरण बदलेआ।
सरबंधत: Spun गी Zapier ते Make कन्नै जोड़ना · Spun गी n8n कन्नै जोड़ना · हेल्पडेस्क जोड़ना: Zendesk, Zoho Desk, Freshdesk, HubSpot Service Hub, Jira
सीमां ते ईमानदार चेतावनियां
- एह् WhatsApp Business API नेईं ऐ। एह् तुंʼदे लिंक कीते गेदे नंबर दे अग्गें Spun दा अपना API ऐ, इस करी नां ते कोई सनेहा टेम्पलेट मंजूर करोआना पौंदा ऐ, नां प्रति सनेहा फीस लगदी ऐ, ते इʼयां गै Meta दी कोई अधिकारक गारंटी बी नेईं।
- हर कुंजी आस्तै सट्ठ रिक्वेस्ट प्रति मिंट। बल्क कम्म अभियानें च होना चाहिदा, जेह्ड़े अपनी रफ्तार आपूं ठीक चाल्ली संभालदे न, कुसै तेज API लूप च नेईं।
- उप्पर दित्ती गेदी एंडपॉइंट लिस्ट गै अज्ज दा पूरा इंटरफेस ऐ। जेह्ड़ा इस च नेईं, ओह् उपलब्ध नेईं, ते कुसै बी बिना दस्तावेज आह्ले एंडपॉइंट पर भरोसा नेईं करना चाहिदा।
- कुंजी स्कोप आह्ली होंदी ऐ, पर हर बरतूनी आस्तै बक्खरी नेईं। इसगी वर्कस्पेस दे क्रेडेंशियल आंह्गर समझो ते जदूं एक्सेस आह्ला कोई माह्नू छोड़ी जा तां इसगी बदली देओ।
- जिʼनें लोकें कदें सहमति नेईं दित्ती, उʼनें गी सनेहां भेजने पर WhatsApp नंबर गी सीमत करी देग, भामें सनेहा कुसै बी रस्ते गेआ होऐ।