واٹس ایپ کالز ویب ہک: Calling API ایونٹس، اور Coexistence نمبر پر کالز
کالز ویب ہک فیلڈ WhatsApp Business Calling API کے ایونٹس بتاتی ہے: SDP آفر یا جواب کے ساتھ کنیکٹ، کال اسٹیٹسز RINGING، ACCEPTED اور REJECTED، COMPLETED یا FAILED اور دورانیے کے ساتھ ٹرمینیٹ، اور call_recording_available یا call_transcription_available کی اطلاعات۔ Meta کی Coexistence گائیڈ میں آواز اور ویڈیو کالز کو WhatsApp Business ایپ میں بغیر تبدیلی کے درج کیا گیا ہے اور Cloud API پر ان کی سپورٹ نہیں، اس لیے یہ کالز فون پر ہی رہتی ہیں۔
easyCoexistence آپ کے WhatsApp Business ایپ کے نمبر کو Coexistence کے ذریعے Meta کے Cloud API سے جوڑتا ہے، تاکہ آپ کا AI اور آٹومیشنز میسجز کا جواب دیں اور ٹیمپلیٹس بھیجیں، جبکہ کالز آپ کے فون پر ایپ میں بجتی رہیں۔
WhatsApp Business ایپ سے آن بورڈ کیے گئے نمبر کے لیے Cloud API پر آواز اور ویڈیو کالز؛ ایپ میں یہ کالز بغیر تبدیلی کے رہتی ہیں۔
Calling API استعمال کرنے کے لیے نمبر کو درکار روزانہ میسجنگ کی کم از کم حد، منفرد وصول کنندگان میں۔
کال ریکارڈنگز اور ٹرانسکرپٹس ان کے ویب ہک کی ترسیل کے بعد کتنی دیر تک ڈاؤن لوڈ کے قابل رہتے ہیں۔
کال آئی ڈیز کا سابقہ، وہ قدر جو کسی کال کے کنیکٹ، اسٹیٹس اور ٹرمینیٹ ویب ہکس کو آپس میں جوڑتی ہے۔
وہ اجازت جو کالز ویب ہکس وصول کرنے کے لیے ایپ کو درکار ہے، میسجز کی طرح۔
کالز ویب ہک فیلڈ کیا بتاتی ہے؟
Calling API کے ذریعے کی گئی یا وصول کی گئی کال کے ساتھ ہونے والا ہر واقعہ، ایک فیلڈ میں، ہر مرحلے کے لیے ایک ایونٹ کے ساتھ۔ کاروبار کی شروع کردہ کال ایک کنیکٹ ایونٹ، اسٹیٹس اپ ڈیٹس اور ایک ٹرمینیٹ ایونٹ پیدا کرتی ہے۔ SIP پر ہینڈل ہونے والی کالز SDP سیشن کے بغیر connect کی بجائے call_created رپورٹ کرتی ہیں۔ ایک متعلقہ ایونٹ کہیں اور ہے: جب کوئی گاہک کال اجازت کی درخواست کا جواب دیتا ہے، تو جواب messages فیلڈ پر call_permission_reply قسم کے interactive میسج کے طور پر آتا ہے۔
کالز ویب ہک کیسا نظر آتا ہے؟
یہ ہر WhatsApp ویب ہک کا وہی لفافہ ہے، جس میں ویلیو کے تحت calls کا ایرے ہوتا ہے اور field کی قدر calls ہوتی ہے۔ direction میں BUSINESS_INITIATED یا USER_INITIATED ہوتا ہے، from اور to فون نمبر رکھتے ہیں، to_user_id گاہک کا BSUID ہے، اور اس گاہک کے لیے جو یوزر نیم استعمال کرتا ہے کوئی بھی نمبر غائب ہو سکتا ہے۔ metadata.phone_number_id آپ کے نمبر کی شناخت کرتا ہے، جیسے کسی بھی دوسری فیلڈ پر۔ نیچے Meta کی Call Connect مثال ہے، جس میں پلیس ہولڈرز وہی ہیں جو Meta نے چھاپے ہیں:
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
"changes": [
{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "16315553601",
"phone_number_id": "<PHONE_NUMBER_ID>"
},
"contacts": [
{
"profile": {
"name": "<CALLEE_NAME>",
"username": "<USERNAME>"
},
"wa_id": "16315553602",
"user_id": "<BSUID>",
"parent_user_id": "<PARENT_BSUID>"
}
],
"calls": [
{
"id": "wacid.ABGGFjFVU2AfAgo6V-Hc5eCgK5Gh",
"to": "16315553601",
"to_user_id": "<BSUID>",
"to_parent_user_id": "<PARENT_BSUID>",
"from": "16315553602",
"event": "connect",
"timestamp": "1671644824",
"direction": "BUSINESS_INITIATED",
"session": {
"sdp_type": "answer",
"sdp": "<<RFC 8866 SDP>>"
}
}
]
},
"field": "calls"
}
]
}
]
}terminate ایونٹ کون سی فیلڈز شامل کرتا ہے؟
terminate وہ ایونٹ ہے جو زیادہ تر سسٹم محفوظ کرتے ہیں، کیونکہ یہ کال کو بند کرتا ہے۔ Meta کے ریفرنس کے مطابق اس کی فیلڈز یہ ہیں:
- status: COMPLETED جب کال بغیر غیر متوقع خرابی کے ختم ہو، جن میں جواب نہ دی گئی کالز بھی شامل ہیں؛ FAILED جب کال کنیکٹ نہ ہو یا ٹوٹ جائے۔
start_time،end_timeاور duration سیکنڈز میں: صرف اس صورت میں موجود ہوتے ہیں جب دوسری طرف نے کال اٹھائی ہو۔- errors: FAILED کال پر code، message، href اور
error_data.details موجود ہوتے ہیں۔ biz_opaque_callback_data: آپ کی اپنی ٹریکنگ اسٹرنگ، جب کال شروع یا قبول کرتے وقت آپ نے ایک دی ہو۔
کیا کالز ویب ہکس Coexistence نمبر پر کام کرتے ہیں؟
Meta کی Coexistence گائیڈ اپنے فیچر ٹیبل میں اس کا جواب دیتی ہے: اس طرح آن بورڈ کیے گئے نمبر کے لیے آواز اور ویڈیو کالز میں WhatsApp Business ایپ میں کوئی تبدیلی نہیں ہوتی اور Cloud API پر ان کی سپورٹ نہیں۔ Calling API کی اپنی شرائط دوسری طرف سے یہی بات کہتی ہیں: کاروباری نمبر Cloud API کے ساتھ استعمال ہونا چاہیے، WhatsApp Business ایپ کے ساتھ نہیں۔ تو Coexistence نمبر پر گاہک پہلے کی طرح کال کرتے رہتے ہیں، کال فون پر ایپ میں بجتی ہے، اور calls فیلڈ کے پاس رپورٹ کرنے کو کچھ نہیں ہوتا۔ جس کاروبار کو سافٹ ویئر میں کالز درکار ہوں، وہ صرف Cloud API پر ایک نمبر استعمال کرے۔
کسی ایک کال کے ایونٹس ایک دوسرے سے کیسے جڑتے ہیں؟
کال آئی ڈی کے ذریعے، جو wacid سے شروع ہوتی ہے اور اس کال کے ہر ایونٹ پر دہرائی جاتی ہے۔ کاروبار کی شروع کی ہوئی کال SDP جواب کے ساتھ کنیکٹ رپورٹ کرتی ہے، پھر اسٹیٹسز RINGING اور اس کے بعد ACCEPTED یا REJECTED، اور آخر میں ٹرمینیٹ۔ صارف کی شروع کی ہوئی کال SDP آفر کے ساتھ کنیکٹ رپورٹ کرتی ہے، جس کا جواب آپ کے اسٹیک کو دینا ہوتا ہے، پھر ٹرمینیٹ۔ ریکارڈنگ اور ٹرانسکرپٹ کے ایونٹس، جب فعال ہوں، ٹرمینیٹ کے بعد آتے ہیں۔ محفوظ شدہ ایونٹس کو id اور event کی جوڑی سے اسٹور کریں، کیونکہ دوبارہ کوششیں انہیں دہراتی ہیں اور آمد کی ترتیب کی ضمانت نہیں دی جاتی۔ Calling API کی شرائط کی مکمل فہرست Coexistence نمبر پر کالز والے صفحے پر ہے۔
آپ کا AI Coexistence نمبر کی کالز کے لیے کیا کر سکتا ہے؟
چیٹ میں کام کرتا ہے، جبکہ کالز فون پر موجود شخص کے پاس رہتی ہیں۔ easyCoexistence calls فیلڈ کو سبسکرائب نہیں کرتا اور اس کے پاس کال ٹولز نہیں ہیں؛ اس کا کنیکٹر اور آٹومیشنز میسجز اور ٹیمپلیٹس کا احاطہ کرتے ہیں۔ عملی طور پر اس کا مطلب یہ ہے کہ ایک AI جواب گاہک کو بتا سکتا ہے کہ بات کرنے کے لیے کون دستیاب ہے اور کون سا نمبر کال کرنا ہے، ایک کی ورڈ آٹومیشن “call” یا “phone” کا جواب یہی معلومات دے سکتی ہے، اور مالک کال WhatsApp Business ایپ میں پہلے کی طرح خود اٹھاتا ہے۔
عام غلطیاں
- Coexistence نمبر کے لیے calls کو سبسکرائب کرنا اور ایونٹس کا انتظار کرنا۔ Meta ان نمبروں کے لیے کالنگ کو Cloud API پر غیر معاون درج کرتا ہے۔
- ہر terminate پر start_time اور duration کی توقع۔ یہ صرف اس وقت آتے ہیں جب کال کا جواب دیا گیا ہو؛ جواب نہ دی گئی کال پھر بھی COMPLETED پر ختم ہوتی ہے۔
- calls فیلڈ پر اجازت کے جوابات تلاش کرنا۔ وہ messages پر interactive call_permission_reply کے طور پر آتے ہیں۔
- ریکارڈنگز اور ٹرانسکرپٹس Meta کے پاس چھوڑ دینا۔ دونوں ان کے ویب ہک کے بعد 7 دن تک ڈاؤن لوڈ ہو سکتے ہیں، پھر وہ ختم ہو جاتے ہیں۔
ہر نمبر 24/7 مانیٹر ہوتا ہے، بشمول 14 دن کا وہ اصول جو ایسے نمبر کو منقطع کر دیتا ہے جس کی ایپ نہ کھولی جائے۔ فی نمبر فی مہینہ US$ 9 سے US$ 0.75 تک، جیسے جیسے نمبر شامل کریں یہ کم ہوتی جاتی ہے، پہلے 3 دن فری ٹرائل۔
اکثر پوچھے جانے والے سوالات
کیا Coexistence کے ذریعے نمبر API سے جڑنے پر گاہک کال کا بٹن کھو دیتے ہیں؟
Meta کی Coexistence گائیڈ آواز اور ویڈیو کالز کو WhatsApp Business ایپ میں بغیر تبدیلی کے درج کرتی ہے۔ گاہک وہی نمبر کال کرتے ہیں، اور مالک فون پر ایپ میں جواب دیتا ہے۔
کیا Calling API کی قیمت میسجز جیسی ہے؟
نہیں۔ Meta کا قیمتوں کا صفحہ کہتا ہے کہ Calling API کی قیمت مختلف ہے اور ایک الگ کالنگ پرائسنگ دستاویز کا حوالہ دیتا ہے، اس لیے کال کے چارجز میسج اسٹیٹسز کے pricing آبجیکٹ میں نظر نہیں آتے۔
کیا Calling API کی کال ریکارڈ یا ٹرانسکرائب کی جا سکتی ہے؟
ہاں، جب ریکارڈنگ یا ٹرانسکرپشن فعال ہو۔ کال کے بعد Meta عموماً ایک منٹ کے اندر call_recording_available آڈیو میڈیا آئی ڈی کے ساتھ، یا call_transcription_available JSON دستاویز کی آئی ڈی کے ساتھ بھیجتا ہے۔
کیا کال ویب ہک ایپ کے اینڈ پوائنٹ کے علاوہ کسی اور اینڈ پوائنٹ پر جا سکتا ہے؟
ہاں۔ calls ان فیلڈز میں شامل ہے جنہیں Meta کسی WhatsApp Business Account یا فون نمبر کو متبادل کال بیک URL پر بھیجنے دیتا ہے، messages اور Coexistence فیلڈز کے ساتھ۔
مزید پڑھیں
شروع کرنے کے لیے تیار ہیں؟
WhatsApp Coexistence چند منٹ میں سیٹ اپ کریں، مہینوں میں نہیں۔ ایپ فون پر کام کرتی رہتی ہے۔
فری ٹرائل شروع کریںتصدیق شدہ تاریخ