راهنمای نمایش تماس ورودی در دیدار

 

برای اینکه کاربران هنگام دریافت تماس ورودی از طریق سیستم VoIP بتوانند آن تماس را در دیدار مشاهده کنند، سه مرحله مهم باید انجام شود:

 

 

 

⚙️ مرحله اول:فعال سازی ویپ در دیدار #

شما به منظور اتصال تلفن ویپ خود به دیدار نیاز به کلید api  دارید که برای دریافت api key  خود وارد پنل کاربری خود در سی ار ام دیدار شوید و به بخش تنظیمات وارد شوید سپس از منوی باز شده در سمت راست گزینه اتصال به سرورهای دیگر را انتخاب نموده و سپس از بخش اصلی صفحه وارد تب ویپ (کالر آی دی) شوید.

 

از فعال بودن گزینه کالر آیدی مطمئن شوید و کلید api key خود را کپی کنید که در مراحل بعدی مورد استفاده قرار خواهد گرفت.

⚙️ مرحله دوم: تنظیمات در پنل دیدار #

وارد پنل کاربری خود در دیدار شوید و مراحل زیر را دنبال کنید:

با کلیک روی دکمه کالر‌آیدی واقع در بالا سمت راست پنل کاربری به بخش تنظیمات کالر آیدی بروید

1. در پنجره باز شده، گزینه‌های زیر را فعال یا غیر فعال کنید
   
   • • • همه تماس ها را نمایش بده
       
     • • تماس‌های مربوط به خودم را نمایش بده
       
     • • تماس‌های ثبت‌نشده را نمایش بده
       
     • • تماس‌های داخلی را نمایش بده
       
       
2. در صورت استفاده از داخلی خاص (مثلاً 101 یا 220)، در قسمت شماره داخلی 1، 2، 3، شماره داخلی های مورد نظر که میخواهید در دیدار شما فعال باشند را وارد کنید.
   
   
3. مدت زمان نمایش پنجره تماس را به دلخواه تنظیم کنید (مثلاً 15 ثانیه).
   
   
4. روی دکمه ذخیره تنظیمات کلیک کنید.

تصویر زیر نمونه‌ای از تنظیمات صحیح را نمایش می‌دهد:

⚙️ مرحله سوم : فراخوانی API تماس ورودی  (تنظیمات سرور ویپ) #

پس از برقراری تماس ورودی از سمت VoIP، شما (یا سیستم شما) باید به صورت خودکار API دیدار را فراخوانی کنید.

 

 

آدرس API:

https://app.didar.me/api/calllog/insert

شما برای ارسال درخواست فراخوانی به این آدرس نیاز به api key دارید که این کلید با کلیدی که برای ارسال درخواست ها به api های بخش های مختلف سی ار ام دیدار ارسال میکنید متفاوت است. 

پارامترها:

پارامتر	توضیح
apikey	کلید API دریافتی از دیدار
number	شماره تماس گیرنده مثلاً: 09364502475
internalnumber	شماره داخلی که تماس به آن رسیده مثلاً: 220

نمونه فراخوانی:

https://app.didar.me/api/calllog/insert?apikey=XXXXX&number=09364502475&internalnumber=220

⛔ نکته مهم:

اگر مرحله API فراخوانی نشود، حتی با تنظیمات صحیح در پنل دیدار، تماس ورودی نمایش داده نخواهد شد.

توجه داشته باشید که مرحله سوم باید در پنل ویپ شرکت شما تنظیم شود و همچنین در سیستم های ویپ این گزینه بسیار متنوع می باشد. برخی سیستم های ویپ، در پنل کاربری خود، قسمتی را در اختیار شما قرار میدهند که میتوانید آدرس فراخوانی api را قرار دهید و در صورتی که این اینترفیس در ویپ شما موجود نباشد، باید از سرویس دهنده ویپ خود بخواهید که این تنظیم را برای شما انجام دهند.

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

🧪 تست تنظیمات دیدار و VoIP #

✅ تست عملکرد دیدار با استفاده از دستور curl #

برای اطمینان از اینکه تنظیمات در پنل دیدار به‌درستی انجام شده است و API نیز به‌درستی پاسخ می‌دهد، می‌توانید با اجرای دستور زیر در ترمینال، یک تماس فرضی را ارسال کنید:

curl -X POST “https://app.didar.me/api/calllog/insert?apikey=XXXXX&number=09364502475&internalnumber=220“

 

نکته:
حتماً به‌جای XXXXX مقدار واقعی کلید API خود را وارد کنید.

اگر همه تنظیمات به‌درستی انجام شده باشد، پس از ارسال این درخواست، یک پاپ‌آپ تماس ورودی در دیدار نمایش داده می‌شود.

✅ تست ارسال اطلاعات از سمت VoIP (تست Webhook) #

برای بررسی اینکه سیستم VoIP شما اطلاعات تماس ورودی را به‌درستی ارسال می‌کند، می‌توانید از ابزار آنلاین webhook.site استفاده کنید:

مراحل:

1. وارد سایت webhook.site شوید.
   
   
2. یک URL اختصاصی به شما نمایش داده می‌شود – مثلاً https://webhook.site/abcd1234
   
   
3. در تنظیمات VoIP، این URL را به عنوان مقصد ارسال اطلاعات تماس (Webhook URL) وارد کنید.
   
   
4. حالا یک تماس آزمایشی برقرار کنید.
   
   
5. در صفحه Webhook، داده‌های ارسال‌شده توسط VoIP به صورت real-time نمایش داده می‌شود.
   
   

مزیت این روش:

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