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

تنظیم مسیر یک شماره

مسیر تماس ورودی یک شماره را ذخیره می‌کند.

PUThttps://api.irnoti.com/v1/voip/routes/{numberId}
scope: sms.send

config توصیف مسیر است (مقصد مستقیم، گروه زنگ، IVR یا شرط زمانی). اگر ضبط تماس در مسیر هست باید recordConsent: true بدهید؛ یعنی هر دو طرف از ضبط مطلع می‌شوند.

پارامترها

ناممحلنوعتوضیح
numberId *مسیرstringشناسهٔ شمارهٔ خریداری‌شده.
config *بدنهobjectپیکربندی مسیر.
recordConsentبدنهbooleanتأیید اعلام ضبط به طرفین.
enabledبدنهbooleanفعال/غیرفعال.

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

401unauthorizedکلید API نامعتبر یا منقضی است.
403insufficient_scopeکلید API دامنهٔ دسترسی لازم را ندارد.
400validation_errorورودی نامعتبر است (جزئیات در پاسخ).
404not_foundشماره پیدا نشد یا متعلق به شما نیست.

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

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

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

curl -X PUT 'https://api.irnoti.com/v1/voip/routes/9' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "config": {
    "to": [
      "09121234567"
    ],
    "type": "forward"
  },
  "enabled": true
}'
پاسخ نمونه200 OK
{
  "enabled": true,
  "numberId": "9"
}
تنظیم مسیر یک شماره — مستندات API | ایران ناتیفیکیشن