خصوصیت

آپ کے اپنے 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 لوپ کا نہیں۔
  • اوپر دی گئی اینڈ پوائنٹس کی فہرست آج کا پورا دائرہ ہے۔ جو اس میں نہیں وہ دستیاب نہیں، اور کسی غیر دستاویزی اینڈ پوائنٹ پر بھروسہ نہیں کرنا چاہیے۔
  • کلید اسکوپ والی ہے لیکن فی صارف نہیں۔ اسے ورک اسپیس کی اسناد سمجھیں اور جب رسائی رکھنے والا کوئی شخص چھوڑ کر جائے تو اسے بدل دیں۔
  • ایسے لوگوں کو پیغام بھیجنے پر جنہوں نے کبھی اجازت نہیں دی، 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 کے بعد ہیکس ڈائجسٹ کی شکل میں۔ پارس کرنے سے پہلے اسے ٹھیک انہی بائٹس پر اپنے حساب سے ملائیں جو آپ کو موصول ہوئے۔

اس نمبر پر بنائیں جس پر آپ کے گاہک پہلے سے پیغام بھیجتے ہیں

اسکوپ والی کلیدیں، ایک چھوٹا اور مستحکم دائرہ، ویب ہکس جو آپ کو پول کروانے کے بجائے خود اطلاع بھیجتے ہیں، اور کوئی فی پیغام میٹر نہیں۔

مفت شروع کریں: 7 دن تک سب کچھ

Spun کی تمام خصوصیات دیکھیں