وبهوک وضعیت پیامک
بهجای استعلام مکرر وضعیت پیامک، آدرس سرور خودتان را در پنل نجوا ثبت کنید تا هر تغییر وضعیت خودکار برایتان ارسال شود.
بهجای فراخوانی مکرر دریافت وضعیت ارسال، میتوانید یک وبهوک تعریف کنید تا نجوا خودش، به ازای هر تغییر وضعیت پیامک، درخواستی به سرور شما بزند.
این راهنما از صفحهٔ عمومی مستندات فنی وبسرویسهای نجوا منتقل شده است. جدول کدهای وضعیت خودش از قبل و با جزئیات بیشتر در خطاها و کدهای وضعیت مستند شده؛ همان منبع را معتبر بدانید.
تنظیم آدرس وبهوک
در پنل نجوا، بخش «تنظیمات پیامک»، آدرس endpoint سرور خودتان و متد درخواست (GET یا POST) را مشخص کنید.
چه چیزی دریافت میکنید
به ازای هر تغییر وضعیت یک پیامک ارسالی، نجوا درخواستی با دو پارامتر زیر (در بدنهٔ درخواست) به آدرس شما میزند:
| پارامتر | توضیح |
|---|---|
messageid | شناسهٔ پیامکی که وضعیتش تغییر کرده |
status | وضعیت جدید پیامک — همان کدهای جدول وضعیت پیامک |
نمونهٔ بدنهٔ درخواست:
{ "messageid": 1234, "status": 10}درخواست وبهوک فقط یکبار فرستاده میشود. اگر سرور شما در آن لحظه پاسخ مناسب برنگرداند (مثلاً از دسترس خارج باشد)، نجوا دوباره تلاش نمیکند. برای اطمینان از اینکه هیچ تغییر وضعیتی را از دست نمیدهید، همچنان یک مکانیزم عقبافتاده (fallback) — مثلاً استعلام دورهای وضعیت پیامکهای اخیر — در کنار وبهوک داشته باشید.
گام بعدی
فهرست کامل کدهای وضعیت و اینکه کدامها نهاییاند را در خطاها و کدهای وضعیت ببینید.