WhatsApp कॉल्स वेबहुक: Calling API इव्हेंट्स, आणि Coexistence नंबरवरील कॉल्स
कॉल्स वेबहुक फील्ड WhatsApp Business Calling API चे इव्हेंट्स कळवते: SDP answer किंवा offer सह 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, status आणि terminate वेबहुक एकत्र जोडते.
कॉल्स वेबहुक मिळवण्यासाठी ॲपला आवश्यक असलेली परवानगी, मेसेजेससाठी जशी असते तशीच.
कॉल्स वेबहुक फील्ड काय कळवते?
Calling API द्वारे केला किंवा स्वीकारला गेलेला प्रत्येक कॉल, प्रत्येक टप्प्यासाठी एक इव्हेंट असलेल्या एका फील्डमध्ये कळवला जातो. व्यवसायाने सुरू केलेल्या कॉलमध्ये connect इव्हेंट, स्टेटस अपडेट्स आणि terminate इव्हेंट येतात. SIP द्वारे हाताळलेले कॉल्स connect ऐवजी call_created कळवतात, SDP सत्राशिवाय. एक संबंधित इव्हेंट वेगळ्या ठिकाणी येतो: ग्राहक कॉल परवानगी विनंतीला उत्तर देतो तेव्हा ते उत्तर messages फील्डवर call_permission_reply प्रकारच्या interactive मेसेज म्हणून येते.
कॉल्स वेबहुक कसा दिसतो?
प्रत्येक 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 नंबरवर कॉल्स वेबहुक काम करतात का?
Meta च्या Coexistence मार्गदर्शकाच्या फीचर तक्त्यात याचे उत्तर आहे: अशा प्रकारे ऑनबोर्ड केलेल्या नंबरसाठी व्हॉइस आणि व्हिडिओ कॉल्समध्ये WhatsApp Business ॲपमध्ये बदल होत नाही आणि Cloud API वर समर्थन नाही. Calling API च्या स्वतःच्या पूर्वअटीही दुसऱ्या बाजूने हेच सांगतात: व्यवसाय नंबर Cloud API सोबत वापरात असला पाहिजे, WhatsApp Business ॲपसोबत नाही. म्हणून Coexistence नंबरवर ग्राहक पूर्वीप्रमाणेच कॉल करत राहतात, कॉल फोनवरील ॲपमध्ये वाजतो, आणि calls फील्डला कळवण्यासारखे काहीच नसते. ज्या व्यवसायाला सॉफ्टवेअरमध्ये कॉल्स हवे आहेत, त्याने फक्त Cloud API वरील नंबर वापरावा.
एका कॉलचे इव्हेंट्स एकमेकांशी कसे जुळतात?
कॉल आयडीद्वारे, जो wacid ने सुरू होतो आणि त्या कॉलच्या प्रत्येक इव्हेंटवर पुनरावृत्ती होतो. व्यवसायाने सुरू केलेला कॉल SDP answer सह connect कळवतो, RINGING आणि नंतर ACCEPTED किंवा REJECTED स्टेटस, आणि शेवटी terminate. ग्राहकाने सुरू केलेला कॉल तुमच्या स्टॅकने उत्तर देण्यासाठी SDP offer सह connect कळवतो, मग terminate. रेकॉर्डिंग आणि ट्रान्स्क्रिप्ट इव्हेंट्स, सक्षम असल्यास, terminate नंतर येतात. इव्हेंट्स id व event या जोडीवर साठवा, कारण retries त्या पुन्हा पाठवतात आणि येण्याच्या क्रमाची हमी दिलेली नाही. Calling API च्या पूर्वअटींची संपूर्ण यादी Coexistence नंबरवरील कॉल्सच्या पानावर आहे.
Coexistence नंबरवरील कॉल्सबाबत तुमचा AI काय करू शकतो?
चॅटमध्ये काम करू शकतो, तर कॉल्स फोनवरील व्यक्तीकडेच राहतात. easyCoexistence calls फील्डची सदस्यता घेत नाही आणि त्याची कॉल टूल्स नाहीत; त्याचा कनेक्टर आणि ऑटोमेशन्स मेसेजेस व टेम्प्लेट्स कव्हर करतात. प्रत्यक्षात याचा अर्थ असा: AI उत्तर ग्राहकाला सांगू शकते की कोण बोलायला उपलब्ध आहे आणि कोणत्या नंबरवर कॉल करायचा; कीवर्ड ऑटोमेशन "call" किंवा "phone" ला त्या माहितीसह उत्तर देऊ शकते; आणि मालक WhatsApp Business ॲपमध्ये पूर्वीप्रमाणेच कॉल उचलतो.
सामान्य चुका
- Coexistence नंबरसाठी calls ची सदस्यता घेणे आणि इव्हेंट्सची वाट पाहणे. Meta ने या नंबरसाठी कॉलिंग Cloud API वर समर्थित नसल्याचे नमूद केले आहे.
- प्रत्येक terminate वर start_time आणि duration येण्याची अपेक्षा. ते फक्त कॉल उचलला गेल्यावर येतात; उत्तर न दिलेला कॉलसुद्धा COMPLETED म्हणून संपतो.
- calls फील्डवर परवानगी उत्तरे शोधणे. ती messages वर, call_permission_reply नावाच्या interactive मेसेज म्हणून येतात.
- रेकॉर्डिंग आणि ट्रान्स्क्रिप्ट्स Meta कडे सोडणे. दोन्ही त्यांच्या वेबहुकनंतर 7 दिवसांपर्यंत डाउनलोड करता येतात, नंतर ते नाहीसे होतात.
प्रत्येक नंबर 24/7 मॉनिटर केला जातो, ज्यात 14 दिवसांचा नियम समाविष्ट आहे, जो ॲप न उघडलेला नंबर डिस्कनेक्ट करतो. प्रति नंबर प्रति महिना US$ 9 पासून US$ 0.75 पर्यंत, तुम्ही नंबर जोडाल तसा दर कमी होत जातो, पहिले 3 दिवस मोफत.
वारंवार विचारले जाणारे प्रश्न
Coexistence द्वारे नंबर API ला जोडल्यावर ग्राहक कॉल बटण गमावतात का?
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 दस्तऐवज id असतो, साधारणपणे एका मिनिटात.
कॉल वेबहुक ॲपच्या एंडपॉइंटऐवजी वेगळ्या एंडपॉइंटवर जाऊ शकतो का?
होय. calls हे असे एक फील्ड आहे जे Meta WhatsApp Business Account किंवा फोन नंबरला messages आणि Coexistence फील्ड्सच्या बरोबरीने पर्यायी callback URL वर पाठवू देते.
पुढे वाचा
सुरुवात करण्यासाठी तयार आहात?
WhatsApp Coexistence काही मिनिटांत सेट करा, काही महिन्यांत नाही. ॲप फोनवर काम करत राहते.
मोफत ट्रायल सुरू करापडताळले: