متن ثابت، متغیر کنترلشده و شناسه قابل پیگیری
پیامک الگو یا Pattern چیست و کجا استفاده میشود؟
در ارسال الگویی، مشتری متن آزاد نمیفرستد. هدف پیام، متن ثابت، نام برند و متغیرها پیش از فعالسازی بررسی میشوند؛ سپس یک UID اختصاصی صادر میشود و نرمافزار فقط شناسه قالب، گیرنده و مقادیر مجاز را ارسال میکند.
فعالسازی رایگان۳۰۰ تومان تکبخشیUID اختصاصیکنترل متغیرهاگزارش وضعیت
چرخه عمر قالب
از ایده تا ارسال واقعی
قالب یک دارایی نسخهدار است؛ تغییر متن ثابت یا هدف باید قابل ردیابی و دوباره بررسی شود.
DraftSubmittedUnderReviewActiveSuspendedRejectedArchived
قواعدی که جلوی خطا و سوءاستفاده را میگیرند
متغیر فقط جای خالی متن نیست
نام، نوع داده، طول، نمونه و قواعد هر متغیر باید تعریف شود و متن نهایی قبل از ورود به صف دوباره اعتبارسنجی گردد.
قواعد متن ثابت
- نام برند یا فرستنده روشن باشد.
- هدف پیام دقیق و غیرتبلیغاتی باشد.
- پیام مبهم یا قابل استفاده برای چند هدف پذیرفته نشود.
- لینک فقط از دامنه تأییدشده و مرتبط با همان خدمت باشد.
- متن تا حد امکان تکبخشی و خوانا طراحی شود.
قواعد متغیرها
- نام متغیر ثابت، یکتا و قابل فهم باشد.
- نوع داده مانند عدد، تاریخ، مبلغ، کد یا متن کوتاه مشخص شود.
- حداقل و حداکثر طول و الگوی مجاز تعریف شود.
- مقدار Null، خالی، newline و کاراکترهای کنترلشده مدیریت شود.
- متغیرها نباید متن تبلیغاتی یا لینک نامرتبط حمل کنند.
قواعد نسخهبندی
- هر تغییر متن ثابت نسخه جدید ایجاد کند.
- نسخه فعال هر ارسال ثبت شود.
- Rollback بدون حذف تاریخچه امکانپذیر باشد.
- قالب قدیمی پس از مهلت مهاجرت Archive شود.
- تغییر نوع متغیر Breaking Change محسوب شود.
کنترل زمان ارسال
- مالک UID و وضعیت Active بررسی شود.
- همه متغیرهای ضروری وجود داشته باشند.
- مقصد، Rate Limit و سقف مالی کنترل شوند.
- متن نهایی دوباره از نظر واژه، لینک و طول بررسی شود.
- Idempotency از پیام و هزینه تکراری جلوگیری کند.
قرارداد API پیشنهادی
شناسه قالب بهجای متن آزاد
templateUid
شناسه نسخه فعال و متعلق به همان حساب.
to
شماره نرمالسازیشده و مجاز برای کاربرد تأییدشده.
variables
دیکشنری نام و مقدار با Schema مشخص.
idempotencyKey
شناسه یکتا برای جلوگیری از ارسال دوباره در Retry.
POST /v1/pattern-messages
{
"templateUid": "PAT-ORDER-READY-V2",
"to": "0912xxxxxxx",
"variables": {"orderId":"4821","branch":"مرکزی"},
"idempotencyKey": "order-4821-ready"
}
{
"templateUid": "PAT-ORDER-READY-V2",
"to": "0912xxxxxxx",
"variables": {"orderId":"4821","branch":"مرکزی"},
"idempotencyKey": "order-4821-ready"
}
پاسخ باید trackingCode، templateVersion، parts، chargedAmount و وضعیت اولیه را برگرداند. متن رندرشده در Audit ذخیره میشود، اما Secretها و OTP خام نباید وارد Log شوند.
ایدهیاب Pattern
بیش از ۳۰ کاربرد آماده برای پروژه شما
براساس حوزه یا پلتفرم فیلتر کنید و نمونه قالب و متغیرهای لازم را ببینید.
در حال بارگذاری کاربردها…
تفکیک خدماتی و تبلیغاتی
Pattern مجوز تبلیغ پنهان نیست
پیام از سفارش، پرداخت، نوبت، حساب، دستگاه یا فرایند مورد انتظار مخاطب ایجاد میشود.
پیام خدماتی که پیشنهاد فروش، کد تخفیف یا دعوت بازاریابی دارد باید جداگانه ارزیابی شود.
معرفی محصول، فروش ویژه و پیام عمومی باید از مسیر تبلیغاتی و با رعایت رضایت ارسال شود.
عملیات و پایش
قالب فعال هم نیازمند مراقبت است
نرخ خطای متغیر
مقادیر خالی، نوع نادرست، طول بیش از حد و Schema ناسازگار اندازهگیری شوند.
نرخ رد محتوا
تلاش برای قراردادن تبلیغ، لینک ناشناس یا واژه ممنوع در متغیرها ثبت شود.
نرخ تحویل
Accepted، Delivered، Failed و Expired برای هر قالب و نسخه جدا گزارش شوند.
هزینه هر سناریو
تعداد بخش، هزینه، Retry و پیام تکراری براساس UID و مشتری پایش شوند.
شکایت و عدم رضایت
افزایش Block، Report یا درخواست لغو میتواند باعث تعلیق و بازبینی قالب شود.
تغییر رفتار مصرف
جهش حجم، مقصدهای غیرعادی و استفاده خارج از الگوی تاریخی هشدار ایجاد کند.
پرسشهای رایج
پیش از ثبت الگو بدانید
آیا هر مشتری UID اختصاصی دارد؟
بله. UID باید به حساب، هدف و نسخه قالب متصل باشد و مشتری دیگر نتواند بدون مجوز از آن استفاده کند.
اگر یک متغیر خالی باشد چه میشود؟
رفتار باید در Schema مشخص باشد؛ متغیر ضروری رد میشود و متغیر اختیاری باید مقدار جایگزین کنترلشده داشته باشد. ارسال مقدار خالی نباید متن شکسته یا پیام مبهم تولید کند.
آیا میتوان متغیر را به متن آزاد تبدیل کرد؟
خیر. متغیر متن کوتاه نیز باید طول، واژه و کاربرد محدود داشته باشد. قرار دادن کل متن پیام در یک متغیر فلسفه Pattern را از بین میبرد.
قیمت ارسال الگویی چقدر است؟
ثبت و فعالسازی اولیه رایگان است و هر پیام فارسی تکبخشی ۳۰۰ تومان محاسبه میشود. پیام چندبخشی به تعداد بخشها محاسبه خواهد شد.
فرق OTP و Pattern عمومی چیست؟
OTP یک کاربرد امنیتی کوتاه و تکمنظوره است و در SMSDaily نرخ ۲۵۰ تومان دارد. Pattern عمومی برای اعلان سفارش، پرداخت، نوبت، دستگاه و سایر پیامهای خدماتی با نرخ ۳۰۰ تومان ارائه میشود.
آیا میتوان یک قالب را برای چند برند استفاده کرد؟
نام برند بهتر است در متن ثابت باشد. استفاده از نام برند متغیر ریسک جعل هویت و سوءاستفاده را افزایش میدهد و فقط با مدل نمایندگی کنترلشده و بررسی جداگانه قابل تصور است.
الگوی خدماتی خود را رایگان ثبت کنید
هدف پیام، متن ثابت، متغیرها، نمونه مقادیر و حجم ماهانه را ارسال کنید. پس از تأیید، UID اختصاصی برای اتصال API صادر میشود.