ایران ناتیفیکیشن

برقراری تماس (Click-to-Call)

ابتدا با `from` تماس می‌گیرد و پس از پاسخ، به `to` وصل می‌کند.

POSThttps://api.irnoti.com/v1/voip/calls
scope: sms.send

ضبط تماس فقط با recordConsent: true مجاز است (سامانه به دو طرف اعلام می‌کند). سقف ۲۰ درخواست در دقیقه.

پارامترها

ناممحلنوعتوضیح
from *بدنهstringشمارهٔ اول (۱۰ تا ۱۵ رقم).
to *بدنهstringشمارهٔ مقصد.
callerIdبدنهstringشمارهٔ نمایشی از خطوط خودتان.
projectIdبدنهstringپروژه.
recordبدنهbooleanضبط تماس.
recordConsentبدنهbooleanتأیید اطلاع‌رسانی ضبط به طرفین؛ با record الزامی است.

خطاهای خاص این endpoint

400validation_errorrecord بدون recordConsent.
402insufficient_balanceاعتبار کافی نیست.

اجرای زنده (محیط تست)

باز کردن در کنسول کامل ←

این endpoint در محیط تست پشتیبانی نمی‌شود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.

curl -X POST 'https://api.irnoti.com/v1/voip/calls' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "to": "02112345678",
  "from": "09121234567"
}'
پاسخ نمونه200 OK
{
  "id": "501",
  "status": "ringing"
}
برقراری تماس (Click-to-Call) — مستندات API | ایران ناتیفیکیشن