वैशिष्ट्य

तुमच्या स्वतःच्या WhatsApp नंबरवर एक WhatsApp API

तुमची टीम ज्या नंबरवरून शेअर्ड WhatsApp इनबॉक्समध्ये उत्तर देते, त्याच नंबरवर Spun तुम्हाला एक REST API देते: टेक्स्ट आणि मीडिया पाठवा, संदेश वाचा, संपर्क आणि लेबल्स अपडेट करा, आणि वेबहुक्स सबस्क्राइब करा. तुम्ही 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"
}
एक संदेश पाठवणे. आयडेम्पोटन्सी की ऐच्छिक आहे; तोच कॉल त्याच की सोबत पुन्हा केला, तर दुसऱ्यांदा संदेश न जाता तुम्हाला मूळ संदेशाचा id परत मिळतो.

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 शी कसे जोडले जाते

वारंवार विचारले जाणारे प्रश्न

हे वापरण्यासाठी मला WhatsApp Business API लागेल का?

नाही. हा Spun चा स्वतःचा REST API आहे, जो QR स्कॅनने लिंक केलेल्या तुमच्या स्वतःच्या WhatsApp नंबरसमोर काम करतो. Meta कडे कोणताही अर्ज नाही, टेम्पलेट मंजुरीची रांग नाही आणि प्रति संदेश शुल्क नाही.

API की कशी मिळते?

खाते व्यवस्थापक अॅपमध्ये की तयार करतो, तिचे स्कोप निवडतो, आणि हवे असल्यास एक्सपायरी तारीख आणि IP अलाउलिस्ट सेट करतो. मूळ की तयार करताना फक्त एकदाच दाखवली जाते; त्यानंतर Spun तिचा फक्त हॅश साठवते.

OpenAPI स्पेक आहे का?

हो, ते /api/integrations/openapi.json वर प्रकाशित केले आहे, आणि की शिवाय वाचता येते, म्हणजे क्रेडेन्शियल्स तयार होण्याआधीच टूल्स क्लायंट जनरेट करू शकतात.

एकच रिक्वेस्ट दोनदा पाठवली तर काय होते?

आयडेम्पोटन्सी की पाठवा. त्याच की सोबत पुन्हा केलेला कॉल मूळ संदेशाचा id परत देतो आणि दुसरा संदेश पाठवण्याऐवजी रिस्पॉन्सला आयडेम्पोटंट म्हणून चिन्हांकित करतो. की नसेल तर दोन कॉल म्हणजे दोन संदेश.

वेबहुक खरोखर Spun कडूनच आला आहे हे कसे तपासायचे?

सबस्क्रिप्शनला एक साइनिंग सीक्रेट द्या आणि सिग्नेचर हेडर तपासा, जो रॉ रिक्वेस्ट बॉडीचा HMAC-SHA256 असतो, sha256 नंतर हेक्स डायजेस्ट अशा स्वरूपात. पार्स करण्याआधी, तुम्हाला मिळालेल्या नेमक्या त्याच बाइट्सवर तुम्ही स्वतः केलेल्या गणनेशी तो जुळवून पहा.

तुमचे ग्राहक आधीपासून ज्या नंबरवर संदेश पाठवतात, त्यावरच तयार करा

स्कोप असलेल्या की, लहान आणि स्थिर इंटरफेस, तुम्हाला पोल करायला न लावता स्वतः पुश करणारे वेबहुक्स, आणि प्रति संदेश कोणतेही मीटर नाही.

मोफत सुरू करा: 7 दिवस सर्व काही

Spun ची सर्व वैशिष्ट्ये पहा