شروع کار
وضعیت پیام‌ها
هر ردیف entries در پاسخ متدهای ارسال و گزارش یک فیلد status دارد که مرحله فعلی آن پیام را نشان می‌دهد.
این مقدار با return.status فرق دارد: آن یکی نتیجه درخواست است و این یکی سرنوشت یک پیام.
مقادیر status
| مقدار | وضعیت | توضیح |
|---|---|---|
| 1 | در صف ارسال | پیام ثبت شده و منتظر ارسال است. |
| 2 | زمان‌بندی‌شده | پیام در زمان تعیین‌شده با date ارسال می‌شود. |
| 4 | ارسال به مخابرات | پیام به اپراتور تحویل شده است. |
| 5 | ارسال به مخابرات | مشابه 4. |
| 6 | خطا در ارسال نهایی | اپراتور پیام را نپذیرفت و پیام به گیرنده نرسید. |
| 10 | رسیده به گیرنده نهایی | گزارش تحویل از گوشی گیرنده دریافت شد. |
| 11 | نرسیده به گیرنده نهایی | گوشی گیرنده خاموش یا خارج از دسترس بود. |
| 13 | لغو شده نهایی | ارسال لغو شد یا با خطا مواجه شد. هزینه به حساب برمی‌گردد. |
| 14 | بلاک شده نهایی | گیرنده دریافت پیام تبلیغاتی را مسدود کرده است. هزینه به حساب برمی‌گردد. |
| 100 | شناسه نامعتبر نهایی | شناسه وجود ندارد، بایگانی شده یا متعلق به حساب دیگری است. |
پیگیری تحویل
- بلافاصله پس از ارسال، وضعیت معمولا ۱ (در صف) یا ۵ (ارسال به مخابرات) است. گزارش تحویل معمولا ظرف چند ثانیه تا چند دقیقه می‌رسد.
- وضعیت‌های «نهایی» دیگر تغییر نمی‌کنند. پیام‌هایی را که هنوز در وضعیت غیرنهایی هستند، با فاصله چند دقیقه و به‌صورت دسته‌ای (تا ۵۰۰ شناسه در هر درخواست) با sms/status بررسی کنید، نه با یک درخواست برای هر پیام.
- sms/status فقط ۴۸ ساعت اخیر را پوشش می‌دهد؛ وضعیت نهایی را در سیستم خودتان ذخیره کنید.
- در وضعیت‌های ۱۳ و ۱۴ هزینه پیام به اعتبار حساب برمی‌گردد.
انواع نمایش پیام (type)
پارامتر type در sms/send نحوه نمایش پیام روی گوشی گیرنده را تعیین می‌کند و فقط روی خطوط ۳۰۰۰ اثر دارد.
| مقدار | نحوه نمایش |
|---|---|
| 0 | فلش: پیام مستقیم روی صفحه نمایش داده می‌شود و در گوشی ذخیره نمی‌شود. |
| 1 | عادی: در حافظه گوشی ذخیره می‌شود (پیش‌فرض). |
| 2 | روی سیم‌کارت ذخیره می‌شود. |
| 3 | در برنامه مشخصی روی گوشی یا رایانه متصل ذخیره می‌شود. |