راهنمای رویدادهای ارسال شده :
همه رویداد ها در وب‌هوک ( WEB HOOK ) مرکز تلفن ابری همکاران، با فرمت JSON به URL تنظیمی شما ارسال میگردد. در این مستند رویدادهای ارسالی را به تفصیل توضیح خواهیم داد.
۱-رویداد event_name
وب‌هوک (WEB HOOK) تلفن ابری همکاران این رویداد را معمولاً در زمان تماس ورودی و خروجی ارسال می‌کند.همچنین هنگامی که کاربران به تماس پاسخ می‌دهند، سیستم این رویداد را نمایش می‌دهد.
{
"event_name": "Newstate",
"type": "incoming_call",
"source": "09056466394",
"destination": "s",
"chanel": "SIP/1391010124-00000763",
"channel_state": "6",
"channel_state_desc": "Up",
"Context": "ivr-78",
"uniq": "1625071719.3397"
}نام رویداد می‌باشد. Newstate وضعیت تماس را نشان می‌دهد، Hangup زمانی که یک مسیر ارتباطی قطع می‌شود و CDR اطلاعات تکمیلی جریان تماس را ارائه می‌دهد.
نمایانگر نوع تماس می‌باشد. incoming_call برای تماس‌های ورودی و outgoing_call برای تماس‌های خروجی.
نمایانگر منبع تماس ورودی و یا خروجی می‌باشد. معمولاً شماره داخلی، نام ivr و یا شماره تماس‌گیرنده را نمایش می‌دهد
نمایانگر مقصد تماس ورودی و یا خروجی می‌باشد. معمولاً شماره داخلی، نام ivr و یا شماره تماس‌گیرنده را نمایش می‌دهد
نمایانگر کانالی هست که در آن رویداد رخ‌داده است.
نمایانگر یک کد عددی برای وضعیت فعلی کانال است
نمایانگر نام وضعیت فعلی کانال است و شامل موارد زیر می‌باشد:DownRsrvdOffHookDialingRingRingingUpBusyDialing OffhookPre-ringUnknown
نمایانگر زمینه رویداد می‌باشد.
یک شماره منحصربه‌فرد که به این چرخه تماس داده می‌شود، این شماره برای همه رویدادهای مرتبط با یک تماس ثابت است.
۲- رویداد Hangup
این رویداد در وب هوک ( WEB HOOK ) تلفن ابری همکاران، زمانی که یک جریان تماسی قطع می‌شود، اطلاعات آن را ارسال می‌نماید.
{
"event_name": "Hangup",
"chanel": "SIP/1391010124-00000764",
"CallerIDNum": "09056466394",
"ConnectedLineNum": "136102",
"Context": "ext-queues",
"uniq": "1625071789.3398"
}نام رویداد می‌باشد. Newstate جهت وضعیت تماس، Hangup جهت قطع شدن یک مسیر ارتباطی، CDR جهت دادن اطلاعات تکمیلی یک جریان تماس.
نمایانگر کانالی هست که در آن رویداد رخ‌داده است.
نمایانگر کالر ایدی تماس می‌باشد.
نمایانگر شماره داخلی یا خارجی است که به آن متصل شده‌اید است.
نمایانگر زمینه رویداد می‌باشد.
یک شماره منحصربه‌فرد که به این چرخه تماس داده می‌شود، این شماره برای همه رویدادهای مرتبط با یک تماس ثابت است.
رویداد Hangup
- نکته عملی: “با استفاده از رویداد
Hangupمی‌توانید اطمینان حاصل کنید که پس از قطع تماس، وضعیت تماس در سیستم به‌روز شود. به‌طور مثال، اگر یک تماس قطع شود و مشتری یا اپراتور تماس را از دست بدهند، می‌توانید به مدیران اعلان ارسال کنید تا پیگیری‌های لازم انجام شود.”
۳- رویداد CDR
این رویداد در وب هوک ( WEB HOOK ) تلفن ابری همکاران، پس از پایان یک تماس ارسال می‌شود، و اطلاعات تجمیعی تماس از جمله زمان شروع و پایان آن را در اختیار شما می‌گذارد.
{
"event_name": "Cdr",
"source": "",
"destination": "09373608119",
"chanel": "SIP/135102-00000819",
"destinationChannel": "SIP/2191010494-0000081a",
"disposition": "NO ANSWER",
"LastApplication": "Dial",
"LastData": "SIP/2191010494/09373608119,300,Tb(func-apply-sipheaders^s^1,(38))U(sub-send-obr",
"BillableSeconds": "0",
"duration": "13",
"type": "outgoing_call",
"StartTime": "2021-07-01 11:45:24",
"AnswerTime": "",
"EndTime": "2021-07-01 11:45:37",
"Duration": "13",
"uniq": "1625123724.3765"
}نام رویداد می‌باشد. Newstate جهت وضعیت تماس، Hangup جهت قطع شدن یک مسیر ارتباطی، CDR جهت دادن اطلاعات تکمیلی یک جریان تماس.
نمایانگر منبع تماس ورودی و یا خروجی می‌باشد. معمولا شماره داخلی، نام IVR و یا شماره تماس گیرنده را نمایش می‌دهد
نمایانگر مقصد تماس ورودی و یا خروجی می‌باشد. معمولاً شماره داخلی، نام IVR و یا شماره تماس‌گیرنده را نمایش می‌دهد
نمایانگر کانالی هست که در آن رویداد رخ‌داده است.
نمایانگر کانال مقصد می‌باشد.
آخرین وضعیت شناسایی‌شده جریان تماس که شامل این موارد است:
NO ANSWER : کانال پاسخ داده نشده است. این حالت پیش فرض است.
FAILED : کانال سعی کرده شماره گیری کند اما تماس ناموفق بود.
BUSY : کانال سعی کرده شماره گیری کند اما مقصد مشغول بود.
ANSWERED : کانال پاسخ داده شده است. علت قطع کردن دیگر بر وضع CDR تأثیر نخواهد گذاشت.
CONGESTION :کانال سعی کرد شماره گیری کند اما خطوط شبکه شلوغ بودن.
آخرین برنامه‌ای که اجراشده است.
آخرین پارامترهای که به برنامه اجرای تماس داده‌شده است.
زمان زنگ خوردن به ثانیه، از زمانی که جریان پاسخ‌داده‌شده است تا زمانی که جریان قطع‌شده است.
مدت‌زمان به ثانیه از زمانی که جریان شروع‌شده تا زمانی که جریان قطع‌شده است.
نمایانگر نوع تماس می‌باشد. incoming_call برای تماس‌های ورودی و outgoing_call برای تماس‌های خروجی.
تاریخ و زمان شروع جریان تماس.
تاریخ و زمان شروع پاسخ به تماس.
تاریخ و زمان پایان جریان تماس.
یک شماره منحصربه‌فرد که به این چرخه تماس داده می‌شود، این شماره برای همه رویدادهای مرتبط با یک تماس ثابت است.
۴- رویداد voicemail
این رویداد در وب هوک ( WEB HOOK ) تلفن ابری همکاران، پس از ثبت موفقیت آمیز یک پیام صوتی برای شما ارسال میگردد.
{
"event_name":"voiceMail",
"source":"02191001664",
"date":1711380030,
"path":"vm_L3Zhci9zcG9vbC9hc3Rlcmlzay92b2ljZW1haWwvZGVmYXVsdC8xMDA5d5Ni53YXY",
"uuid":"21711380002.18"
}نام رویداد می‌باشد.
این پارامتر شماره‌ای را نشان می‌دهد که پیام صوتی را ارسال کرده است.
تاریخ و ساعت به صورت timestamp می‌باشد
جهت دستیابی به فایل صوتی پیام ضبط شده از طریق وب‌سرویس از این پارامتر استفاده می‌شود.
یک شماره منحصربه‌فرد که به این چرخه تماس داده می‌شود، این شماره برای همه رویدادهای مرتبط با یک تماس ثابت است.
- رویداد
Voicemail- نکته عملی: “اگر مشتریان شما پیام‌های صوتی می‌گذارند، با استفاده از رویداد
Voicemailمی‌توانید به‌طور خودکار فایل صوتی پیام‌ها را ذخیره کرده و برای تیم پشتیبانی ارسال کنید. این کار به تسریع روند پاسخگویی به مشتریان و کاهش زمان‌های پاسخ‌دهی کمک می‌کند.”
- نکته عملی: “اگر مشتریان شما پیام‌های صوتی می‌گذارند، با استفاده از رویداد
سوالات متداول
این قابلیت از اشتراک طرح دو به بالا به صورت رایگان و در طرح یک با هزینه جدا قابل ارائه می‌باشد.
بله، جهت این امکان با همکاران واحد فروش ما ارتباط بگیرید.
انجام این درخواست در همان لحظه امکان پذیر است.
با ما تماس بگیرید
