WhatsApp कॉल वेबहुक: Calling API इवेंट, और Coexistence नंबर पर कॉल
कॉल वेबहुक फ़ील्ड WhatsApp Business Calling API के इवेंट बताता है: SDP answer या SDP offer के साथ कनेक्ट, कॉल स्टेटस 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 और ऑटोमेशन मैसेजों का जवाब दें और टेम्पलेट भेजें, जबकि कॉल आपके फ़ोन पर ऐप में बजती रहें।
Cloud API पर उस नंबर के लिए वॉइस और वीडियो कॉल, जो WhatsApp Business ऐप से ऑनबोर्ड हुआ है; ऐप में ये अपरिवर्तित रहती हैं।
न्यूनतम दैनिक मैसेजिंग लिमिट, unique recipients में, जो किसी नंबर के लिए Calling API इस्तेमाल करने से पहले ज़रूरी है।
कॉल रिकॉर्डिंग और ट्रांसक्रिप्ट उनका वेबहुक डिलीवर होने के बाद कितने समय तक डाउनलोड योग्य रहते हैं।
कॉल आईडी का प्रीफ़िक्स, वह मान जो किसी कॉल के connect, status और terminate वेबहुक को आपस में जोड़ता है।
वह अनुमति जो किसी ऐप को कॉल वेबहुक पाने के लिए चाहिए, मैसेज के लिए जैसी ही।
कॉल वेबहुक फ़ील्ड क्या बताता है?
Calling API के ज़रिए किए गए या प्राप्त किसी कॉल के साथ जो कुछ होता है, वह सब एक ही फ़ील्ड में, हर चरण के लिए एक इवेंट के रूप में। कारोबार द्वारा शुरू की गई कॉल से connect इवेंट, स्टेटस अपडेट और terminate इवेंट आते हैं। SIP पर संभाली गई कॉल में connect की जगह call_created आता है, बिना SDP session के। एक संबंधित इवेंट दूसरी जगह रहता है: जब ग्राहक कॉल अनुमति अनुरोध का जवाब देता है, तो जवाब messages फ़ील्ड पर call_permission_reply प्रकार के इंटरैक्टिव मैसेज के रूप में आता है।
कॉल वेबहुक कैसा दिखता है?
हर WhatsApp वेबहुक जैसा ही एनवेलप, value के नीचे calls array के साथ और field calls पर सेट। direction में BUSINESS_INITIATED या USER_INITIATED लिखा होता है, from और to में फ़ोन नंबर होते हैं, to_user_id में ग्राहक का BSUID, और जो ग्राहक username इस्तेमाल करता है उसके लिए कोई भी नंबर गायब हो सकता है। metadata.phone_number_id आपका नंबर पहचानता है, जैसे किसी भी दूसरे फ़ील्ड पर। यह Meta के Call Connect उदाहरण का है, placeholders वैसे ही जैसे 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 के reference के अनुसार इसके फ़ील्ड:
- 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 से शुरू होती है और उस कॉल के हर इवेंट में दोहराई जाती है। कारोबार द्वारा शुरू की गई कॉल में connect SDP answer के साथ आता है, फिर स्टेटस RINGING और फिर ACCEPTED या REJECTED, और अंत में terminate। ग्राहक द्वारा शुरू की गई कॉल में connect SDP offer के साथ आता है, जिसका जवाब आपका स्टैक देता है, फिर terminate। रिकॉर्डिंग और ट्रांसक्रिप्ट के इवेंट, जब चालू हों, terminate के बाद आते हैं। सहेजे गए इवेंट को id और event के संयोजन से रखें, क्योंकि रीट्राई उन्हें दोहराते हैं और आने का क्रम तय नहीं है। Calling API की पूर्वशर्तों की पूरी सूची Coexistence नंबर पर कॉल वाले पेज पर है।
Coexistence नंबर पर कॉल के बारे में आपका AI क्या कर सकता है?
चैट में काम कर सकता है, जबकि कॉल फ़ोन पर मौजूद व्यक्ति के पास ही रहती हैं। 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 के ज़रिए एपीआई से जुड़ता है, तो क्या ग्राहक कॉल बटन खो देते हैं?
Meta की Coexistence गाइड वॉइस और वीडियो कॉल को WhatsApp Business ऐप में अपरिवर्तित बताती है। ग्राहक उसी नंबर पर कॉल करते हैं, और मालिक ऐप में फ़ोन पर जवाब देता है।
क्या Calling API की कीमत मैसेज जैसी है?
नहीं। Meta का प्राइसिंग पेज बताता है कि Calling API की कीमत अलग है और एक अलग calling pricing दस्तावेज़ की ओर इशारा करता है, इसलिए कॉल के शुल्क मैसेज स्टेटस के pricing ऑब्जेक्ट में नहीं दिखते।
क्या Calling API की कॉल रिकॉर्ड या ट्रांसक्राइब की जा सकती है?
हाँ, जब रिकॉर्डिंग या ट्रांसक्रिप्शन चालू हो। कॉल के बाद Meta call_recording_available भेजता है, जिसमें audio media id होता है, या call_transcription_available, जिसमें JSON document id होता है, आमतौर पर एक मिनट के भीतर।
क्या कॉल वेबहुक ऐप के एंडपॉइंट से अलग एंडपॉइंट पर जा सकता है?
हाँ। calls उन फ़ील्ड में से है जिन्हें Meta WhatsApp Business Account या फ़ोन नंबर को दूसरे कॉलबैक यूआरएल पर भेजने देता है, messages और Coexistence फ़ील्ड के साथ।
पढ़ना जारी रखें
शुरू करने के लिए तैयार हैं?
WhatsApp Coexistence को महीनों में नहीं, मिनटों में कॉन्फ़िगर करें। ऐप्लिकेशन मोबाइल पर काम करता रहता है।
मुफ़्त ट्रायल शुरू करेंइस तारीख को सत्यापित