واجهة برمجة تطبيقات ماسنجر ودمج الويب هوك للبوتات (دليل 2026)

تؤدي أتمتة الإشعارات من خلال روبوتات المراسلة إلى تبسيط سير عمل التطوير، مما يتيح تنبيهات فورية عند اكتمال عمليات البناء، أو حدوث أخطاء، أو انتهاء عمليات النشر. يقدم هذا الدليل تعليمات خطوة بخطوة لتضمين الروبوتات التي يمكنها إرسال رسائل آلية عبر webhooks عبر منصات المراسلة الشائعة. سواء كنت بحاجة إلى إخطار فريقك بنتائج خط أنابيب CI/CD، أو تنبيهات مراقبة الخادم، أو إكمال أي عملية آلية، فإن هذه التكاملات تجعل ذلك ممكنًا. نغطي فقط المنصات التي تتمتع بقدرات تكامل بسيطة للروبوتات - بعض تطبيقات المراسلة الآمنة تعطي الأولوية للخصوصية على ميزات الأتمتة وتم استبعادها عمدًا.

فهم أتمتة الروبوتات المعتمدة على Webhook

تعمل الروبوتات المعتمدة على Webhook وفقًا لمبدأ بسيط: يرسل تطبيقك طلب HTTP POST إلى عنوان URL محدد، وتقوم منصة المراسلة بتسليم هذا المحتوى إلى قناة أو مستخدم. هذه البنية مثالية لسيناريوهات الأتمتة مثل:

• إشعارات البناء - تنبيه عند نجاح التجميع أو فشله مع تفاصيل الخطأ
• تحديثات النشر - إخطار الفرق عند وصول الكود إلى بيئة التجريب أو الإنتاج
• تنبيهات المراقبة - إرسال تحذيرات حول صحة الخادم أو إشعارات توقف الخدمة
• التقارير المجدولة - تقديم المقاييس اليومية أو ملخصات الحالة

يتضمن سير العمل الأساسي:

1. إنشاء روبوت أو عنوان URL للـ webhook على المنصة المستهدفة
2. تكوين أداة الأتمتة (CI/CD، نظام المراقبة، نص برمجي مخصص) لإرسال طلبات HTTP
3. تنسيق حمولة الرسالة وفقًا لمواصفات المنصة

يعد فهم كيفية تعامل منصات المراسلة المختلفة مع الأمان والتشفير أمرًا بالغ الأهمية لاختيار المنصة المناسبة للإشعارات الخاصة بك. للحصول على نظرة أعمق حول اعتبارات الأمان الخاصة بكل منصة، راجع الدليل النهائي حول تطبيقات المراسلة في 2026.

أدلة تكامل روبوتات المراسلة

فيما يلي أدلة خطوة بخطوة لكل منصة تدعم تكامل الروبوتات المعتمدة على webhook بسهولة لإرسال رسائل آلية.

روبوت Discord Webhook

يوفر Discord واحدًا من أبسط تطبيقات webhook، ولا يتطلب تطبيق روبوت أو رموز مصادقة لإرسال الرسائل الأساسية.

إعداد خطوة بخطوة

1. افتح إعدادات الخادم - انقر بزر الماوس الأيمن على اسم الخادم واختر "إعدادات الخادم"
2. انتقل إلى التكاملات - انقر على "التكاملات" في الشريط الجانبي الأيسر
3. إنشاء Webhook - انقر على "Webhooks" ثم "Webhook جديد"
4. تكوين Webhook - قم بتسمية webhook الخاص بك (مثل "Build Bot")، واختر القناة المستهدفة، وقم اختياريًا بتحميل صورة رمزية
5. نسخ عنوان URL للـ Webhook - انقر على "نسخ عنوان URL للـ Webhook" واحفظه بشكل آمن

إرسال الرسائل عبر Webhook

curl -X POST -H "Content-Type: application/json" \
  -d '{"content": "✅ تم إكمال البناء بنجاح!\n\nالمشروع: MyApp\nالفرع: main\nالمدة: 3m 42s"}' \
  https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN

مثال Embed غني لإشعارات الأخطاء

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "embeds": [{
      "title": "❌ فشل البناء",
      "color": 15158332,
      "fields": [
        {"name": "المشروع", "value": "MyApp", "inline": true},
        {"name": "الفرع", "value": "feature/login", "inline": true},
        {"name": "الخطأ", "value": "```TypeError: Cannot read property of undefined```"}
      ],
      "timestamp": "2026-01-15T10:30:00.000Z"
    }]
  }' \
  YOUR_WEBHOOK_URL

التوثيق الرسمي: توثيق Discord Webhook

روبوت Slack Webhook

يوفر Slack Incoming Webhooks كجزء من نظام تطبيقات Slack، مما يوفر تنسيق رسائل غني ومرونة في القنوات.

إعداد خطوة بخطوة

1. إنشاء تطبيق Slack - قم بزيارة api.slack.com/apps وانقر على "إنشاء تطبيق جديد"
2. اختر طريقة الإنشاء - حدد "من الصفر" وقم بتسمية تطبيقك (مثل "إشعارات CI/CD")
3. تمكين Incoming Webhooks - انتقل إلى "Incoming Webhooks" في الشريط الجانبي الأيسر وقم بتفعيله
4. أضف Webhook إلى مساحة العمل - انقر على "إضافة Webhook جديد إلى مساحة العمل"
5. اختر القناة - اختر القناة التي يجب أن تظهر فيها الإشعارات وانقر على "السماح"
6. نسخ عنوان URL للـ Webhook - يتم الآن عرض عنوان URL الفريد للـ webhook الخاص بك

إرسال الرسائل عبر Webhook

curl -X POST -H "Content-Type: application/json" \
  -d '{"text": "✅ تم إكمال النشر إلى الإنتاج بنجاح!"}' \
  https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXX

رسالة Block Kit للإشعارات المفصلة

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "blocks": [
      {
        "type": "header",
        "text": {"type": "plain_text", "text": "🚨 فشل البناء"}
      },
      {
        "type": "section",
        "fields": [
          {"type": "mrkdwn", "text": "*المشروع:*\nMyApp"},
          {"type": "mrkdwn", "text": "*الفرع:*\nmain"},
          {"type": "mrkdwn", "text": "*الخطأ:*\n`Module not found`"}
        ]
      }
    ]
  }' \
  YOUR_WEBHOOK_URL

التوثيق الرسمي: دليل Slack Incoming Webhooks

روبوت Microsoft Teams Webhook

يدعم Microsoft Teams Incoming Webhooks لإشعارات القناة، المتكاملة من خلال نظام الموصلات.

إعداد خطوة بخطوة

1. افتح إعدادات القناة - انتقل إلى القناة المستهدفة، وانقر على النقاط الثلاث (•••) بجانب اسم القناة
2. اختر الموصلات - انقر على "الموصلات" (أو "إدارة القناة" ثم "الموصلات" في الإصدارات الأحدث)
3. ابحث عن Incoming Webhook - ابحث عن "Incoming Webhook" وانقر على "تكوين"
4. قم بتسمية Webhook الخاص بك - قدم اسمًا (مثل "تنبيهات البناء") واختياريًا قم بتحميل صورة
5. إنشاء ونسخ عنوان URL - انقر على "إنشاء" وانسخ عنوان URL للـ webhook المقدم

إرسال الرسائل عبر Webhook

curl -X POST -H "Content-Type: application/json" \
  -d '{"text": "✅ تم إكمال البناء #1234 بنجاح على الفرع الرئيسي"}' \
  YOUR_TEAMS_WEBHOOK_URL

بطاقة تكيفية للإشعارات الغنية

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "type": "message",
    "attachments": [{
      "contentType": "application/vnd.microsoft.card.adaptive",
      "content": {
        "type": "AdaptiveCard",
        "version": "1.2",
        "body": [
          {"type": "TextBlock", "size": "Large", "weight": "Bolder", "text": "❌ فشل البناء"},
          {"type": "FactSet", "facts": [
            {"title": "المشروع:", "value": "MyApp"},
            {"title": "الخطأ:", "value": "فشل التجميع"}
          ]}
        ]
      }
    }]
  }' \
  YOUR_TEAMS_WEBHOOK_URL

التوثيق الرسمي: Microsoft Teams Incoming Webhooks

روبوت Telegram

يوفر Telegram واجهة برمجة تطبيقات قوية للروبوتات تسمح بإرسال الرسائل برمجيًا. على عكس webhooks، ترسل الطلبات مباشرة إلى واجهة برمجة تطبيقات Telegram.

إعداد خطوة بخطوة

1. إنشاء روبوت عبر BotFather - افتح Telegram وابحث عن @BotFather
2. ابدأ روبوت جديد - أرسل أمر /newbot
3. قم بتسمية الروبوت الخاص بك - اتبع المطالبات لتعيين اسم العرض واسم المستخدم (يجب أن ينتهي بـ "bot")
4. احفظ رمز API - يوفر BotFather رمز API مثل 123456789:ABCdefGHIjklMNOpqrsTUVwxyz
5. احصل على معرف الدردشة - أضف الروبوت إلى مجموعتك/قناتك، أرسل رسالة، ثم قم بزيارة https://api.telegram.org/bot<TOKEN>/getUpdates للعثور على معرف الدردشة

إرسال الرسائل عبر Bot API

curl -X POST \
  "https://api.telegram.org/bot/sendMessage" \
  -d "chat_id=" \
  -d "text=✅ تم إكمال البناء بنجاح!%0A%0AالمشروعL MyApp%0Aالفرع: main" \
  -d "parse_mode=HTML"

رسالة منسقة بـ HTML

curl -X POST \
  "https://api.telegram.org/bot/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "",
    "text": "❌ فشل البناء\n\nالمشروع: MyApp\nالفرع: main\nالخطأ: Module not found",
    "parse_mode": "HTML"
  }'

التوثيق الرسمي: Telegram Bot API

روبوت Mattermost Webhook

Mattermost هو بديل مفتوح المصدر لـ Slack مع دعم ممتاز لـ webhook، مثالي للاتصال الفريق المستضاف ذاتيًا.

إعداد خطوة بخطوة

1. الوصول إلى التكاملات - انقر على قائمة الهامبرغر، ثم "التكاملات"
2. إنشاء Incoming Webhook - حدد "Incoming Webhooks" ثم "إضافة Incoming Webhook"
3. تكوين Webhook - قم بتعيين العنوان والوصف واختر القناة الافتراضية
4. حفظ ونسخ عنوان URL - انقر على "حفظ" وانسخ عنوان URL للـ webhook

إرسال الرسائل عبر Webhook

curl -X POST -H "Content-Type: application/json" \
  -d '{"text": "✅ تم إكمال البناء بنجاح!"}' \
  https://your-mattermost-server.com/hooks/YOUR_WEBHOOK_ID

رسالة مرفقة غنية

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "attachments": [{
      "fallback": "فشل البناء",
      "color": "#FF0000",
      "title": "❌ فشل البناء",
      "fields": [
        {"short": true, "title": "المشروع", "value": "MyApp"},
        {"short": true, "title": "الفرع", "value": "main"},
        {"short": false, "title": "الخطأ", "value": "```Module not found```"}
      ]
    }]
  }' \
  YOUR_WEBHOOK_URL

التوثيق الرسمي: Mattermost Incoming Webhooks

روبوت Matrix/Element

Matrix هو بروتوكول مفتوح للاتصال اللامركزي، مع Element كونه العميل الأكثر شعبية. يتطلب تكامل الروبوت استخدام واجهة برمجة تطبيقات Matrix Client-Server.

إعداد خطوة بخطوة

1. إنشاء حساب روبوت - قم بتسجيل حساب Matrix جديد للروبوت الخاص بك على خادم المنزل الخاص بك أو matrix.org
2. الحصول على رمز الوصول - قم بتسجيل الدخول واسترجاع رمز الوصول من Element: الإعدادات → المساعدة والمعلومات → متقدم → رمز الوصول
3. الحصول على معرف الغرفة - انضم إلى الغرفة المستهدفة بروبوتك، ثم ابحث عن معرف الغرفة في إعدادات الغرفة → متقدم
4. دعوة الروبوت إلى الغرفة - تأكد من أن حساب الروبوت قد انضم إلى الغرفة حيث تريد إرسال الرسائل

إرسال الرسائل عبر Matrix API

curl -X PUT \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"msgtype": "m.text", "body": "✅ تم إكمال البناء بنجاح!"}' \
  "https://matrix.org/_matrix/client/r0/rooms/YOUR_ROOM_ID/send/m.room.message/$(date +%s)"

رسالة منسقة بـ HTML

curl -X PUT \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "msgtype": "m.text",
    "body": "فشل البناء\nالمشروع: MyApp\nالخطأ: Module not found",
    "format": "org.matrix.custom.html",
    "formatted_body": "
❌ فشل البناء
المشروع: MyApp
الخطأ: Module not found
"
  }' \
  "https://matrix.org/_matrix/client/r0/rooms/YOUR_ROOM_ID/send/m.room.message/$(date +%s)"

التوثيق الرسمي: مواصفات Matrix Client-Server API

روبوت WhatsApp Business

يوفر WhatsApp واجهة برمجة تطبيقات Business للرسائل الآلية، على الرغم من أنها تتطلب التحقق من الأعمال ولديها إعداد أكثر تعقيدًا من المنصات الأخرى.

إعداد خطوة بخطوة

1. إنشاء حساب Meta Business - قم بزيارة business.facebook.com وإنشاء حساب تجاري
2. إعداد WhatsApp Business - انتقل إلى developers.facebook.com، أنشئ تطبيقًا، وأضف منتج WhatsApp
3. تكوين رقم الهاتف - أضف رقم هاتف لروبوتك (أرقام اختبار متاحة للتطوير)
4. الحصول على رمز الوصول - قم بإنشاء رمز وصول دائم من لوحة معلومات التطبيق
5. التحقق من الأعمال - أكمل التحقق من الأعمال للاستخدام في الإنتاج

إرسال الرسائل عبر Cloud API

curl -X POST \
  "https://graph.facebook.com/v17.0/YOUR_PHONE_NUMBER_ID/messages" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "RECIPIENT_PHONE_NUMBER",
    "type": "text",
    "text": {"body": "✅ تم إكمال البناء بنجاح!"}
  }'

التوثيق الرسمي: توثيق WhatsApp Cloud API

روبوت Facebook Messenger