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 इत्यत्र जानता एव निराक्रियन्ते, यदि ताः वैधाः कुञ्जयः सन्ति तर्हि अपि। द्वयोः अवयवयोः अनुमोदन-नियमाः भिन्नाः, एकस्य कृते दत्ता कुञ्जी अन्यस्मिन् तूष्णीं प्रयोक्तुं न शक्यते।
सम्बद्धम्: कोड्-लेखनस्य स्थाने 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 इत्यस्य आधिकारिक्यः प्रत्याभूतयः अपि न।
- प्रतिकुञ्जि प्रतिनिमेषं 60 अनुरोधाः। बृहत्-कार्यं अभियानेषु कर्तव्यम्, यानि स्ववेगं समुचितं नियन्त्रयन्ति, न तु तीव्रे API-चक्रे।
- उपरि दत्ता अन्तबिन्दु-सूची एव अद्यतनः सम्पूर्णः अवयवः। यत् तस्यां नास्ति तत् न उपलभ्यते, कस्मिंश्चित् अप्रलेखिते अन्तबिन्दौ विश्वासः न कर्तव्यः।
- कुञ्जी सीमित-व्याप्तियुक्ता, किन्तु प्रत्येकस्य उपयोक्तुः पृथक् न। तां कार्यक्षेत्रस्य प्रमाणपत्ररूपेण गणयतु, प्रवेशाधिकारयुक्तः कश्चित् गच्छति चेत् तां परिवर्तयतु।
- ये कदापि सम्मतिं न दत्तवन्तः, तेभ्यः प्रेषणे WhatsApp तां सङ्ख्यां सीमितां करिष्यति, सन्देशः केन अपि मार्गेण गतः भवतु।
सम्बद्धम्: Spun WhatsApp इत्यनेन सह कथं संयुज्यते