لاگ اِن کریںفری ٹرائل شروع کریں
Meta Tech Provider

واٹس ایپ کالز ویب ہک: 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 اور آٹومیشنز میسجز کا جواب دیں اور ٹیمپلیٹس بھیجیں، جبکہ کالز آپ کے فون پر ایپ میں بجتی رہیں۔

Not supported

WhatsApp Business ایپ سے آن بورڈ کیے گئے نمبر کے لیے Cloud API پر آواز اور ویڈیو کالز؛ ایپ میں یہ کالز بغیر تبدیلی کے رہتی ہیں۔

2,000

Calling API استعمال کرنے کے لیے نمبر کو درکار روزانہ میسجنگ کی کم از کم حد، منفرد وصول کنندگان میں۔

7 days

کال ریکارڈنگز اور ٹرانسکرپٹس ان کے ویب ہک کی ترسیل کے بعد کتنی دیر تک ڈاؤن لوڈ کے قابل رہتے ہیں۔

wacid

کال آئی ڈیز کا سابقہ، وہ قدر جو کسی کال کے کنیکٹ، اسٹیٹس اور ٹرمینیٹ ویب ہکس کو آپس میں جوڑتی ہے۔

whatsapp_business_messaging

وہ اجازت جو کالز ویب ہکس وصول کرنے کے لیے ایپ کو درکار ہے، میسجز کی طرح۔

کالز ویب ہک فیلڈ کیا بتاتی ہے؟

Calling API کے ذریعے کی گئی یا وصول کی گئی کال کے ساتھ ہونے والا ہر واقعہ، ایک فیلڈ میں، ہر مرحلے کے لیے ایک ایونٹ کے ساتھ۔ کاروبار کی شروع کردہ کال ایک کنیکٹ ایونٹ، اسٹیٹس اپ ڈیٹس اور ایک ٹرمینیٹ ایونٹ پیدا کرتی ہے۔ SIP پر ہینڈل ہونے والی کالز SDP سیشن کے بغیر connect کی بجائے call_created رپورٹ کرتی ہیں۔ ایک متعلقہ ایونٹ کہیں اور ہے: جب کوئی گاہک کال اجازت کی درخواست کا جواب دیتا ہے، تو جواب messages فیلڈ پر call_permission_reply قسم کے interactive میسج کے طور پر آتا ہے۔

connectThe call is ready to connect; session carries the SDP to apply to your WebRTC stack.
call_createdA SIP call was attempted, business- or user-initiated.
statuses (type call)RINGING, ACCEPTED or REJECTED for a business-initiated call.
terminateThe call ended: status COMPLETED or FAILED, with times and duration when answered.
call_recording_availableA media id for the finished audio recording.
call_transcription_availableA media id for the transcript, a JSON document.

کالز ویب ہک کیسا نظر آتا ہے؟

یہ ہر WhatsApp ویب ہک کا وہی لفافہ ہے، جس میں ویلیو کے تحت calls کا ایرے ہوتا ہے اور field کی قدر calls ہوتی ہے۔ direction میں BUSINESS_INITIATED یا USER_INITIATED ہوتا ہے، from اور to فون نمبر رکھتے ہیں، to_user_id گاہک کا BSUID ہے، اور اس گاہک کے لیے جو یوزر نیم استعمال کرتا ہے کوئی بھی نمبر غائب ہو سکتا ہے۔ metadata.phone_number_id آپ کے نمبر کی شناخت کرتا ہے، جیسے کسی بھی دوسری فیلڈ پر۔ نیچے Meta کی Call Connect مثال ہے، جس میں پلیس ہولڈرز وہی ہیں جو Meta نے چھاپے ہیں:

Meta's example: the Call Connect webhook
{
  "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 دن تک ڈاؤن لوڈ ہو سکتے ہیں، پھر وہ ختم ہو جاتے ہیں۔
EasyCoexistence کے ساتھ یہ کام کرنا

ہر نمبر 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 Business کالز ایک Coexistence نمبر پرCoexistence کے بعد WhatsApp Business ایپ میں کالز جاری رہتی ہیں، مگر Meta کا Calling API ان نمبرز کو سپورٹ نہیں کرتا۔ اس کا مطلب آپ کے لیے یہ ہے۔WhatsApp ویب ہک اسٹیٹس: sent، delivered، read اور failedWhatsApp بتاتا ہے کہ آپ کے بھیجے گئے میسج کے ساتھ کیا ہوا: statuses array، ہر ویلیو، ہر فیلڈ، اور wamid کے ذریعے مماثلت۔Coexistence کے بعد WhatsApp کے کون سے فیچرز بند ہو جاتے ہیںکنیکٹڈ نمبر پر غائب ہونے والے میسجز، لائیو لوکیشن اور براڈکاسٹ لسٹس بند ہو جاتی ہیں۔ عملی مطلب جانیں۔API کے ساتھ کیا سنکرونائز ہوتا ہے، اور کیا نہیںکانٹیکٹس اور ون ٹو ون ہسٹری منتقل ہوتی ہے۔ گروپس، کیٹلاگ، لیبلز اور کوئیک ریپلائز نہیں ہوتے۔ مکمل فہرست یہاں ہے۔نمبر کو Coexistence سے صرف Cloud API پر منتقل کرناWhatsApp Business ایپ سے نمبر ہٹا کر صرف Cloud API پر چلانا: مراحل کی ترتیب، Meta کے مطابق ضائع ہونے والی ہسٹری اور کیا بدلتا ہے۔WhatsApp ویب ہک کی دوبارہ کوششیں، ڈپلیکیٹس اور ترتیب: انہیں کیسے سنبھالیںMeta ویب ہک کو 7 دن تک دوبارہ کوشش کرتا ہے، اس لیے ڈپلیکیٹ معمول ہیں اور ترتیب کی ضمانت نہیں۔ ڈپلیکیٹ ہٹانے کی کلیدیں، محفوظ ہینڈلر اور جواب دینے کا طریقہ۔

شروع کرنے کے لیے تیار ہیں؟

WhatsApp Coexistence چند منٹ میں سیٹ اپ کریں، مہینوں میں نہیں۔ ایپ فون پر کام کرتی رہتی ہے۔

فری ٹرائل شروع کریں

تصدیق شدہ تاریخ