ثبت‌نام
Webhook پیام دریافتی

دریافت پیامک در نرم‌افزار و CRM با Webhook

پیام دریافتی را تقریباً لحظه‌ای و با یک درخواست POST شامل JSON به CRM، Helpdesk یا نرم‌افزار اختصاصی خود منتقل کنید.

ارسال تقریباً لحظه‌ای پیامک‌های دریافتی با POST و JSON به CRM یا نرم‌افزار، همراه با امضای HMAC-SHA256، Delivery ID و تلاش مجدد کنترل‌شده.

شروع اتصال Webhook ورود به پنل درخواست مشاوره

نمونه فنی کوتاه

این نمونه‌ها برای شناخت ساختار داده و کنترل امنیت هستند؛ جزئیات پیاده‌سازی باید با مستندات فنی و secret امن محیط شما هماهنگ شود.

نمونه کوتاه JSON دریافتی

{
  "event": "sms.received",
  "delivery_id": "dlv_8f21",
  "line": "3000...",
  "message": "عضویت",
  "received_at": "2026-09-07T10:30:00+03:30"
}

نمونه بررسی امضای HMAC در PHP

$expected = hash_hmac('sha256', $rawBody, $webhookSecret);
$isValid = hash_equals($expected, $signature);

پیام ورودی تقریباً لحظه‌ای به نرم‌افزار می‌رسد

پس از دریافت پیام، ویکی‌پیام payload را با POST و JSON به مقصد تنظیم‌شده می‌فرستد. می‌توانید یک مقصد پیش‌فرض داشته باشید یا برای هر خط مقصد اختصاصی تعیین کنید و تنظیمات چند خط را گروهی انجام دهید.

هدرهای رویداد و تحویل، پردازش را قابل کنترل می‌کنند

هدرهای X-Wikipayam-Event، X-Wikipayam-Delivery و X-Wikipayam-Signature نوع رویداد، شناسه یکتای تحویل و امضای درخواست را منتقل می‌کنند. Delivery ID برای جلوگیری از پردازش تکراری نگهداری می‌شود.

پاسخ موفق و تلاش مجدد تعریف مشخص دارد

مقصد باید پاسخ 2xx بدهد؛ Redirectهای 3xx موفق محسوب نمی‌شوند. در صورت عدم دریافت پاسخ موفق، مجموعاً تا چهار تلاش با فاصله تقریبی ۱، ۵ و ۱۵ دقیقه انجام می‌شود.

برای سناریوهای تعاملی آماده است

اتصال پیام‌های ورودی به CRM، Helpdesk، باشگاه مشتریان، نظرسنجی، مسابقه، ثبت سفارش و نرم‌افزار اختصاصی از کاربردهای این قابلیت است.

این قابلیت برای چه کسانی مناسب است؟

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

تیم‌های CRM و فروش
Helpdesk و پشتیبانی
باشگاه‌های مشتریان
سامانه‌های نظرسنجی و مسابقه
نرم‌افزارهای ثبت سفارش
توسعه‌دهندگان نرم‌افزار اختصاصی

نمونه کاربرد در کسب‌وکار

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

Helpdesk پیام ورودی را به درخواست پشتیبانی متصل می‌کند و Delivery ID مانع ثبت دوباره آن می‌شود.

سامانه مسابقه یا نظرسنجی، کلیدواژه پیام را دریافت و نتیجه را در فرآیند داخلی پردازش می‌کند.

مسیر استفاده

این مراحل از مستندات کاربری ویکی‌پیام استخراج و برای شروع سریع ساده‌سازی شده‌اند.

1 تعریف مقصد Webhook پیش‌فرض یا اختصاصی خط
2 ارسال آزمایشی و بررسی پاسخ 2xx
3 اعتبارسنجی امضای HMAC-SHA256
4 ثبت Delivery ID پیش از پردازش
5 پایش تلاش‌ها و خطاهای تحویل

لینک‌های مرتبط برای ادامه مسیر

برای تصمیم بهتر، این صفحه را با مستندات و مقاله‌های مرتبط بخوانید.

بازگشت به مرکز امکانات راهنمای Webhook پیامک دریافتی امنیت Webhook و HMAC تعرفه‌ها و پلن‌ها درخواست مشاوره فنی مرکز امکانات Webhook پیامک دریافتی چیست و چگونه پیام‌های ورودی را به CRM متصل کنیم؟ امنیت Webhook پیامک؛ امضای HMAC و جلوگیری از پردازش تکراری منشی پیامکی و پاسخ خودکار با کلیدواژه چه کاربردی دارد؟

سوالات متداول

پاسخ‌های کوتاه برای تصمیم‌گیری سریع‌تر درباره این قابلیت.

Webhook پیامک دریافتی با چه فرمتی ارسال می‌شود؟

اطلاعات پیام دریافتی با درخواست POST و بدنه JSON به مقصد تنظیم‌شده ارسال می‌شود.

آیا تحویل Webhook آنی و تضمین‌شده است؟

خیر، تعبیر دقیق‌تر «تقریباً لحظه‌ای» است؛ زمان تحویل به وضعیت شبکه، مقصد و فرآیند ارسال بستگی دارد.

چطور از اصالت درخواست مطمئن شویم؟

امضای X-Wikipayam-Signature را با secret مقصد و الگوریتم HMAC-SHA256 بررسی کنید.

اگر مقصد پاسخ موفق ندهد چه می‌شود؟

در صورت پاسخ غیر 2xx، مجموعاً تا چهار تلاش با فاصله‌های تقریبی ۱، ۵ و ۱۵ دقیقه انجام می‌شود؛ پاسخ 3xx موفق نیست.

پیام‌های ورودی را وارد جریان نرم‌افزار کنید

برای طراحی مقصد Webhook، اعتبارسنجی امضا و رفتار تلاش مجدد، مسیر اتصال را با تیم فنی بررسی کنید.

شروع اتصال Webhook ورود به پنل درخواست مشاوره