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

ساخت گروه زنگ

گروه زنگ جدید.

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

سپس در مسیر شماره یا IVR به آن ارجاع بدهید.

پارامترها

ناممحلنوعتوضیح
name *بدنهstringنام گروه (≤۸۰).
strategyبدنهstringروش زنگ؛ پیش‌فرض ring_all (همه هم‌زمان).
members *بدنهstring[]شماره‌ها یا sip:<شناسه حساب> (۱ تا ۲۰ عضو).
ringTimeoutSecبدنهintegerمهلت زنگ (۵ تا ۱۲۰ ثانیه، پیش‌فرض ۲۵).

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

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

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

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

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

curl -X POST 'https://api.irnoti.com/v1/voip/groups' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "پشتیبانی",
  "members": [
    "09121234567",
    "sip:2"
  ],
  "ringTimeoutSec": 25
}'
پاسخ نمونه200 OK
{
  "id": "4",
  "name": "پشتیبانی"
}
ساخت گروه زنگ — مستندات API | ایران ناتیفیکیشن