نقطة نهاية تسجيل Webhook

نقطة نهاية REST API لتسجيل والاشتراك في webhooks في WSMS.

تتيح لك نقطة النهاية هذه تسجيل والاشتراك في webhooks في WSMS. استخدمها لاستقبال التحديثات أو الإشعارات عند حدوث أحداث معينة.

نقطة النهاية

POST /wp-json/wpsms/v1/webhook

المصادقة

يدعم WSMS مصادقة كلمة مرور التطبيق (WordPress 5.6+).

إنشاء كلمة مرور تطبيق

انتقل إلى المستخدمون ← الملف الشخصي في لوحة تحكم WordPress
مرر للأسفل إلى قسم كلمات مرور التطبيقات
أدخل اسماً في حقل اسم كلمة مرور التطبيق الجديدة
انقر على إضافة كلمة مرور تطبيق جديدة
انسخ كلمة المرور المُنشأة

استخدم اسم مستخدم WordPress أو البريد الإلكتروني كاسم المستخدم مع كلمة مرور التطبيق.

معاملات الطلب

المعامل	النوع	مطلوب	الوصف
`webhook_url`	string	نعم	عنوان URL لاستقبال إشعارات webhook
`type`	string	نعم	نوع الحدث: `new_subscriber` أو `new_sms`

أنواع الأحداث

النوع	الوصف
`new_subscriber`	يُفعّل عند تسجيل مشترك جديد
`new_sms`	يُفعّل عند استقبال رسالة قصيرة جديدة

أمثلة

cURL

curl --location --request POST 'https://site.com/wp-json/wpsms/v1/webhook' \
--header 'Authorization: Basic YOUR_API_KEY' \
--form 'webhook_url="https://your-webhook-url.com"' \
--form 'type="new_sms"'

PHP

<?php
$username = 'your-username';
$password = 'your-application-password';
$auth = base64_encode("$username:$password");

$url = 'https://site.com/wp-json/wpsms/v1/webhook';

$args = array(
    'headers' => array(
        'Authorization' => 'Basic ' . $auth,
    ),
    'body' => array(
        'webhook_url' => 'https://your-webhook-url.com',
        'type' => 'new_sms',
    ),
);

$response = wp_remote_post($url, $args);

حالات الاستخدام

التكامل مع Zapier أو أدوات الأتمتة الأخرى
مزامنة المشتركين الجدد مع نظام CRM خارجي
تسجيل الرسائل القصيرة الواردة في أنظمة خارجية
تشغيل سير عمل مخصص عند حدوث أحداث معينة