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

شبیه‌سازی تماس روی بوم

مسیر یک تماس فرضی را روی نمودار دنبال می‌کند.

POSThttps://api.irnoti.com/v1/voip/flows/{numberId}/simulate
scope: sms.read

بدون ایجاد تماس واقعی. keys کلیدهای فشرده‌شده، unanswered گره‌هایی که پاسخ نمی‌دهند و at زمان فرضی (برای شرط زمانی). سقف ۱۲۰ در دقیقه.

پارامترها

ناممحلنوعتوضیح
numberId *مسیرstringشناسهٔ شماره.
graphبدنهobjectنمودار آزمایشی؛ بدون آن، پیش‌نویس ذخیره‌شده.
atبدنهstring (ISO 8601)زمان فرضی.
keysبدنهstring[]کلیدهای فشرده‌شده به ترتیب.
unansweredبدنهstring[]شناسهٔ گره‌های بی‌پاسخ.

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

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

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

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

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

curl -X POST 'https://api.irnoti.com/v1/voip/flows/9/simulate' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "at": "2026-11-01T09:00:00Z",
  "keys": [
    "1"
  ]
}'
پاسخ نمونه200 OK
{
  "steps": [
    {
      "node": "start"
    },
    {
      "key": "1",
      "node": "menu"
    },
    {
      "node": "ring-group"
    }
  ],
  "outcome": "answered"
}
شبیه‌سازی تماس روی بوم — مستندات API | ایران ناتیفیکیشن