सुविधा

तपाईंकै WhatsApp नम्बरमा WhatsApp API

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"
}
सन्देश पठाउँदै। आइडेम्पोटेन्सी की ऐच्छिक हो; उही कीसहित उही कल दोहोर्याउनुभयो भने दोस्रो पटक पठाउनुको सट्टा तपाईंले मूल सन्देशको ID फिर्ता पाउनुहुन्छ।

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 सँग कसरी जडान हुन्छ

बारम्बार सोधिने प्रश्नहरू

यो प्रयोग गर्न मलाई WhatsApp Business API चाहिन्छ?

चाहिँदैन। यो तपाईंकै WhatsApp नम्बरको अगाडि रहेको Spun को आफ्नै REST API हो, र नम्बर QR स्क्यानबाट लिङ्क गरिएको हुन्छ। कुनै Meta आवेदन, टेम्प्लेट स्वीकृतिको पालो वा प्रति सन्देश शुल्क छैन।

API की कसरी पाउने?

खाताको व्यवस्थापकले एपमा की बनाउनुहुन्छ, त्यसका स्कोप छान्नुहुन्छ, र चाहेमा म्याद सकिने मिति र IP अनुमति-सूची राख्नुहुन्छ। कच्चा की बनाउँदा एक पटक मात्र देखाइन्छ; त्यसपछि Spun ले त्यसको ह्यास मात्र राख्छ।

OpenAPI स्पेसिफिकेसन छ?

छ, /api/integrations/openapi.json मा प्रकाशित छ, र की बिना पढ्न मिल्छ, ताकि क्रेडेन्सियल हुनुअघि नै टुलहरूले क्लाइन्ट बनाउन सकून्।

उही अनुरोध दुई पटक पठाएँ भने के हुन्छ?

आइडेम्पोटेन्सी की पठाउनुहोस्। उही कीसहितको दोहोरो कलले दोस्रो सन्देश पठाउनुको सट्टा मूल सन्देश ID फर्काउँछ र प्रतिक्रियालाई आइडेम्पोटेन्ट भनी चिनो लगाउँछ। की बिना, दुई कल भनेको दुई सन्देश हो।

वेबहुक साँच्चै Spun बाटै आएको हो भनी कसरी जाँच्ने?

सदस्यतालाई साइनिङ सिक्रेट दिनुहोस् र सिग्नेचर हेडर जाँच्नुहोस्, जुन कच्चा अनुरोध बडीको HMAC-SHA256 हो, sha256 पछि hex डाइजेस्टको ढाँचामा। पार्स गर्नुअघि, तपाईंले पाएका ठ्याक्कै बाइटहरूमा आफैं हिसाब गरेर त्यससँग तुलना गर्नुहोस्।

तपाईंका ग्राहकले पहिल्यै सन्देश पठाउने नम्बरमा निर्माण गर्नुहोस्

स्कोपसहितका की, सानो र स्थिर इन्टरफेस, तपाईंलाई पोल गराउनुको सट्टा आफैं पुश गर्ने वेबहुक, र प्रति सन्देश मिटर छैन।

निःशुल्क सुरु गर्नुहोस्: 7 दिनसम्म सबै सुविधा

Spun का सबै सुविधाहरू हेर्नुहोस्