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

ساخت IVR

منوی صوتی جدید.

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

برای طراحی دیداری از بوم (/voip/flows) هم می‌توانید استفاده کنید.

پارامترها

ناممحلنوعتوضیح
name *بدنهstringنام (≤۸۰).
tree *بدنهobjectدرخت منو: پیام خوش‌آمد، گزینه‌ها (کلید ۰ تا ۹) و مقصد هر کدام.

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

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

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

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

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

curl -X POST 'https://api.irnoti.com/v1/voip/ivrs' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "منوی اصلی",
  "tree": {
    "prompt": {
      "text": "برای فروش یک و برای پشتیبانی دو را بزنید",
      "type": "tts"
    },
    "options": {
      "1": {
        "to": [
          "09121234567"
        ],
        "type": "forward"
      },
      "2": {
        "id": "4",
        "type": "group"
      }
    }
  }
}'
پاسخ نمونه200 OK
{
  "id": "6",
  "name": "منوی اصلی"
}
ساخت IVR — مستندات API | ایران ناتیفیکیشن