WhatsApp কলের ওয়েবহুক: Calling API ইভেন্ট, এবং Coexistence নম্বরে কল
calls ওয়েবহুক ফিল্ড 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, স্ট্যাটাস ও terminate ওয়েবহুককে একসঙ্গে বাঁধে।
calls ওয়েবহুক পেতে একটি অ্যাপের যে অনুমতি লাগে, মেসেজের মতোই।
calls ওয়েবহুক ফিল্ড কী জানায়?
API-এর মাধ্যমে করা বা গৃহীত প্রতিটি কলের সব ঘটনা, প্রতিটি ধাপের জন্য একটি ইভেন্টসহ একটি ফিল্ডে। ব্যবসা-শুরু করা কলে আসে একটি connect ইভেন্ট, স্ট্যাটাস আপডেট এবং একটি terminate ইভেন্ট। SIP-এর মাধ্যমে পরিচালিত কলে connect-এর বদলে call_created আসে, SDP সেশন ছাড়াই। একটি সম্পর্কিত ইভেন্ট অন্য জায়গায় থাকে: কোনো গ্রাহক কল অনুমতির অনুরোধের উত্তর দিলে সেই উত্তর messages ফিল্ডে আসে, call_permission_reply টাইপের একটি interactive মেসেজ হিসেবে।
calls ওয়েবহুক দেখতে কেমন?
WhatsApp-এর সব ওয়েবহুকের মতোই একই এনভেলপ, value-এর অধীনে একটি calls অ্যারে এবং field সেট calls। direction বলে BUSINESS_INITIATED বা USER_INITIATED, from ও to বহন করে ফোন নম্বর, to_user_id গ্রাহকের BSUID, এবং যে গ্রাহক ইউজারনেম ব্যবহার করেন তার ক্ষেত্রে যেকোনো একটি নম্বর অনুপস্থিত থাকতে পারে। metadata.phone_number_id আপনার নম্বরটি চিহ্নিত করে, অন্য যেকোনো ফিল্ডের মতোই। এটি Meta-র Call Connect উদাহরণ, placeholder গুলো 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-তে আছে।
একটি কলের ইভেন্টগুলো কীভাবে একসঙ্গে মেলে?
কল আইডি দিয়ে, যা wacid দিয়ে শুরু হয় এবং সেই কলের প্রতিটি ইভেন্টে পুনরাবৃত্ত হয়। ব্যবসা-শুরু করা কলে আসে SDP answer সহ connect, তারপর RINGING এবং তারপর ACCEPTED বা REJECTED স্ট্যাটাস, এবং শেষে terminate। ব্যবহারকারী-শুরু করা কলে আসে আপনার স্ট্যাক উত্তর দেওয়ার জন্য SDP offer সহ connect, তারপর 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-এর মাধ্যমে একটি নম্বর 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 বা ফোন নম্বরকে বিকল্প callback URL-এ পাঠাতে দেয়, messages ও Coexistence ফিল্ডের পাশাপাশি।
আরও পড়ুন
শুরু করতে প্রস্তুত?
মাস নয়, কয়েক মিনিটেই WhatsApp Coexistence সেট আপ করুন। ফোনে অ্যাপটি কাজ করতে থাকে।
ফ্রি ট্রায়াল শুরু করুনযাচাই করা হয়েছে