نرم‌افزار شما، متصل به مرکز تماس
راهنمای کامل توسعه اتصال به تلفن ابری همکاران؛ از کلیک برای تماس و گزارش مکالمه تا وب‌هوک، ضبط کنفرانس و نمایش نام مخاطب.
سه مسیر برای اتصال نرم‌افزار شما#
Web Service
از برنامه خود فرمان بدهید؛ تماس ایجاد کنید و گزارش، ضبط و وضعیت داخلی را بخوانید.
مرجع endpointها ←Webhook
اتفاقات تماس را خودکار بگیرید؛ امضا را بررسی و رویداد را در CRM پردازش کنید.
قرارداد رویدادها ←CID Lookup
نام مخاطب را از دفترچه تلفن یا CRM، هنگام تماس و در گزارش نمایش دهید.
قرارداد شناسایی نام ←PBX V1 یا PBX V2؟#
برچسب بالای صفحه، نوع مرکز تماس مورد بحث را مشخص می‌کند. نوع مرکز را از پنل خود بررسی و مستندات همان نوع را انتخاب کنید؛ تغییر تب، مرکز تماس شما را ارتقا نمی‌دهد.
| موضوع | PBX V1 | PBX V2 |
|---|---|---|
| وب‌سرویس | قرارداد و مسیرهای فعلی V1 | API مستقل V2، فرمان قابل پیگیری و مسیر سازگاری |
| رویداد تماس | قرارداد قبلی وب‌هوک | قالب کامل یا سازگار، امضا، تلاش مجدد و تاریخچه تحویل |
| شناسایی نام | CID Lookup قبلی | دفترچه تلفن، cache و استعلام بیرونی با زمان محدود |
| شناسه تماس | شناسه‌های قرارداد V1 | call_id و leg_id از نوع UUID |
اگر مرکز V2 دارید و نرم‌افزار قبلی هنوز از مسیر v1 استفاده می‌کند، راهنمای سازگاری و تفاوت پاسخ‌ها را بخوانید.
از کجا شروع کنم؟#
- اتصال را در پنل فعال کنید.کلید وب‌سرویس یا URL وب‌هوک/CID را در ماژول همان مرکز تنظیم کنید.
- یک درخواست خواندنی ارسال کنید.با مثال دریافت وضعیت داخلی‌ها، کلید و دسترسی سرور خود را بررسی کنید.
- یک جریان کامل را پیاده کنید.برای کلیک برای تماس، operation_id را ذخیره و نتیجه واقعی را با call.connected و CDR دنبال کنید.
- خطا و تکرار را مدیریت کنید.Idempotency-Key درخواست و event_id رویداد از تماس یا پردازش تکراری جلوگیری می‌کنند.
هر راهنما نمونه cURL، Node.js یا PHP/Laravel، توضیح محدودیت‌ها و بخش عیب‌یابی دارد. کلیدها و secretها را فقط روی سرور برنامه خود نگه دارید.