WhatsApp కాల్స్ వెబ్హుక్లు: 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 వెబ్హుక్లను స్వీకరించడానికి యాప్కు అవసరమైన అనుమతి, messages కోసం ఉన్నదే.
calls వెబ్హుక్ ఫీల్డ్ ఏమి నివేదిస్తుంది?
Calling API ద్వారా చేసిన లేదా స్వీకరించిన కాల్కు జరిగే ప్రతిదీ, ప్రతి దశకు ఒక ఈవెంట్తో ఒకే ఫీల్డ్గా. వ్యాపారం ప్రారంభించిన కాల్ connect ఈవెంట్, స్టేటస్ అప్డేట్లు మరియు terminate ఈవెంట్ ఉత్పత్తి చేస్తుంది. SDP సెషన్ లేకుండా, SIP ద్వారా నిర్వహించిన కాల్స్ connect కు బదులుగా call_created ను నివేదిస్తాయి. ఒక సంబంధిత ఈవెంట్ వేరే చోట ఉంటుంది: కస్టమర్ కాల్ అనుమతి అభ్యర్థనకు ప్రతిస్పందించినప్పుడు, ఆ ప్రతిస్పందన messages ఫీల్డ్లో call_permission_reply రకం interactive మెసేజ్గా వస్తుంది.
కాల్స్ వెబ్హుక్ ఎలా కనిపిస్తుంది?
ప్రతి WhatsApp వెబ్హుక్ లాంటి ఎన్వలప్, value కింద calls శ్రేణితో మరియు field విలువ calls గా సెట్ చేయబడి. direction లో BUSINESS_INITIATED లేదా USER_INITIATED ఉంటుంది, from మరియు to ఫోన్ నంబర్లను కలిగి ఉంటాయి, to_user_id కస్టమర్ BSUID ని కలిగి ఉంటుంది, మరియు యూజర్నేమ్ ఉపయోగించే కస్టమర్ విషయంలో ఏదైనా నంబర్ లేకపోవచ్చు. 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 రిఫరెన్స్ ప్రకారం దీని ఫీల్డ్లు:
- 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 యొక్క స్వంత ముందస్తు అవసరాలు మరో వైపు నుండి అదే చెబుతాయి: వ్యాపార నంబర్ WhatsApp Business యాప్లో కాకుండా Cloud API తో వాడుకలో ఉండాలి. కాబట్టి Coexistence నంబర్పై కస్టమర్లు మునుపటిలాగే కాల్ చేస్తూనే ఉంటారు, కాల్ ఫోన్లోని యాప్లో మోగుతుంది, మరియు calls ఫీల్డ్కు నివేదించడానికి ఏమీ ఉండదు. సాఫ్ట్వేర్లో కాల్స్ కావాల్సిన వ్యాపారం కేవలం Cloud API పై ఉన్న నంబర్ను ఉపయోగిస్తుంది.
ఒక కాల్ యొక్క ఈవెంట్లు ఎలా కలిసి ఉంటాయి?
కాల్ ఐడీ ద్వారా, ఇది wacid తో మొదలవుతుంది మరియు ఆ కాల్ యొక్క ప్రతి ఈవెంట్లో పునరావృతమవుతుంది. వ్యాపారం ప్రారంభించిన కాల్ SDP ఆన్సర్తో connect ను నివేదిస్తుంది, తర్వాత RINGING, ఆపై ACCEPTED లేదా REJECTED స్టేటస్లు, చివరికి terminate. వినియోగదారు ప్రారంభించిన కాల్ మీ స్టాక్ సమాధానం ఇవ్వడానికి SDP ఆఫర్తో connect ను నివేదిస్తుంది, తర్వాత terminate. రికార్డింగ్ మరియు ట్రాన్స్క్రిప్ట్ ఈవెంట్లు, ప్రారంభించినప్పుడు, terminate తర్వాత వస్తాయి. retries ఈవెంట్లను పునరావృతం చేస్తాయి మరియు చేరే క్రమం హామీ ఇవ్వబడదు కాబట్టి, 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 ద్వారా ఒక నంబర్ API కు కనెక్ట్ అయినప్పుడు కస్టమర్లు కాల్ బటన్ను కోల్పోతారా?
Meta యొక్క Coexistence గైడ్ వాయిస్ మరియు వీడియో కాల్స్ WhatsApp Business యాప్లో మారలేదని జాబితా చేస్తుంది. కస్టమర్లు అదే నంబర్కు కాల్ చేస్తారు, మరియు యజమాని ఫోన్లోని యాప్లో సమాధానం ఇస్తారు.
Calling API ధర మెసేజ్ల లాగా ఉంటుందా?
లేదు. Meta ధర పేజీ ప్రకారం Calling API కు వేరే ధర ఉంది మరియు కాలింగ్ ధర కోసం ప్రత్యేక డాక్యుమెంట్ను సూచిస్తుంది, కాబట్టి కాల్ ఛార్జీలు మెసేజ్ స్టేటస్లలోని pricing ఆబ్జెక్ట్లో కనిపించవు.
Calling API కాల్ను రికార్డ్ చేయగలరా లేదా ట్రాన్స్క్రైబ్ చేయగలరా?
అవును, రికార్డింగ్ లేదా ట్రాన్స్క్రిప్షన్ ప్రారంభించినప్పుడు. కాల్ ముగిసిన తర్వాత, Meta సాధారణంగా ఒక నిమిషంలోపే, ఆడియో media id తో call_recording_available లేదా JSON డాక్యుమెంట్ id తో call_transcription_available పంపుతుంది.
calls వెబ్హుక్ను యాప్ ఎండ్పాయింట్కు బదులుగా వేరే ఎండ్పాయింట్కు పంపవచ్చా?
అవును. calls అనేది Meta ఒక WhatsApp Business Account లేదా ఫోన్ నంబర్ను ప్రత్యామ్నాయ కాల్బ్యాక్ URL కు పంపడానికి అనుమతించే ఫీల్డ్లలో ఒకటి, messages మరియు Coexistence ఫీల్డ్లతో పాటు.
చదవడం కొనసాగించండి
ప్రారంభించడానికి సిద్ధంగా ఉన్నారా?
నెలల్లో కాదు, నిమిషాల్లో WhatsApp Coexistence సెటప్ చేయండి. యాప్ ఫోన్లో పనిచేస్తూనే ఉంటుంది.
ఉచిత ట్రయల్ ప్రారంభించండిధృవీకరించిన తేదీ