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

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

معرفی​

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 تماس می‌توانید رویدادهای مختلف مربوط به یک تماس را شناسایی کنید.