Spun अहाँकेँ ओही नंबर पर एकटा REST API दैत अछि जाहि पर अहाँक टीम अपन साझा WhatsApp इनबॉक्समे जवाब दैत अछि: टेक्स्ट आ मीडिया पठाउ, संदेश पढ़ू, संपर्क आ लेबल अपडेट करू, आ वेबहुक सब्सक्राइब करू। ई ओहि नंबरक आगू काज करैत अछि जकरा अहाँ QR स्कैन कऽ लिंक कएने छी, तेँ एकरा लेल Business API क आवश्यकता नहि अछि आ कोनो प्रति-संदेश शुल्क नहि लगैत अछि।
WhatsApp API सँ जे काज कराओल जाइत अछि, ओहिमे सँ बेसी चारि बात पर आबि कऽ रुकि जाइत अछि: संदेश पठाएब, किछु खोजब, कोनो रिकॉर्ड बदलब, आ किछु भेला पर सूचना पाएब। Spun ई चारू काज साधारण HTTP पर ओही नंबरक लेल दैत अछि जाहि पर अहाँक टीम इनबॉक्समे जवाब दैत अछि, आ ऑथेंटिकेशन ओहि कुंजीसँ होइत अछि जे अहाँ स्वयं बनबैत छी आ ठीक ओतबे स्कोप धरि सीमित करैत छी जतबाक एकीकरणकेँ आवश्यकता छैक।
ई पृष्ठ एकर व्यावहारिक रूप अछि: एंडपॉइंट कोन-कोन अछि, ऑथेंटिकेशन आ स्कोप कोना काज करैत अछि, कॉल करबाक समय जँ अहाँक WhatsApp लाइन ऑफलाइन हो तँ की होइत अछि, आ मशीनसँ पढ़ल जाए सकय बला कॉन्ट्रैक्ट कतय भेटैत अछि।
कुंजी, स्कोप, आ लीक भेला पर नुकसानक दायरा
ऑथेंटिकेशन एकटा bearer टोकन अछि। अहाँ ऐपमे एकटा कुंजी बनबैत छी, ओ अहाँकेँ मात्र एक बेर देखाओल जाइत अछि, आ हर रिक्वेस्ट ओकरा 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 पर जानि-बूझि कऽ अस्वीकार कएल जाइत अछि, भले ओ वैध कुंजी हो। दुनू इंटरफेसक अनुमोदनक नियम अलग अछि, आ एकक लेल जारी कएल कुंजी चुपचाप दोसर पर उपयोग नहि भऽ सकैत अछि।
संबंधित: कोड लिखबाक बदला एकटा AI सहायक जोड़ब
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 अहाँक नंबर सीमित कऽ देत, चाहे संदेश कोनो रास्तासँ गेल हो।
संबंधित: Spun WhatsApp सँ कोना जुड़ैत अछि