پرش به مطلب اصلی

معرفی و تنظیمات

معرفی​

Simotel Event Webhooks مجموعه‌ای ازدرخواست ها هستند که اطلاعات مربوط به رویداد‌های رخ داده در مرکز تماس را به سمت وب‌سرویس شما ارسال می‌کنند، با استفاده از Event Webhooks شما می‌توانید از تمام رویدادهایی که در مرکز تماس رخ می‌دهد به سرعت باخبر شوید. این بخش وظیفه مدیریت تمامی رویداد‌های که از مبداء سیموتل به مقصد وب‌سرویس شما ارسال می‌شوند را برعهده دارد.

تنظیمات​

برای مشاهده تنظیمات مربوط به بخش Simotel Event Webhooks به Maintenance > Settings > AP Settings مراجعه فرمایید،در قسمت Simotel Event Webhooks بخش‌های متفاوتی وجود دارد که در پایین به تشریح هرکدام می‌پردازیم

Event Webhooks Enabled​

مشخص می‌کند سرویس Event Webhooks فعال باشد یا خیر.

Event Webhooks Version​

سیموتل توانایی ارسال اطلاعات به سمت وب‌سرویس تحت فرمت‌های مختلف را دارد، بطور کلی دوقالب اصلی وجود دارد

  • سرویس های G (General): در سرویس های G تمام رویداد ها منحصرا به آدرس وب‌سرویس ارسال می گردند و فراهم کننده، رویدادها را با استفاده از پارامتر event_name تفکیک می کند.

  • سرویس های Rest: در سرویس های Rest، نام رویداد به انتهای آدرس اضافه شده و سپس اطلاعات به سمت وب‌سرویس ارسال می‌شوند.

نمونه‌ فراخوانی rest

Call <WebService_address>/newstate
Call <WebService_address>/cdr

Request Method​

  • Get: سیموتل داده‌ها را در قالب پارامتر به سمت وب‌سرویس ارسال می‌کند.

  • Post: از ورژن ۴ (Rest4، G4)، داده‌ها با فرمت json در بدنه درخواست قرار گرفته و به سمت WebService ارسال می گردد. در ورژن های ۲ و ۳ همانند GET به صورت پارامتر ارسال می‌گردد.

نمونه فراخوانی سرویسG4:​

	curl -u username:password --location --request POST 'http://192.168.51.193/call/' \
	--header 'Content-Type: application/json' \
	--data-raw '{
    "event_name": "NewState",
    "exten": "991",
    "state": "Unavailable"
	}'

نمونه فراخوانی سرویسRest4:​

	curl -u username:password --location --request POST 'http://192.168.51.193/call/NewState' \
	--header 'Content-Type: application/json' \
	--data-raw '{
    "event_name": "NewState",
    "exten": "991",
    "state": "Unavailable"
	}'

Events​

در این قسمت اطلاعات و رویدادهای سیستم دسته‌بندی شده‌اند و بسته به نیاز، شما مشخص می‌کنید چه اطلاعاتی باید به سمت WebService ارسال شود، رویدادها و اطلاعت آنها بصورت دقیق‌تر در بخش‌های آینده بررسی می‌شوند.

API Address​

در اینجا نیز آدرس وب‌سرویس قرار می‌گیرد.

API Username​

در صورتی که احرازهویتی از سمت وب‌سرویس انجام می‌شود،نام کاربری اینجا وارد می‌شود.

API Password​

در صورتی که احرازهویتی از سمت وب‌سرویس انجام می‌شود،رمزعبور اینجا وارد می‌شود.

نکته

در برخی از رویداد‌های SEA پارامتری به نام unique_id وجود دارد. به ازای هر تماسی که در سیستم تولید می‌شود یک شناسه یکتا تولید می‌شود، بنابراین شما با استفاده از unique_id تماس می‌توانید رویدادهای مختلف مربوط به یک تماس را شناسایی کنید.