ارسال با لینک کوتاه ردیابیشده
پیامک حاوی لینک کوتاه یکتا برای هر گیرنده؛ کلیکها شمارش میشود و میتوانید آزمون A/B بگیرید.
POST
scope: sms.sendhttps://api.irnoti.com/v1/link-tracker/sendمتن باید جای لینک را با {link} نشان دهد. برای هر گیرنده یک کد ۸ نویسهای ساخته میشود و https://…/l/{code} پس از ثبت کلیک به url هدایت میکند.
**آزمون A/B:** تا دو نسخهٔ دیگر در variants بدهید. بخشی از مخاطبان (holdoutPercent، ۱۰ تا ۷۰) نگه داشته میشود؛ پس از decideAfterMinutes (۱۵ تا ۱۰٬۰۸۰ دقیقه) نسخهای که کلیک بیشتری گرفته برای بقیه ارسال میشود. با POST /link-tracker/holdouts/{id}/send-now میتوانید زودتر تصمیم بگیرید.
نیاز به احراز هویت کامل حساب و امکان «لینکساز» در گروه کاربری شما دارد. سقف ۶۰ درخواست در دقیقه.
پارامترها
| نام | محل | نوع | توضیح |
|---|---|---|---|
| lineId * | بدنه | string | شناسهٔ خط فرستنده. |
| text * | بدنه | string | متن پیام (حداکثر ۹۰۰ نویسه) با {link}. |
| url * | بدنه | string | نشانی مقصد (http/https، حداکثر ۵۰۰ نویسه). |
| variants | بدنه | string[] | تا ۲ نسخهٔ دیگرِ متن برای آزمون A/B. |
| holdoutPercent | بدنه | integer | درصد مخاطبانِ نگهداشته برای ارسال برندهٔ آزمون (۱۰ تا ۷۰). |
| decideAfterMinutes | بدنه | integer | پس از چند دقیقه برنده تعیین شود (۱۵ تا ۱۰٬۰۸۰). |
| to | بدنه | string[] | شمارههای گیرنده (حداکثر ۱۰٬۰۰۰). |
| groupIds | بدنه | string[] | گروههای دفترچه تلفن. حداقل یکی از to یا groupIds الزامی است. |
خطاهای خاص این endpoint
| 401 | unauthorized | کلید API نامعتبر یا منقضی است. |
| 403 | insufficient_scope | کلید API دامنهٔ دسترسی لازم را ندارد. |
| 400 | validation_error | ورودی نامعتبر است (جزئیات در پاسخ). |
| 402 | insufficient_balance | اعتبار کافی نیست. |
| 403 | feature_locked | امکان لینکساز برای گروه کاربری شما فعال نیست یا احراز هویت کامل نشده است. |
| 429 | rate_limited | تعداد درخواست از سقف مجاز بیشتر شد؛ پس از زمان Retry-After دوباره تلاش کنید. |
اجرای زنده (محیط تست)
باز کردن در کنسول کامل ←این endpoint در محیط تست پشتیبانی نمیشود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.