زیرساخت پیام زمان‌دار برای برنامه‌نویس‌ها

• اپ یا کلینیکی که نمی‌خواهد زیرساخت پیامک / تلگرام / بله بسازد
• نیاز به ارسال یک‌باره یا زمان‌بندی‌شده (همین الان یا بعداً)
• ترجیح می‌دهد هزینه و ارسال روی کانال‌های لیاد باشد

اگر پیام تکراری پیچیده و ارسال روی سرور خودتان می‌خواهید، از مسیر پیشرفته API و قرارداد وب‌هوک استفاده کنید.

پیامک، بله، ایتا و روبیکا از مسیر مدیریت‌شده لیاد ارسال می‌شوند. تلگرام و واتساپ: به‌زودی.

برای پیامک و تلگرام وب‌هوک لازم نیست؛ لیاد با ریل خودش ارسال می‌کند.

1. از صفحهٔ درخواست توکن دسترسی بگیرید و توکن liad_live_… را دریافت کنید.
2. به آدرس پایهٔ API درخواست بزنید: https://liad.liom.app/api/v1
3. هدر احراز هویت: Authorization: Bearer …
4. یک درخواست POST /messages با گیرنده، متن و زمان بفرستید.

۱) پیامک: همین الان

POST /v1/messages
Authorization: Bearer liad_live_…
Content-Type: application/json

{
  "channel": "sms",
  "mobile": "09121234567",
  "text": "وقت مصرف قرص فشار",
  "sendAt": "now"
}

۲) تلگرام: به‌زودی

به‌زودی

۴) بله: همین الان

{
  "channel": "bale",
  "mobile": "09121234567",
  "text": "وقت مصرف قرص فشار",
  "sendAt": "now"
}

۳) پیامک: زمان‌بندی برای بعد

{
  "channel": "sms",
  "mobile": "09121234567",
  "text": "یادآوری ویزیت فردا ساعت ۱۰",
  "sendAt": "2026-08-27T10:00:00+03:30"
}

اگر channel را ننویسید، پیش‌فرض sms است.

{
  "message": {
    "id": "…",
    "channel": "sms",
    "mobile": "09121234567",
    "text": "وقت مصرف قرص فشار",
    "sendAt": "2026-08-26T14:00:00+00:00",
    "status": "queued",
    "delivery": "liad_managed",
    "timezone": "Asia/Tehran",
    "createdAt": "…"
  }
}

وضعیت‌ها: queued (به‌زودی) · scheduled (زمان آینده) · sent · failed · skipped

پیگیری وضعیت: GET /v1/messages/{id}

• قرارداد ماشین‌خوان: openapi.yaml (تگ Messages)
• در تلاش مجدد، هدر Idempotency-Key بفرستید تا پیام تکراری ساخته نشود.
• خطاها JSON هستند: { "error": { "code", "message", "message_fa" } }
• این مسیر جایگزین مدل پیشرفته نیست؛ فقط حالت ساده را اضافه می‌کند.