> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkiasoft.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks لغير المطورين

> إرسال الأحداث إلى n8n أو Zapier أو نظامك الخاص، مع مفاتيح التوقيع وسجل التسليم.

الـ webhook يخبر نظامًا آخر حين يحدث شيء هنا — بلا استطلاع دوري وبلا شيفرة API من جانبك سوى
استقبال الطلب.

## إعداد واحد

<Steps>
  <Step title="احصل على رابط من النظام المستقبِل">
    في n8n، عقدة Webhook. وفي Zapier، مشغّل "Catch Hook". وفي نظامك الخاص، أي نقطة نهاية تقبل
    طلب POST.
  </Step>

  <Step title="أضف نقطة النهاية">
    **التكاملات ← Webhooks ← إضافة.** ويجب أن يكون الرابط متاحًا علنًا عبر http(s) — فالعناوين
    الداخلية والخاصة مرفوضة.
  </Step>

  <Step title="اختر الأحداث">
    ما تحتاجه فقط. فكل حدث زائد هو حركة بيانات على المستقبِل تجاهلها.
  </Step>

  <Step title="اختر الحقول">
    لكل حدث يمكنك اختيار الحقول التي تُرسَل.
  </Step>

  <Step title="أرسل اختبارًا">
    يؤكد أن نقطة النهاية تقبل ما نرسله قبل أن يعتمد عليها شيء حقيقي.
  </Step>
</Steps>

## الأحداث

**المراسلة:** استُلمت رسالة، أُرسلت، سُلّمت، قُرئت، فشلت؛ واستُلم تعليق.

**النظام (CRM):** أُنشئ عميل محتمل، حُدّث، تغيّرت مرحلته، أُسند، رُبح، خُسر.

## مفتاح التوقيع

لكل نقطة نهاية مفتاح يُستخدم لتوقيع كل طلب. وينبغي أن يتحقق منه المستقبِل لديك — وإلا استطاع أي
شخص يعرف رابطك إرسال أحداث مزيّفة إليه.

ويمكنك **تدوير** المفتاح. حدّث المستقبِل في الوقت نفسه؛ فالطلبات الموقّعة بالمفتاح الجديد ستفشل
في التحقق مقابل القديم.

## سجل التسليم

آخر 300 محاولة لكل نقطة نهاية، مع ما أُرسل وما عاد.

<AccordionGroup>
  <Accordion title="إخفاقات لم تصل إلى نقطة النهاية أصلًا">
    مشكلات DNS أو TLS أو اتصال. فالرابط خاطئ، أو المستقبِل غير متاح علنًا.
  </Accordion>

  <Accordion title="نقطة النهاية رفضت الطلب">
    ردّت بحالة خطأ. والنص في السجل هو رسالة المستقبِل نفسه — وهناك سيكون السبب.
  </Accordion>

  <Accordion title="لا شيء في السجل إطلاقًا">
    لم يقع بعد أي حدث مطابق لاشتراكك. أرسل اختبارًا لتأكيد الربط.
  </Accordion>
</AccordionGroup>

## إبقاؤه سليمًا

* **رُد بسرعة، بحالة 2xx.** ونفّذ العمل البطيء بعد الإقرار. فالمستقبِل الذي يستغرق ثوانٍ للرد
  سيبدو كأنه فشل.
* **توقّع الحدث نفسه أكثر من مرة.** اجعل معالجك آمنًا عند تشغيله مرتين على الحدث نفسه بدل افتراض
  التسليم مرة واحدة تمامًا.
* **اشترك بضيق.** فإضافة حدث لاحقًا أسهل من معرفة أي خمسة عشر حدثًا يسبب المشكلة.