WhatsApp calls वेबहुक: Calling API का घटनाहरू, र Coexistence नम्बरमा कलहरू
calls वेबहुक फिल्डले WhatsApp Business Calling API का घटनाहरू देखाउँछ: SDP उत्तर वा प्रस्तावसहित connect, RINGING, ACCEPTED र REJECTED कल स्थिति, COMPLETED वा FAILED र अवधिसहित terminate, र call_recording_available वा call_transcription_available। Meta को Coexistence गाइडले भ्वाइस र भिडियो कलहरू WhatsApp Business एपमा अपरिवर्तित रहने र Cloud API मा समर्थित नहुने जनाउँछ, त्यसैले ती कलहरू फोनमै रहन्छन्।
easyCoexistence ले तपाईंको WhatsApp Business एपको नम्बरलाई Coexistence मार्फत Meta को Cloud API सँग जोड्छ, ताकि तपाईंको AI र स्वचालनले म्यासेजको जवाफ दिन र टेम्पलेट पठाउन सकून्, र कलहरू फोनमै एपमा बजिरहून्।
Cloud API मा WhatsApp Business एपबाट अनबोर्ड गरिएको नम्बरका लागि भ्वाइस र भिडियो कलहरू; एपमा तिनीहरू अपरिवर्तित छन्।
Calling API प्रयोग गर्न नम्बरलाई चाहिने न्यूनतम दैनिक म्यासेजिङ सीमा, अद्वितीय प्राप्तकर्ताका आधारमा।
कल रेकर्डिङ र ट्रान्सक्रिप्ट उनीहरूको वेबहुक पठाइएपछि कति दिनसम्म डाउनलोड गर्न मिल्छ।
कल आईडीको उपसर्ग, जसले कलको connect, स्थिति र terminate वेबहुकहरू एउटै ठाउँमा जोड्छ।
कलका वेबहुक प्राप्त गर्न एपलाई चाहिने अनुमति, म्यासेजका लागि जस्तै।
calls फिल्डले के रिपोर्ट गर्छ?
Calling API मार्फत गरिएका वा प्राप्त कलमा हुने सबै कुरा, प्रत्येक चरणका लागि एउटा घटनासहित एउटै फिल्डमा। व्यवसायबाट सुरु गरिएको कलले connect घटना, स्थिति अद्यावधिक र terminate घटना उत्पन्न गर्छ। SIP मार्फत सम्हालिएका कलले connect को सट्टा call_created रिपोर्ट गर्छन्, SDP सत्रबिना। अर्को सम्बन्धित घटना अर्कै ठाउँमा छ: ग्राहकले कल अनुमति अनुरोधको जवाफ दिँदा, त्यो उत्तर messages फिल्डमा call_permission_reply प्रकारको interactive म्यासेजका रूपमा आउँछ।
calls वेबहुक कस्तो देखिन्छ?
सबै WhatsApp वेबहुकको समान इन्भेलप, value भित्र calls array र 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 नम्बरमा calls वेबहुक काम गर्छ?
Meta को Coexistence गाइडले यसको सुविधा तालिकामा यसको जवाफ दिन्छ: यस तरिकाले जोडिएको नम्बरका लागि भ्वाइस र भिडियो कलहरू WhatsApp Business एपमा परिवर्तन नभएको र Cloud API मा समर्थित नभएको। Calling API का आफ्नै पूर्वशर्तले पनि अर्को पक्षबाट उही कुरा भन्छन्: व्यवसायको नम्बर Cloud API सँग प्रयोगमा हुनुपर्छ, WhatsApp Business एपसँग होइन। त्यसैले Coexistence नम्बरमा ग्राहकहरू पहिलेकै जस्तै कल गर्छन्, कल फोनमा एपमा बज्छ, र calls फिल्डले रिपोर्ट गर्ने केही हुँदैन। सफ्टवेयरमा कल चाहिने व्यवसायले केवल Cloud API मा नम्बर प्रयोग गर्नुपर्छ।
एउटै कलका घटनाहरू कसरी मिल्छन्?
call id द्वारा, जो wacid बाट सुरु हुन्छ र त्यस कलका हरेक घटनामा दोहोरिन्छ। व्यवसायबाट सुरु गरिएको कलले SDP उत्तरसहित connect रिपोर्ट गर्छ, त्यसपछि RINGING र त्यसपछि ACCEPTED वा REJECTED स्थिति, र अन्तमा terminate। प्रयोगकर्ताबाट सुरु गरिएको कलले तपाईंको स्ट्याकले उत्तर दिनुपर्ने SDP प्रस्तावसहित connect रिपोर्ट गर्छ, त्यसपछि terminate। रेकर्डिङ र ट्रान्सक्रिप्ट घटनाहरू, सक्षम गरिएको अवस्थामा, terminate पछि आउँछन्। भण्डारण गरिएका घटनाहरू id र event फिल्डको संयोजनमा राख्नुहोस्, किनभने पुनः प्रयासले तिनीहरूलाई दोहोर्याउँछ र आगमनको क्रम वाचा गरिएको छैन। Calling API का पूर्वशर्तको पूरा सूची Coexistence नम्बरमा कलसम्बन्धी पृष्ठमा छ।
तपाईंको AI ले Coexistence नम्बरका कलका बारेमा के गर्न सक्छ?
च्याटमा काम गर्न सक्छ, जबकि कलहरू फोनमा व्यक्तिसँगै रहन्छन्। easyCoexistence ले calls फिल्डमा सदस्यता लिँदैन र कुनै कल उपकरण छैन; यसको कनेक्टर र स्वचालनले म्यासेज र टेम्पलेटहरू मात्र ढाक्छ। व्यवहारमा, AI को जवाफले ग्राहकलाई कुनै व्यक्ति कहिले बोल्न उपलब्ध छ र कुन नम्बरमा फोन गर्ने भनेर बताउन सक्छ, कीवर्ड स्वचालनले “कल” वा “फोन” लेखेको सन्देशमा त्यही जानकारी दिन सक्छ, र मालिकले पहिलेजस्तै 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 को मूल्य फरक छ र छुट्टै कल मूल्य कागजातलाई संकेत गर्छ, त्यसैले कल शुल्क म्यासेज स्थितिको मूल्य खण्डमा देखिँदैन।
Calling API को कल रेकर्ड वा ट्रान्सक्राइब गर्न सकिन्छ?
हो, रेकर्डिङ वा ट्रान्सक्रिप्शन सक्षम गरिएको भए। कल सकिएपछि, सामान्यतया एक मिनेटभित्र, Meta ले audio मिडिया आईडीसहित call_recording_available वा JSON कागजात आईडीसहित call_transcription_available पठाउँछ।
कल वेबहुक एपको भन्दा फरक एन्डपोइन्टमा जान सक्छ?
हो। calls Meta ले WhatsApp Business खाता वा फोन नम्बरलाई वैकल्पिक कलब्याक यूआरएलमा पठाउन दिने फिल्डहरूमध्ये एक हो, messages र Coexistence फिल्डहरूसँगै।
पढ्दै जानुहोस्
सुरु गर्न तयार हुनुहुन्छ?
महिनौं होइन, केही मिनेटमै WhatsApp Coexistence सेट अप गर्नुहोस्। एप फोनमा चलिरहन्छ।
निःशुल्क ट्रायल सुरु गर्नुहोस्प्रमाणीकरण गरिएको