خاصيت

توهان جي پنهنجي WhatsApp نمبر تي هڪ WhatsApp API

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"
}
هڪ پيغام موڪلڻ. آئيڊيمپوٽنسي ڪنجي اختياري آهي؛ ساڳي ڪال ساڳي ڪنجي سان ٻيهر ڪريو ته ٻيو پيغام موڪلڻ بدران توهان کي اصل پيغام جي 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 جي تيز لوپ ۾ نه.
  • مٿي ڏنل اينڊ پوائنٽن جي لسٽ اڄ جو پورو API آهي. جيڪو ان ۾ ناهي اهو کليل ناهي، ۽ ڪنهن به غير دستاويزي اينڊ پوائنٽ تي ڀروسو نه ڪرڻ گھرجي.
  • ڪنجي اسڪوپ سان محدود آهي پر هر يوزر لاءِ الڳ ناهي. ان کي ورڪ اسپيس جي رسائي جي سند سمجهو ۽ جڏهن رسائي رکندڙ ڪو ماڻهو ڇڏي وڃي ته ان کي بدلايو.
  • جن ماڻهن ڪڏهن اجازت نه ڏني، انهن ڏانهن موڪلڻ سان WhatsApp نمبر کي محدود ڪري ڇڏيندو، پيغام ڪهڙي به رستي سان ويو هجي.

لاڳاپيل: Spun ڪيئن WhatsApp سان ڳنڍجي ٿو

اڪثر پڇيا ويندڙ سوال

ڇا هن کي استعمال ڪرڻ لاءِ مون کي WhatsApp Business API جي ضرورت آهي؟

نه. هي Spun جو پنهنجو REST API آهي جيڪو توهان جي پنهنجي WhatsApp نمبر جي اڳيان آهي، QR اسڪين سان لنڪ ٿيل. نه Meta وٽ درخواست، نه ٽيمپليٽ جي منظوري جي قطار ۽ نه في پيغام فيس.

API ڪنجي ڪيئن ملي ٿي؟

اڪائونٽ جو مئنيجر ايپ ۾ ڪنجي ٺاهي ٿو، ان جا اسڪوپ چونڊي ٿو، ۽ چاهي ته ختم ٿيڻ جي تاريخ ۽ IP اجازت لسٽ لڳائي ٿو. اصل ڪنجي ٺاهڻ وقت رڳو هڪ ڀيرو ڏيکاري وڃي ٿي؛ ان کان پوءِ Spun رڳو ان جو هيش محفوظ رکي ٿو.

ڇا OpenAPI اسپيڪ موجود آهي؟

ها، /api/integrations/openapi.json تي شايع ٿيل، ۽ ڪنجي کان سواءِ پڙهي سگھجي ٿو ته جيئن اوزار رسائي جون سندون هجڻ کان اڳ ئي ڪلائنٽ ٺاهي سگھن.

جيڪڏهن آئون ساڳي درخواست ٻه ڀيرا موڪليان ته ڇا ٿيندو؟

آئيڊيمپوٽنسي ڪنجي ڏيو. ساڳي ڪنجي سان ٻيهر ڪال اصل پيغام جي id موٽائي ٿي ۽ ٻيو پيغام موڪلڻ بدران جواب کي آئيڊيمپوٽنٽ طور نشان لڳائي ٿي. ڪنجي کان سواءِ، ٻه ڪالون ٻه پيغام آهن.

آئون ڪيئن پڪ ڪريان ته ويب هڪ واقعي Spun کان آيو آهي؟

سبسڪرپشن کي دستخط وارو راز ڏيو ۽ دستخط وارو هيڊر چيڪ ڪريو، جيڪو اصل درخواست جي مواد جو HMAC-SHA256 آهي، sha256 کان پوءِ هيڪس ڊائجسٽ جي صورت ۾. ان کي پارس ڪرڻ کان اڳ، ملندڙ بلڪل انهن ئي بائيٽس تي پنهنجي حساب سان ڀيٽيو.

ان نمبر تي ٺاهيو جنهن تي توهان جا گراهڪ اڳ ۾ ئي پيغام ڪن ٿا

اسڪوپ سان محدود ڪنجيون، ننڍو ۽ مستحڪم API، ويب هڪ جيڪي پاڻ خبر موڪلين ٿا ته جيئن توهان کي بار بار چيڪ ڪرڻو نه پوي، ۽ في پيغام ڪو ميٽر ناهي.

مفت شروع ڪريو: هر شيءِ 7 ڏينهن لاءِ

Spun جون سڀ خاصيتون ڏسو