راه‌اندازی درگاه دوطرفه

این راهنما دستورالعمل‌های گام به گام پیکربندی URL‌های وب‌هوک در درگاه‌های مختلف پیامکی را برای فعال‌سازی پیام‌رسانی دوطرفه با افزودنی Two-Way WSMS ارائه می‌دهد.

قبل از شروع

1. افزودنی Two-Way SMS را نصب و فعال کنید
2. به SMS Two Way → Settings (یا SMS → Settings → Two Way) بروید تا URL وب‌هوک خود را پیدا کنید:

https://yourdomain.com/wp-json/wp-sms-two-way/v1/webhook?wpsms_token=YOUR_TOKEN

3. این URL را کپی کنید—برای پیکربندی درگاه به آن نیاز خواهید داشت

پیکربندی درگاه

Twilio

1. وارد Twilio Console شوید
2. به Phone Numbers → Manage → Active Numbers بروید
3. روی شماره تلفن خود کلیک کنید
4. به Messaging Configuration اسکرول کنید
5. زیر A MESSAGE COMES IN، گزینه Webhook را انتخاب کنید
6. URL وب‌هوک خود را جای‌گذاری کنید
7. متد HTTP را روی POST تنظیم کنید
8. روی Save کلیک کنید

Plivo

1. وارد Plivo Console شوید
2. به Messaging → Applications بروید
3. روی Add New Application کلیک کنید
4. نام اپلیکیشن را وارد کنید (مثلاً “WSMS Two-Way”)
5. در Message URL، URL وب‌هوک خود را جای‌گذاری کنید
6. متد را روی POST تنظیم کنید
7. روی Create Application کلیک کنید
8. به Phone Numbers → Your Numbers بروید
9. روی شماره خود کلیک کنید
10. زیر Application، اپلیکیشنی که ایجاد کردید را انتخاب کنید
11. روی Update Number کلیک کنید

BulkSMS

1. وارد BulkSMS شوید
2. به Settings → Advanced → Webhooks بروید
3. روی Create New Webhook کلیک کنید
4. نام وب‌هوک را وارد کنید (مثلاً “WSMS Incoming”)
5. URL وب‌هوک خود را جای‌گذاری کنید
6. Inbound Message را به عنوان تریگر انتخاب کنید
7. روی Save کلیک کنید

ASPSMS

1. وارد ASPSMS Console شوید
2. به Numbers → Your Numbers بروید
3. روی شماره خود Edit کلیک کنید
4. بخش Forward SMS by HTTP GET Request را پیدا کنید
5. URL وب‌هوک خود را در فیلد مشخص‌شده جای‌گذاری کنید
6. روی Save کلیک کنید

Telnyx

1. وارد Telnyx Mission Control شوید
2. به Messaging → Programmable Messaging بروید
3. روی Messaging Profiles کلیک کنید
4. یک پروفایل جدید ایجاد کنید یا موجود را ویرایش کنید
5. در Inbound Settings، بخش Inbound Message Webhook URL را پیدا کنید
6. URL وب‌هوک خود را جای‌گذاری کنید
7. متد را روی POST تنظیم کنید
8. روی Save کلیک کنید
9. این پروفایل را به شماره تلفن خود اختصاص دهید

AfricasTalking

1. وارد AfricasTalking Dashboard شوید
2. به SMS → SMS Callback URLs بروید
3. روی Incoming Messages کلیک کنید
4. URL وب‌هوک خود را جای‌گذاری کنید
5. روی Save کلیک کنید

Octopush

1. وارد Octopush شوید
2. به API & Integrations بروید
3. به HTTP Callback Options → Webhooks بروید
4. بخش Inbound Messages Callback URL را پیدا کنید
5. URL وب‌هوک خود را جای‌گذاری کنید
6. روی Save کلیک کنید

Mobile Message (استرالیا)

1. وارد Mobile Message شوید
2. به Settings → API بروید
3. بخش Webhook URLs را پیدا کنید
4. URL وب‌هوک خود را در Webhook URL for Inbound Messages جای‌گذاری کنید
5. روی Save کلیک کنید

درگاه‌هایی که نیاز به تماس با پشتیبانی دارند

برخی درگاه‌ها نیاز دارند با تیم پشتیبانی آن‌ها برای پیکربندی URL‌های وب‌هوک تماس بگیرید:

درگاه	نحوه پیکربندی
SMS.es	تماس با پشتیبانی برای راه‌اندازی وب‌هوک
Infobip	تماس با پشتیبانی یا استفاده از راه‌اندازی API
SMSAPI	تماس با پشتیبانی برای پیکربندی وب‌هوک
Cellsynt	تماس با پشتیبانی برای فعال‌سازی وب‌هوک‌های ورودی
WebSMS	تماس با پشتیبانی برای راه‌اندازی دوطرفه

هنگام تماس با پشتیبانی، موارد زیر را ارائه دهید:

• شناسه حساب/نام کاربری شما
• URL وب‌هوک شما: https://yourdomain.com/wp-json/wpsms/v1/webhook/incoming
• درخواست: «لطفاً این URL را برای دریافت پیامک‌های ورودی پیکربندی کنید»

آزمایش پیکربندی

پس از پیکربندی وب‌هوک:

1. یک پیامک آزمایشی به شماره درگاه خود ارسال کنید
2. SMS → Inbox را برای پیام بررسی کنید
3. اگر دریافت نشد، لاگ اشکال‌زدایی را بررسی کنید:

/wp-content/uploads/wp-sms-two-way-logs/incoming_requests

عیب‌یابی

پیام‌ها نمایش داده نمی‌شوند

1. تأیید URL وب‌هوک: مطمئن شوید URL صحیح و قابل دسترسی است
2. بررسی SSL: اکثر درگاه‌ها نیاز به HTTPS دارند
3. فایروال: اطمینان حاصل کنید سرور شما درخواست‌های POST ورودی را مجاز می‌کند
4. لاگ اشکال‌زدایی: فایل لاگ را برای درخواست‌های ورودی بررسی کنید

تأیید وب‌هوک ناموفق

برخی درگاه‌ها URL‌های وب‌هوک را با ارسال یک درخواست آزمایشی تأیید می‌کنند:

1. مطمئن شوید سایت شما به صورت عمومی قابل دسترسی است
2. بررسی کنید REST API فعال باشد
3. تأیید کنید هیچ افزونه امنیتی مسیر API را مسدود نمی‌کند

مشکلات گواهی SSL

درگاه‌ها نیاز به گواهی‌های SSL معتبر دارند:

1. مطمئن شوید گواهی SSL شما معتبر و منقضی نشده است
2. از گواهی صادر شده توسط یک CA معتبر استفاده کنید
3. از گواهی‌های خودامضا اجتناب کنید

امنیت وب‌هوک

برای امن‌سازی مسیر وب‌هوک:

1. از HTTPS استفاده کنید (مورد نیاز اکثر درگاه‌ها)
2. در صورت ارائه محدوده IP توسط درگاه، لیست سفید IP را در نظر بگیرید
3. لاگ اشکال‌زدایی را برای فعالیت مشکوک نظارت کنید

مرتبط

• پیامک دوطرفه - مستندات اصلی افزودنی
• وب‌هوک‌ها - پیکربندی عمومی وب‌هوک
• تنظیمات درگاه - پیکربندی درگاه‌های پیامکی