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

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

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

اشتراک گذاری در facebook
اشتراک گذاری در linkedin
اشتراک گذاری در twitter
اشتراک گذاری در email
اشتراک گذاری در telegram

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

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

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

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

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

جهت راه‌اندازی Web Hook در تلفن ابری همکاران از طریق فرم‌های زیر با ما ارتباط بگیرید.


ارسال درخواست راه‌اندازی

اگر شما درخواست ست شدن WEB HOOK را دارید، از طریق فرم زیر درخواست خود را برای ما ارسال نمایید.

ارسال درخواست مشاوره

اگر سایت و یا CRM شما این قابلیت را در اختیار شما قرار نمیدهد، نگران نباشد. مشاورین ما بهترین راه برای استفاده از این امکان را در اختیار شما قرار میدهند. پس از طرق فرم زیر درخواست مشاوره برای ما ارسال کندی.

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

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

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

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

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

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

انجام این درخواست حداکثر دو روز کاری زمان‌بر خواهد بود.

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

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

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

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

مطالب بیشتر

بلاگ

6 نکته کلیدی در ایجاد تلفن گویا (IVR) برای کسب و کار‌های کوچک و متوسط

زمانی که بحث راه‌اندازی یک کسب‌وکار کوچک یا متوسط مطرح می‌شود، پاسخ دادن به تلفن یک بخش ضروری از آن است.در کسب و کار‌های کوچک و متوسط حتی اگر یک تماس در روز داشته باشید ارزشمند است چرا که ممکن است یک فرصت یا کار فوری باشد، از طرفی ممکن است استخدام یک مسئول پذیرش تمام‌وقت هم منطقی نباشد. البته، منتظر نگه داشتن مشتری پشت خط (زنگ خوردن تلفن) و یا فرستادن مشتری به پست صوتی راه‌حل بلند مدتی نیست، پس چه کار باید کرد؟

بیشتر بخوانید
مدیریت ارتباط با مشتری به کمک مرکز تلفن ابری
بلاگ

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

مدیریت ارتباط با مشتری یا همان CRM لازمه رشد و بقای سازمان ها است. با استفاده از مرکز تلفن ابری می توانید داده هایی را در رابطه با نیازها، خواسته و ویژگی های مشتریانتان به دست آورید و با آن ها روابط هوشمندانه و صمیمی ایجاد کنید و با این کار به پیشرفت و توسعه سازمانتان کمک فرمایید.

بیشتر بخوانید
کاهش هزینه های سازمانی با راه اندازی مرکز تلفن ابری
بلاگ

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

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

بیشتر بخوانید
امنیت مرکز تماس ابری
بلاگ

همه چیز درباره امنیت مرکز تلفن ابری

وجود اخبارهای بسیار در مورد حملات سایبری، هک خطوط تلفن و… باعث شده وقتی موضوع استفاده از مرکز تلفن ابری برای سازمان ها مطرح می شود، مدیران سازمان ها، توجه ویژه ای به مسائل امنیتی داشته باشند.
ممکن است تهدیداتی برای به خطر انداختن مرکز تلفن ابری وجود داشته باشد، اما جای نگرانی نیست. چرا که راهکارهای بسیاری هستند که به واسطه آن ها می توان از این نوع سرویس ها محافظت کرد.
از این رو به جرات می توان گفت استفاده از مرکز تلفن ابری، مطمئن ترین راهی است که به واسطه آن می توانید از اطلاعات سازمان و مشتریانتان محافظت کنید.

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

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

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

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

از طریق این فرم میتوانید اطلاعات مورد نیاز جهت خرید تلفن ابری همکاران را برای ما ارسال نمایید.

برای آپلود، فایلی را به این قسمت بکشید یا کلیک کنید. تا 10 فایل را می‌توانید آپلود کنید.

حقیقی : فقط کارت ملی

حقوقی : کارت ملی صاحبین امضاء، اساسنامه شرکت، آگهی آخرین تغییرات

اطلاعات تماس با ما

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

جهت دریافت رایگان مشاوره از مشاورین کارآموزده ما در تلفن ابری همکاران فرم زیر را برای ما ارسال نمیایید.

در این قسمت در صورتی که میدانید نیاز تلفنی شما چه مقدار هست. آن را وارد کنید، برای مثال شرکت X نیازمند حمایت از ۱۰ تماس همزمان می‌باشد.
در صورتی که میدانید چه تعداد داخلی مورد نیاز شما هست آن را وارد کنید.

اطلاعات تماس با ما