مستندات افزونه وردپرس
راهنمای کامل افزونه وردپرس ویکیپیام
این راهنما مراحل انتخاب، نصب، فعالسازی و اتصال افزونه وردپرس ویکیپیام به پنل پیامکی را پوشش میدهد؛ از دریافت توکن API تا تنظیم پیامک مدیر، پیامک کاربر، ووکامرس، فرمسازها، OTP، گزارش ارسال و خطاهای رایج.
دانلود مستقیم در حال حاضر فعال نیست
مسیر فایل ZIP در بخش عمومی پروژه موجود نیست؛ بنابراین لینک دانلود مستقیم غیرفعال شده تا کاربر به صفحه 404 نرسد. برای دریافت نسخه فعلی افزونه، درخواست خود را از پشتیبانی ثبت کنید.
افزونه برای چه سایتهایی مناسب است؟
سایتهای وردپرسی، فروشگاههای ووکامرس، سایتهای آموزشی، فرمسازها، باشگاه مشتریان، کمپینهای پیامکی و هر سایتی که به OTP یا اطلاعرسانی پیامکی نیاز دارد.
پیشنیازها
وردپرس فعال، دسترسی مدیر سایت، حساب ویکیپیام، توکن API از مسیر پروفایل من و خط ارسالکننده معتبر برای ارسال پیامک.
مراحل اصلی
دریافت فایل افزونه از پشتیبانی، نصب ZIP در وردپرس، فعالسازی افزونه، ثبت Token، تست اتصال، تنظیم پیامک مدیر و کاربر، سپس فعالسازی کاربردهای ووکامرس، فرمها و OTP.
همه امکانات پیامکی وردپرس، در یک افزونه
افزونه ویکی پیام برای وردپرس و ووکامرس طراحی شده تا مدیر سایت بدون نصب چند ماژول جداگانه، پیامک، OTP، اطلاعرسانی سفارش، فرمها، کمپین، صفحه ادامه پیامک، گزارش ارسال و مدیریت اعتبار را از یک مرکز واحد کنترل کند.
{{customer_name}} عزیز، سفارش {{order_id}} با موفقیت ثبت شد. مبلغ: {{order_total}}
شروع سریع در ۵ دقیقه
از طریق فایل ZIP افزونه پس از نهاییسازی در همین بخش قرار میگیرد. تا آن زمان برای دریافت فایل، از طریق پشتیبانی ویکیپیام درخواست بدهید.
با دریافت موجودی، ارتباط API را بررسی کنید.
OTP، ووکامرس، فرمها و اعلانها را روشن کنید.
یک پیامک تست ارسال و لاگ را بررسی کنید.
مسیر نصب در وردپرس
پیشخوان وردپرس ← افزونهها ← افزودن ← بارگذاری افزونه ← انتخاب فایل ZIP افزونه ویکی پیام
امکانات اصلی افزونه
هر ماژول بهصورت مستقل فعال/غیرفعال میشود تا سایت سبک و قابل مدیریت بماند.
OTP ورود و ثبتنام
ورود با موبایل، بازیابی رمز، محدودیت تلاش و جلوگیری از سوءاستفاده.
ووکامرس کامل
پیامک ثبت سفارش، تغییر وضعیت، سفارش مدیر، کد رهگیری و یادآوری پرداخت.
فرمسازها
اتصال به Contact Form 7، Elementor Forms، WPForms، Gravity و سایر فرمسازها.
کمپین پیامکی
ارسال گروهی، انتخاب کاربران، مشتریان ووکامرس، مخاطبین و زمانبندی.
صفحه ادامه پیامک
ارسال لینک کوتاه برای متنهای طولانی با بنر ثابت ویکی پیام.
گزارش ارسال
لاگ API، وضعیت تحویل، هزینه، track_id، فیلتر و خروجیگیری.
دفترچه تلفن
ایمپورت CSV/Excel، گروهبندی، حذف تکراریها و سینک با کاربران.
OTP صوتی
ارسال کد تأیید از طریق تماس صوتی، مناسب زمانی که پیامک دیر میرسد یا کاربر دسترسی پیامکی ندارد.
صف ارسال امن
WP-Cron، Retry، محدودیت نرخ ارسال و جلوگیری از ارسال تکراری.
Token افزونه را از پروفایل ویکی پیام بردارید
برای فعالسازی افزونه وردپرس، ابتدا وارد پنل ویکی پیام شوید و از صفحه پروفایل، Token اختصاصی حساب خود را دریافت کنید. سپس آن را در بخش «ویکی پیام ← تنظیمات API» وارد و دکمه «بررسی اتصال» را بزنید.
تنظیمات اولیه API
پس از فعالسازی افزونه، وارد منوی «ویکی پیام ← تنظیمات» شوید و اطلاعات اتصال را وارد کنید.
| فیلد | توضیح | نمونه |
|---|---|---|
| Base URL | آدرس اصلی سرویس | https://wikipayam.ir |
| API Prefix | مسیر نسخه API | api/v1 |
| Token | توکن اختصاصی کاربر | YOUR_AUTH_TOKEN_HERE |
| Sender | خط ارسالکننده پیشفرض | 10002000 |
تست اتصال و دریافت موجودی
برای اطمینان از صحت Token، از دکمه «بررسی اتصال» استفاده کنید. افزونه درخواست دریافت موجودی را ارسال میکند و نام کاربر، موجودی و واحد پولی را نمایش میدهد.
GET https://wikipayam.ir/api/v1/user/balance
Authorization: Bearer YOUR_AUTH_TOKEN_HERE
Accept: application/jsonماژولها و کاربردها
ووکامرس
برای هر وضعیت سفارش میتوانید قالب پیامک مستقل تعریف کنید. افزونه متغیرهای سفارش، مشتری، مبلغ، وضعیت، کد رهگیری و لینک پرداخت را پشتیبانی میکند.
- سفارش جدید برای مدیر
- ثبت سفارش برای مشتری
- در حال پردازش، تکمیلشده، لغوشده، ناموفق
- یادآوری پرداخت سفارشهای در انتظار
- سبد خرید رهاشده
- موجود شدن محصول و کاهش قیمت
OTP ورود و ثبتنام
امکان ورود با شماره موبایل، ثبتنام با موبایل، بازیابی رمز عبور و تأیید موبایل قبل از ثبت سفارش ووکامرس.
- محدودیت تعداد ارسال
- زمان انقضای کد
- قالب پیامک OTP
- سازگار با فرم ورود ووکامرس
OTP صوتی در افزونه وردپرس
Voice OTPOTP صوتی زمانی استفاده میشود که میخواهید کد تأیید از طریق تماس صوتی به کاربر اعلام شود. این قابلیت میتواند در فرم ورود با موبایل، ثبتنام، بازیابی رمز عبور و تأیید شماره قبل از ثبت سفارش ووکامرس فعال شود.
- ارسال کد تأیید صوتی از پیشخوان وردپرس
- نمایش دکمه «ارسال OTP صوتی» کنار کد پیامکی
- قابل استفاده بهعنوان مسیر پشتیبان در صورت نرسیدن پیامک
- ثبت track_id برای پیگیری درخواست در گزارشها
Endpoint مورد استفاده
POST https://wikipayam.ir/api/v1/voice-otp/send
Authorization: Bearer YOUR_AUTH_TOKEN_HERE
Content-Type: application/json
Accept: application/jsonنمونه بدنه درخواست
{
"receiver": "09123456789",
"code": "123456",
"track_id": "ORDER-1001"
}نمونه پاسخ موفق
{
"data": {
"message": "Voice OTP queued successfully",
"id": "6a02f05a3492873a9e086e86"
}
}فرمسازها
برای هر فرم میتوانید تعیین کنید پیامک به مدیر یا کاربر ارسال شود و شماره موبایل از کدام فیلد خوانده شود.
LMS و نوبتدهی
اتصال پایه برای سایتهای آموزشی و رزرو، جهت ارسال یادآوری کلاس، ثبتنام دوره، نمره آزمون، تأیید نوبت و لغو نوبت.
صفحه ادامه پیامک
برای متنهای طولانی، اطلاعیه، بخشنامه، کارنامه، فاکتور یا توضیحات خدمات، صفحهای زیبا ایجاد میشود و لینک کوتاه آن در پیامک ارسال میگردد. پایین صفحه، بنر ثابت ویکی پیام نمایش داده میشود.
مدیریت لغو عضویت
پیامکهای دریافتی مانند «لغو» یا «۱۱» میتوانند مخاطب را وارد لیست سیاه داخلی کنند تا در کمپینهای تبلیغاتی بعدی پیامک دریافت نکند.
قالبساز پیامک و متغیرها
در قالبساز، متن پیامک را با متغیرهای آماده مینویسید و افزونه قبل از ذخیره، تعداد کاراکتر و پارت را محاسبه میکند.
{{customer_name}} عزیز، سفارش شما با شماره {{order_id}} ثبت شد.
مبلغ سفارش: {{order_total}}
وضعیت: {{order_status}}
{{site_name}}شورتکدهای آماده
[wikipayam_otp_login]نمایش فرم ورود/ثبتنام با موبایل و کد تأیید.
[wikipayam_sms_parts]ابزار محاسبه تعداد پارت پیامک برای کاربران سایت.
[wikipayam_balance]نمایش موجودی پنل برای مدیران سایت.
[wikipayam_stock_alert]فرم ثبت درخواست اطلاعرسانی موجود شدن محصول.
صف ارسال و WP-Cron
برای جلوگیری از کند شدن سایت، ارسالهای گروهی و رویدادهای پرتعداد از طریق صف داخلی و WP-Cron پردازش میشوند. در صورت خطا، ارسال میتواند با تعداد تلاش محدود تکرار شود.
گزارش ارسال و لاگ API
تمام درخواستها، پاسخ API، وضعیت ارسال، هزینه، گیرنده، متن، track_id و خطاها در بخش گزارش ثبت میشوند تا پیگیری و پشتیبانی سادهتر شود.
Webhook داخلی
افزونه میتواند Endpoint داخلی برای دریافت رخدادهایی مانند پیامک ورودی، وضعیت تحویل، لغو عضویت، کلیک لینک یا بازدید صفحه ادامه پیامک داشته باشد.
هشدار کاهش اعتبار
وقتی موجودی پنل از حد تعیینشده کمتر شود، افزونه به مدیر سایت هشدار میدهد و میتواند ایمیل یا پیامک اطلاعرسانی ارسال کند.
سوالات متداول
آیا برای استفاده از افزونه باید حتماً حساب ویکی پیام داشته باشم؟
بله. برای ارسال پیامک و استفاده از API، باید در ویکی پیام حساب فعال و Token معتبر داشته باشید.
آیا تست زنده باعث کسر اعتبار میشود؟
اگر پیامک واقعی ارسال شود، مطابق تعرفه حساب کاربر محاسبه میشود. برای تست بدون ارسال واقعی باید Sandbox در سمت سرویس فعال باشد.
آیا افزونه با همه قالبهای وردپرس سازگار است؟
بخشهای مدیریتی مستقل از قالب سایت هستند. برای فرمهای سمت کاربر مثل OTP، ممکن است نیاز به کمی تنظیم CSS متناسب با قالب سایت باشد.
اگر فیلد موبایل در فرمساز متفاوت باشد چه کنم؟
در تنظیمات اتصال فرمساز، فیلد موبایل قابل Mapping است. برای فرمهای سفارشی باید نام فیلد موبایل را مشخص کنید.
OTP صوتی چه زمانی استفاده میشود؟
OTP صوتی برای زمانی مناسب است که پیامک کد تأیید دیر میرسد، کاربر به پیامک دسترسی ندارد یا میخواهید یک مسیر پشتیبان برای احراز هویت داشته باشید. در افزونه میتوانید آن را بهصورت دستی یا کنار OTP پیامکی فعال کنید.