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

Webhook
اگر شما کارشناس توسعه‌دهنده و یا مدیر فنی یک شرکت باشید حتماً باقابلیت وب هوک و لزوم استفاده از آن آشنا هستید. WebHook درواقع یک رویداد اطلاع‌رسانی (notification) است که به URL انتخابی شما ارسال می‌شود. و داده‌های یک رویداد را به نرم‌افزار شما اطلاع می‌دهد. به‌طور مثال فرض کنید شما یک نرم‌افزار crm دارید که می‌خواهید زمانی که یک تماس جدید به مرکز تماس شما آمد، یک پاپ آپ تماس در crm خود نمایش دهید، این کار به‌راحتی با استفاده از قابلیت webhook قابل پیاده‌سازی هست و شما می‌تواند اطلاعات تمامی این رویدادها را به‌محض اتفاق توسط url تنظیمی خود دریافت کنید.

به اشتراک گذاری این پست

راهنمای رویداد‌های ارسال شده :

همه رویداد ها در وب‌هوک ( 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" 
}
event_name

نام رویداد می‌باشد. Newstate وضعیت تماس را نشان می‌دهد، Hangup زمانی که یک مسیر ارتباطی قطع می‌شود و CDR اطلاعات تکمیلی جریان تماس را ارائه می‌دهد.

type

نمایانگر نوع تماس می‌باشد. incoming_call برای تماس‌های ورودی و outgoing_call برای تماس‌های خروجی.

source

نمایانگر منبع تماس ورودی و یا خروجی می‌باشد. معمولاً شماره داخلی، نام ivr و یا شماره تماس‌گیرنده را نمایش می‌دهد

destination

نمایانگر مقصد تماس ورودی و یا خروجی می‌باشد. معمولاً شماره داخلی، نام ivr و یا شماره تماس‌گیرنده را نمایش می‌دهد

chanel

نمایانگر کانالی هست که در آن رویداد رخ‌داده است.

channel_state

نمایانگر یک کد عددی برای وضعیت فعلی کانال است

channel_state_desc

نمایانگر نام وضعیت فعلی کانال است و شامل موارد زیر می‌باشد:
Down
Rsrvd
OffHook
Dialing
Ring
Ringing
Up
Busy
Dialing Offhook
Pre-ring
Unknown

Context

نمایانگر زمینه رویداد می‌باشد.

uniq

یک شماره منحصربه‌فرد که به این چرخه تماس داده می‌شود، این شماره برای همه رویدادهای مرتبط با یک تماس ثابت است.

۲- رویداد Hangup

این رویداد در وب هوک ( WEB HOOK ) تلفن ابری همکاران، زمانی که یک جریان تماسی قطع می‌شود، اطلاعات آن را ارسال می‌نماید.

{
  "event_name": "Hangup", 
  "chanel": "SIP/1391010124-00000764",  
  "CallerIDNum": "09056466394",
  "ConnectedLineNum": "136102",
  "Context": "ext-queues",
  "uniq": "1625071789.3398"
}
event_name

نام رویداد می‌باشد. Newstate جهت وضعیت تماس، Hangup جهت قطع شدن یک مسیر ارتباطی، CDR جهت دادن اطلاعات تکمیلی یک جریان تماس.

chanel

نمایانگر کانالی هست که در آن رویداد رخ‌داده است.

CallerIDNum

نمایانگر کالر ایدی تماس می‌باشد.

ConnectedLineNum

نمایانگر شماره داخلی یا خارجی است که به آن متصل شده‌اید است.

Context

نمایانگر زمینه رویداد می‌باشد.

uniq

یک شماره منحصربه‌فرد که به این چرخه تماس داده می‌شود، این شماره برای همه رویدادهای مرتبط با یک تماس ثابت است.

رویداد 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"
}
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

یک شماره منحصربه‌فرد که به این چرخه تماس داده می‌شود، این شماره برای همه رویدادهای مرتبط با یک تماس ثابت است.

۴- رویداد voicemail

این رویداد در وب هوک ( WEB HOOK ) تلفن ابری همکاران، پس از ثبت موفقیت آمیز یک پیام صوتی برای شما ارسال میگردد.

{
   "event_name":"voiceMail",
   "source":"02191001664",
   "date":1711380030,
   "path":"vm_L3Zhci9zcG9vbC9hc3Rlcmlzay92b2ljZW1haWwvZGVmYXVsdC8xMDA5d5Ni53YXY",
   "uuid":"21711380002.18"
}
event_name

نام رویداد می‌باشد.

source

این پارامتر شماره‌ای را نشان می‌دهد که پیام صوتی را ارسال کرده است.

date

تاریخ و ساعت به صورت timestamp می‌باشد

path

جهت دستیابی به فایل صوتی پیام ضبط شده از طریق وب‌سرویس از این پارامتر استفاده می‌شود.

uuid

یک شماره منحصربه‌فرد که به این چرخه تماس داده می‌شود، این شماره برای همه رویدادهای مرتبط با یک تماس ثابت است.

  1. رویداد Voicemail
    • نکته عملی: “اگر مشتریان شما پیام‌های صوتی می‌گذارند، با استفاده از رویداد Voicemail می‌توانید به‌طور خودکار فایل صوتی پیام‌ها را ذخیره کرده و برای تیم پشتیبانی ارسال کنید. این کار به تسریع روند پاسخگویی به مشتریان و کاهش زمان‌های پاسخ‌دهی کمک می‌کند.”

سوالات متداول

قابلیت استفاده از وب‌هوک ( WEB HOOK ) در کدام یک از اشتراک‌ها موجود است ؟

این قابلیت از اشتراک طرح دو به بالا به صورت رایگان و در طرح یک با هزینه جدا قابل ارائه می‌باشد.

آیا خدمات پشتیبانی راه‌اندازی این قابلیت در نرم‌افزار‌های شخص ثالث امکان پذیر است ؟

بله، جهت این امکان با همکاران واحد فروش ما ارتباط بگیرید.

از زمان ارسال درخواست تا راه‌اندازی چقدر زمان می‌برد ؟

انجام این درخواست در همان لحظه امکان پذیر است.

راجع به وب‌هوک اطلاعات بیشتری را نیاز دارم.

با ما تماس بگیرید

در خبر نامه تلفن ابری همکاران عضو شوید

در ابتدای از آخرین مطالب و محوای ما مطلع شوید

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *

مطالب بیشتر

Reducing employee stress with cloud telephony
بلاگ

کاهش استرس کارمندان با تلفن ابری

در دنیای رقابتی امروز، کسب‌وکارها به دنبال راه‌حل‌هایی هستند که هم به بهبود کارایی و بهره‌وری و هم به رفاه کارکنان توجه کنند. استرس شغلی یکی از بزرگ‌ترین مشکلات در محیط‌های کاری است و می‌تواند به کاهش انگیزه، افزایش غیبت‌ها و حتی ترک شغل منجر شود. در همین راستا، تلفن ابری به‌عنوان یک راهکار نوآورانه و مؤثر می‌تواند در کاهش استرس کارمندان تأثیر شگرفی داشته باشد. این سیستم‌های تلفنی از امکانات پیشرفته‌ای برخوردارند که باعث می‌شود فرایندهای کاری ساده‌تر و بدون دغدغه تر انجام شوند.
در این مقاله، به بررسی چگونگی استفاده از تلفن ابری برای کاهش استرس کارمندان خواهیم پرداخت و خواهیم دید که این سیستم‌ها چگونه می‌توانند به بهبود محیط کاری و کاهش فشارهای شغلی کمک کنند.

بیشتر بخوانید
How to get ahead of the competition with cloud telephony
بلاگ

تلفن ابری و مزیت رقابتی

در عصر حاضر، زمانی که رقابت در دنیای کسب‌وکار به‌شدت افزایش‌یافته است، تنها کسب‌وکارهایی که قادر به نوآوری و انطباق با تغییرات فناوری هستند، می‌توانند پیشرو باشند. یکی از این فناوری‌های نوآورانه که به کسب‌وکارها این امکان را می‌دهد که بر رقبا پیشی بگیرند، تلفن ابری است. این سیستم ارتباطی علاوه بر ساده‌کردن فرایند تماس‌های تلفنی، امکانات پیشرفته‌ای را در اختیار کسب‌وکارها قرار می‌دهد که می‌تواند نقش کلیدی در کسب مزیت رقابتی ایفا کند.
در این مقاله، به بررسی چگونگی استفاده از تلفن ابری برای پیشی‌گرفتن از رقبا پرداخته می‌شود و این‌که چگونه این فناوری می‌تواند به بهبود عملکرد، کاهش هزینه‌ها و ارتقای تجربه مشتری کمک کند.

بیشتر بخوانید
247 Support with Cloud Contact Centers Benefits and Solutions
بلاگ

پشتیبانی ۲۴/۷ با استفاده از مراکز تماس ابری

در دنیای تجارت امروزی، انتظارات مشتریان به‌طور مداوم در حال افزایش است. مشتریان دیگر منتظر نمی‌مانند و می‌خواهند در هر زمان و از هر مکانی با شرکت‌ها ارتباط برقرار کنند. با پیشرفت‌های فناوری و تغییر در نیازهای بازار، یکی از مهم‌ترین سوالات برای کسب‌وکارها این است که چگونه می‌توانند به شکلی مؤثر و با کیفیت بالا به پشتیبانی ۲۴ ساعته و ۷ روز هفته بپردازند. پاسخ این سوال با استفاده از مراکز تماس ابری به راحتی قابل تحقق است. در این مقاله، بررسی می‌کنیم که چگونه این فناوری می‌تواند کسب‌وکارها را قادر سازد تا پشتیبانی مداوم ارائه دهند و چگونه این پشتیبانی به نفع مشتریان و کسب‌وکارها خواهد بود.

بیشتر بخوانید
Complete and submit documents
بلاگ

نکاتی در تکمیل و ارسال مدارک تلفن‌ ابری

تکمیل مدارک به‌عنوان یکی از مهم‌ترین بخش‌های انجام امور اداری، حقوقی و حتی مهاجرتی، فرایندی حساس و زمان‌بر است. از اشتباهات کوچک تا ارسال مدارک به روش‌های نامناسب، همگی می‌توانند پیامدهای جبران‌ناپذیری داشته باشند. در این مقاله، با نگاهی دقیق و جامع به مراحل ساخت، تکمیل و ارسال مدارک می‌پردازیم. همچنین درباره مشکلات استفاده از روش‌های سنتی مانند اسکنر و جایگزین‌های بهتر صحبت می‌کنیم.

بیشتر بخوانید

آیا میخواهید از فناوری جدید تلفن ابری بیشتر بدانید ؟

از این طریق با ما در تماس باشید.

تلفن ابری

دریافت مشاروه تخصصی رایگان

همکاران ما در نهایت صداقت در کنار شما هستند.

7 + 4 چند میشه ؟