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