مقدمه

پکیج API مرکز تماس به سه بخش کلی تقسیم می‌شود.

SEA (Simotel Event API)

SEA مجموعه‌ای از APIها هستند که اطلاعات مربوط به رویداد‌های رخ داده در مرکز تماس را به سمت وب‌سرویس شما ارسال می‌کنند، با استفاده از SEA شما می‌توانید از تمام رویدادهای که در مرکزتماس رخ می‌دهد به سرعت باخبر شوید. این بخش وظیفه مدیریت تمامی رویداد‌های که از مبدأ سیموتل به مقصد وب‌سرویس ارسال می‌شوند را برعهده دارد.

برای مثال یکی از کاربردی‌ترین رویداد‌های این بخش متد CDR (Call Detail Record) است که پس از اتمام مکالمه وظیفه ارسال تمامی اطلاعات تماس شامل (تاریخ شروع مکالمه، تاریخ پایان مکالمه، شماره مبدأ، شماره مقصد، مدت مکالمه، زمان انتظار و…) به سمت وب‌سرویس را بر‌عهده دارد، متدهای موجود در SEA به‌صورت دقیقتر مورد بررسی قرار می‌گیرند.

SA (Simotel API)

SA مجموعه از APIها هستند که با ارسال درخواست از سمت وب‌سرویس به سمت سیموتل شروع می‌شوند، این سرویس در قالب استاندارد REST API ایجاد گردیده است. برای مثال با ارسال درخواست تماس‌دوطرفه از سمت وب‌سرویس به سمت سیموتل، پس از دریافت درخواست مرکز تماس شروع به ایجاد تماس دوطرفه می‌کند.

کامپوننت‌های API

کامپوننت‌های مربوط به API در دایل‌پلن امکان مدیریت تماس‌ها را به‌صورت پویا به شما می‌دهند، با استفاده از این کامپوننت‌ها شما می‌توانید یک تعامل بین وب‌سرویس و مرکز تماس ایجاد کنید که در نهایت وب‌سرویس شما با توجه به داده‌های دریافتی از کامپوننت (request) وتحلیل شرایط موجود نتیجه‌گیری می‌کند که چه جوابی به درخواست کامپوننت دهد (response).

برای مثال بعضی از مجموعه‌ها نیاز دارند زمانی که مشتری چندین بار تماس می‌گیرد تا پایان کار فقط با یکی از کارشناسان شرکت در ارتباط باشد و مشتری با هر بار تماس‌گرفتن به یک کارشناس جدید متصل نشود. امکان پیاده‌سازی این سناریو با استفاده از کامپوننت ExtenAPI مقدور است.

فرمت ارسال و دریافت اطلاعات

فرمت داده‌ها در فراخوانی درخواست و پاسخ آن در قالب JSON است (به‌استثنای سرویس‌های دانلود و استریم).