معرفی قابلیت Web hook و آموزش استفاده از آن

راهنمای رویداد‌های ارسال شده :همه رویداد ها در وب‌هوک ( WEB HOOK ) مرکز تلفن ابری همکاران، با فرمت JSON به URL تنظیمی شما ارسال میگردد. در این مستند رویداد‌‌های ارسالی را به تفضیل توضیح خواهیم داد.۱-رویداد event_nameاین رویداد در وب هوک ( WEB HOOK ) تلفن ابری همکاران، معمولاً در زمان تماس ورودی و خروجی اتفاق میفتد، همچنین زمان پاسخ‌دهی به تماس هم این رویداد نمایش داده می‌شود.{ &quotevent_name&quot: &quotNewstate&quot, &quottype&quot: &quotincoming_call&quot, &quotsource&quot: &quot09056466394&quot, &quotdestination&quot: &quots&quot, &quotchanel&quot: &quotSIP/1391010124-00000763&quot, &quotchannel_state&quot: &quot6&quot, &quotchannel_state_desc&quot: &quotUp&quot, &quotContext&quot: &quotivr-78&quot, &quotuniq&quot: &quot1625071719.3397&quot }event_nameنام رویداد می‌باشد. Newstate جهت وضعیت تماس، Hangup جهت قطع شدن یک مسیر ارتباطی، CDR جهت دادن اطلاعات تکمیلی یک جریان تماس.typeنمایانگر نوع تماس می‌باشد. incoming_call برای تماس‌های ورودی و outgoing_call برای تماس‌های خروجی.sourceنمایانگر منبع تماس ورودی و یا خروجی می‌باشد. معمولاً شماره داخلی، نام ivr و یا شماره تماس‌گیرنده را نمایش می‌دهدdestinationنمایانگر مقصد تماس ورودی و یا خروجی می‌باشد. معمولاً شماره داخلی، نام ivr و یا شماره تماس‌گیرنده را نمایش می‌دهدchanelنمایانگر کانالی هست که در آن رویداد رخ‌داده است.channel_stateنمایانگر یک کد عددی برای وضعیت فعلی کانال استchannel_state_descنمایانگر نام وضعیت فعلی کانال است و شامل موارد زیر می‌باشد:DownRsrvdOffHookDialingRingRingingUpBusyDialing OffhookPre-ringUnknownContextنمایانگر زمینه رویداد می‌باشد.uniqیک شماره منحصربه‌فرد که به این چرخه تماس داده می‌شود، این شماره برای همه رویدادهای مرتبط با یک تماس ثابت است.۲- رویداد Hangupاین رویداد در وب هوک ( WEB HOOK ) تلفن ابری همکاران، زمانی که یک جریان تماسی قطع می‌شود، اطلاعات آن را ارسال می‌نماید.{ &quotevent_name&quot: &quotHangup&quot, &quotchanel&quot: &quotSIP/1391010124-00000764&quot, &quotCallerIDNum&quot: &quot09056466394&quot, &quotConnectedLineNum&quot: &quot136102&quot, &quotContext&quot: &quotext-queues&quot, &quotuniq&quot: &quot1625071789.3398&quot }event_nameنام رویداد می‌باشد. Newstate جهت وضعیت تماس، Hangup جهت قطع شدن یک مسیر ارتباطی، CDR جهت دادن اطلاعات تکمیلی یک جریان تماس.chanelنمایانگر کانالی هست که در آن رویداد رخ‌داده است.CallerIDNumنمایانگر کالر ایدی تماس می‌باشد.ConnectedLineNumنمایانگر شماره داخلی یا خارجی است که به آن متصل شده‌اید است.Contextنمایانگر زمینه رویداد می‌باشد.uniqیک شماره منحصربه‌فرد که به این چرخه تماس داده می‌شود، این شماره برای همه رویدادهای مرتبط با یک تماس ثابت است.۳- رویداد CDRاین رویداد در وب هوک ( WEB HOOK ) تلفن ابری همکاران، پس از پایان یک تماس ارسال می‌شود، و اطلاعات تجمیعی تماس از جمله زمان شروع و پایان آن را در اختیار شما می‌گذارد.{ &quotevent_name&quot: &quotCdr&quot, &quotsource&quot: &quot&quot, &quotdestination&quot: &quot09373608119&quot, &quotchanel&quot: &quotSIP/135102-00000819&quot, &quotdestinationChannel&quot: &quotSIP/2191010494-0000081a&quot, &quotdisposition&quot: &quotNO ANSWER&quot, &quotLastApplication&quot: &quotDial&quot, &quotLastData&quot: &quotSIP/2191010494/09373608119,300,Tb(func-apply-sipheaders^s^1,(38))U(sub-send-obr&quot, &quotBillableSeconds&quot: &quot0&quot, &quotduration&quot: &quot13&quot, &quottype&quot: &quotoutgoing_call&quot, &quotStartTime&quot: &quot2021-07-01 11:45:24&quot, &quotAnswerTime&quot: &quot&quot, &quotEndTime&quot: &quot2021-07-01 11:45:37&quot, &quotDuration&quot: &quot13&quot, &quotuniq&quot: &quot1625123724.3765&quot }event_nameنام رویداد می‌باشد. Newstate جهت وضعیت تماس، Hangup جهت قطع شدن یک مسیر ارتباطی، CDR جهت دادن اطلاعات تکمیلی یک جریان تماس.sourceنمایانگر منبع تماس ورودی و یا خروجی می‌باشد. معمولا شماره داخلی، نام IVR و یا شماره تماس گیرنده را نمایش می‌دهدdestinationنمایانگر مقصد تماس ورودی و یا خروجی می‌باشد. معمولاً شماره داخلی، نام IVR و یا شماره تماس‌گیرنده را نمایش می‌دهدchanelنمایانگر کانالی هست که در آن رویداد رخ‌داده است.destinationChannelنمایانگر کانال مقصد می‌باشد.dispositionآخرین وضعیت شناسایی‌شده جریان تماس که شامل این موارد است:NO ANSWER : کانال پاسخ داده نشده است. این حالت پیش فرض است.FAILED : کانال سعی کرده شماره گیری کند اما تماس ناموفق بود.BUSY : کانال سعی کرده شماره گیری کند اما مقصد مشغول بود.ANSWERED : کانال پاسخ داده شده است. علت قطع کردن دیگر بر وضع CDR تأثیر نخواهد گذاشت.CONGESTION :کانال سعی کرد شماره گیری کند اما خطوط شبکه شلوغ بودن.LastApplicationآخرین برنامه‌ای که اجراشده است.LastDataآخرین پارامترهای که به برنامه اجرای تماس داده‌شده است.BillableSecondsزمان زنگ خوردن به ثانیه، از زمانی که جریان پاسخ‌داده‌شده است تا زمانی که جریان قطع‌شده است.durationمدت‌زمان به ثانیه از زمانی که جریان شروع‌شده تا زمانی که جریان قطع‌شده است.typeنمایانگر نوع تماس می‌باشد. incoming_call برای تماس‌های ورودی و outgoing_call برای تماس‌های خروجی.StartTimeتاریخ و زمان شروع جریان تماس.AnswerTimeتاریخ و زمان شروع پاسخ دادن به جریان تماس.EndTimeتاریخ و زمان پایان جریان تماس.uniqیک شماره منحصربه‌فرد که به این چرخه تماس داده می‌شود، این شماره برای همه رویدادهای مرتبط با یک تماس ثابت است.?جهت راه‌اندازی Web Hook در تلفن ابری همکاران از طریق فرم‌های زیر با ما ارتباط بگیرید.[wpforms id="3390"]ارسال درخواست راه‌اندازیاگر شما درخواست ست شدن WEB HOOK را دارید، از طریق فرم زیر درخواست خود را برای ما ارسال نمایید.[wpforms id="3356"]ارسال درخواست مشاورهاگر سایت و یا CRM شما این قابلیت را در اختیار شما قرار نمیدهد، نگران نباشد. مشاورین ما بهترین راه برای استفاده از این امکان را در اختیار شما قرار میدهند. پس از طرق فرم زیر درخواست مشاوره برای ما ارسال کندی.سوالات متداولقابلیت استفاده از وب‌هوک ( WEB HOOK ) در کدام یک از اشتراک‌ها موجود است ؟این قابلیت از اشتراک طرح دو به بالا قابل ارائه می‌باشد.آیا خدمات پشتیبانی راه‌اندازی این قابلیت در نرم‌افزار‌های شخص ثالث امکان پذیر است ؟بله، جهت این امکان با همکاران واحد فروش ما ارتباط بگیرید.از زمان ارسال درخواست تا راه‌اندازی چقدر زمان می‌برد ؟انجام این درخواست حداکثر دو روز کاری زمان‌بر خواهد بود.راجع به وب‌هوک اطلاعات بیشتری را نیاز دارم.جهت کسب اطلاعات بیشتر راجع به به وب هوک به اینجا مراجعه کنید.