بازگشت به فهرست

سرویس API پیامدهی

وردپرس — ووکامرس

وردپرس — ووکامرس

پیش از شروع، افزونهٔ مورد نیاز را نصب کنید:

مراحل: پنل وردپرس → افزونه → تب «سامانه پیامکی»

تنظیمات دیجیتس (Digits)

  1. درگاه پیامکی: درگاه سفارشی / Custom Gateway
  2. Gateway URL: https://api.homais.com/services/messaging/sms/api/sendMessage/direct/
  3. HTTP Headers: خالی
  4. HTTP Method: GET
  5. Query Parameters:
    username:YOUR_API_TOKEN, password:, PortalCode:YOUR_PORTALCODE, mobile:{to}, message:{message}, ServerType:100
  6. Send as Body Data: No
  7. Encrypt Message: No
  8. Phone Number: با + و کد کشور — مثال: +989121234567
  9. Sender ID: اختیاری — خالی
  10. OTP Template: Your OTP for {NAME} is {OTP}

نگاشت متغیرها:

  • {to} → شماره موبایل
  • {message} → متن پیام
  • {otp} / {OTP} → کد تایید
  • {NAME} → نام سایت

تنظیمات ووکامرس

سرویس Homais.com یا Negins.com را انتخاب کنید:

  • نام کاربری و رمز عبور پنل
  • Portal / From / senderNumber: کد پرتال
  • ServerType: 99 برای ارسال به لیست سیاه

نکات

  • برای اتصال نرم‌افزارهای حسابداری از بخش «اتصال سایر نرم‌افزارها» استفاده کنید: نام کاربری = توکن API، کد پرتال = پارامتر PortalCode.
  • اتصال مستقیم فقط وقتی ممکن است که نرم‌افزار اجازه تعریف URL و پارامترهای دلخواه را بدهد؛ در غیر این صورت افزونه/واسط اختصاصی لازم است.
  • ServerType=100 برای ارسال عمومی و OTP (لیست سیاه مخابرات) توصیه می‌شود.
  • پاسخ موفق: عدد بزرگ‌تر از ۱۰۰۰؛ هر عدد دیگر کد خطاست.
  • برای پیام حاوی لینک یا ارسال از شماره عمومی، پروفایل WhoIS باید تکمیل و تأیید شده باشد.
  • برای تست سریع REST API، URL را با پارامترها در مرورگر باز کنید.
  • در صورت خطا، کد بازگشتی و ServerType را در تیکت پشتیبانی ذکر کنید.