راهنمای نصب و راه اندازی افزونه دیجیتس | Digits

راهنمای نصب و راه اندازی افزونه دیجیتس | Digits

  1. ابتدا افزونه Digits را از لینک زیر دانلود کنید.
    دانلود مستقیم
  2. سپس وارد زیرمنوی افزودن در منوی افزونه ها شوید.
  3. در بالای صفحه دکمه "بارگزاری افزونه" را میزنیم تا فایل دانلود شده را آپلود کنیم.
  4. بعد از نصب افزونه منوی جدیدی به نام "Digits" در لیست منوها ایجاد خواهد شد.

تعریف الگوی اعتبارسنجی

برای استفاده از سرویس اعتبارسنجی digits باید در پنل کاوه نگار الگو اعتبارسنجی تایید شده داشته باشید.
  1. برای استفاده از سرویس اعتبارسنجی کاوه نگار ابتدا وارد حساب کاربری خود شوید، سپس از طریق منوی اعتبارسنجی وارد منوی "لیست الگوهای تعریف شده" شوید.
  2. روی دکمه + کلیک کنید تا به صفحه ایجاد الگو منتقل شوید.

در صفحه تعریف الگوی اعتبارسنجی باید اقدامات زیر را انجام دهید:

  1. نام الگو: یک نام برای الگوی اعتبارسنجی خود به صورت لاتین اختصاص دهید.

  2. اولویت ارسال: میتوانید مشخص کنید که پیام ارسالی از طریق پیامک صوتی ارسال شود و یا به صورت پیام متنی.

  3. درخواست مجدد در بازی زمانی 2 دقیقه ارسال میکند: در صورتی که اولویت ارسال را بر روی "ارسال پیامک" قرار داده اید، باید در این بخش "غیرفعال" را انتخاب کنید.

  4. قالب الگو را در بخش متن الگوی پیامک تعریف نمایید.

    لطفا دقت کنید که در قسمت نمایش خروجی الگو باید علامت درصد قبل از token قرار بگیرد مثل تصویر( به صفحه نمایش گوشی در تصویر نگاه کنید).
  5. در پایان این الگو را از طریق دکمه "ذخیره اطلاعات" ثبت نمایید و منتظر فعال سازی این الگو بمانید.

راه اندازی سرویس اعتبارسنجی (Verify Lookup) در افزونه Digits

  1. ابتدار وارد منوی Digits شوید.

  2. سپس در فیلد "سامانه پیامکی" گزینه KaveNegar را انتخاب نمایید . (در صورتی که گزینه Kavenegar در لیست سامانه های پیامکی وجود ندارد باید از طریق درگاه Custom اقدام به راه اندازی افزونه نمایید.)

  3. در قسمت KaveNegar API کد API_KEY حساب کاربری خود را وارد نمایید.(میتوانید وارد حساب کاربری خود در پنل کاوه نگار شوید و از منوی حساب من کد API_KEY خود را دریافت نمایید).

  4. در قسمت شماره ارسال کننده سامانه پیامک یک شماره سامانه پیامکی را وارد کنید.(شماره میتوانید اختصاصی باشد و یا اشتراکی)

  5. Send as pattern(optional) اگر میخواهید از سرویس اعتبارسنجی استفاده کنید، مقدار این پارامتر را برابر 1 قرار دهید( در بعضی نسخه ها باید برابر مقدار "بله" قرار دهید) در غیر این صورت این قسمت را خالی بگذارید ( در بعضی از نسخه ها برابر "خیر" قرار دهید).

  6. شماره قالب، همان نام الگوی تعریف شده در پنل کاوه نگار می باشد که باید در این فیلد قرار دهید.

  7. زمانی که از اعتبارسنجی ماژول Digits استفاده میکنید، فیلد نمونه متن تاثیری در تنظیمات ندارد اما در صورتی که مقدار Send as pattern(optional) را خالی بگذارید، متن موجود در بخش نمونه متن در هنگام ثبت نام به کاربران ارسال میشود اما با استفاده از متد Send به جای متد Lookup. (پارامتر OTP به معنی کد فعال سازی است که میتوانید در نمونه متن استفاده کنید.)

راه اندازی سرویس اعتبارسنجی در افزونه Digits با استفاده از درگاه Custom

  1. در قسمت سامانه پیامکی مقدار Custom را انتخاب نمایید.

    افزونه دییجتس برای کاوه نگار
  2. در قسمت SMS Gateway URL باید لینک درخواست API برای متد Lookup را به همراه شناسه API-KEY خود در کاوه نگار را قرار دهید.

    برای این منظور باید کد API-KEY را به جای مقدار {api-key} در لینک زیر قرار دهید و سپس لینک را در قسمت SMS Gateway URL قرار دهید.

    http://api.kavenegar.com/v1/{api-key}/verify/lookup.json

    مثال:
    شناسه API-KEY:

    6A6F365074367A4852104E48447546775A686F796D787A642F33536RCVB683872374F374335553D

    لینک نهایی:

    http://api.kavenegar.com/v1/6A6F365074367A4852104E48447546775A686F796D787A642F33536RCVB683872374F374335553D/verify/lookup.json

    لینک نهایی همان لینکی است که باید در قسمت SMS Gateway URL قرار دهید.

    افزونه دییجتس برای کاوه نگار
  3. مقادیر HTTP Header و HTTP Method نیازی به تغییر ندارند.

  4. مقدار فیلد Gateway Parameters را باید طبق روش زیر قرار دهید.به این گونه که فقط به جای عبارت {TEMPLATE-NAME} نام الگویی را که در پنل کاوه نگار ایجاد کرده اید را قرار دهید.

    receptor:{to},token:{message},template:{TEMPLATE-NAME}
    مثال:
    نام الگوی اعتبارسنجی در پنل کاوه نگار:

    verify

    مقدار نهایی:

    receptor:{to},token:{message},template:verify

    مقدار نهایی را باید در قسمت Gateway Parameters قرار دهید.

    افزونه دییجتس برای کاوه نگار
  5. مقادیر Send as Body Data و Encode Message نیازی به تغییر ندارند.

  6. مقدار Phone Number را برای ارسال های غیر از بین المللی روی مقدارWith out Country Code قرار دهید.
  7. مقدار شناسه ارسال کننده نیازی به تغییر ندارد.

  8. مقدار نمونه متن را باید برابر مقدار {OTP} دهید.

    افزونه دییجتس برای کاوه نگار