الويب هوك (Webhooks) (تكاملات صادرة)
أبلغ أنظمتك الخاصة عند حدوث شيء هنا: فاتورة مدفوعة، عرض مقبول، صفقة رابحة، طلب تم إنشاؤه، وعميل محتمل تم إنشاؤه — تُسلَّم عبر HTTP بتوقيع.
ما تجده في هذه الشاشة
صورة للشاشة مقروءة من الشاشة نفسها — تتغيّر حين تتغيّر الشاشة.
الإجراءات المتاحة
إرسال حدث اختباري
تعرض القائمة
الحدثالحالةمحاولةمتى
حقول النموذج
DescriçãoPara você reconhecer a integração (ex.: ERP do cliente).
URL de destino*Endpoint HTTPS que receberá o POST com o corpo em JSON.
Ativo
ابدأ هنا
ما الغرض منه
تكامل في الوقت الفعلي بدون استقصاء (polling): سجّل عنوان URL خاصًا بك واختر الأحداث. عندما يحدث الحدث، نرسل طلب POST يحتوي على JSON لما حدث.
الـ Webhooks في قائمة والتسليمات في الأعلى
تعرض القائمة كل Webhook بالوصف وعنوان URL والأحداث والسر المُقنّع وحالة النشاط. وفي الأعلى آخر التسليمات — الحدث والحالة ورمز HTTP والمحاولة والوقت — وزر إرسال اختبار الذي يضع إشارة في الانتظار لكل الاشتراكات النشطة.
القواعد
الأمان (توقيع HMAC)
لكل اشتراك سر (whsec_...). كل إرسال يأتي مع رأس X-Tenka-Signature (HMAC-SHA256 للجسم) — تحقق منه على خادمك قبل الوثوق بالمحتوى.
التسليم وإعادة الإرسال
فشل (مهلة/5xx)؟ تعيد قائمة الانتظار الإرسال مع تراجع تدريجي. تظهر آخر عمليات التسليم على الشاشة مع الحالة — استخدم زر اختبار للتحقق من عنوان URL الخاص بك.
الأحداث المتاحة
fatura.paga، proposta.aceita، negocio.ganho، demanda.criada وlead.criado. يعرض الكتالوج فقط ما يُطلق فعليًا — بدون وعد فارغ.
السر والأحداث في البطاقة
في البطاقة، يوقّع السر جسم كل تسليم (رأس X-Tenka-Signature بـ HMAC): تحقّق منه من جهتك لضمان المصدر. إن كان فارغًا يولّد Tenka واحدًا؛ والزر المجاور يولّد آخر. في الأحداث، اترك "الكل" أو اختر الأحداث التي تُطلق — واحدًا على الأقل.
الحذف يزيل الاشتراك
لا يذهب الـ Webhook إلى سلة المحذوفات: الحذف يزيل الاشتراك ويتوقف نظامك عن تلقي الأحداث فورًا. للإيقاف المؤقت دون فقدان الإعداد، ألغِ تحديد نشط.
الأسئلة الشائعة
أفضل الممارسات
استجب بـ2xx بسرعة (عالج بشكل غير متزامن من جانبك)؛ تعامل مع التكرار عبر معرف الحدث (يمكن أن تتكرر عمليات التسليم عند إعادة المحاولة).
هل كان هذا المقال مفيداً؟
في الوحدة نفسها: المنصة والأمان38
شاشة مرتبطة بالمساعدةشاشة الربط الخاصة بقاموس التفاصيل. لا تظهر في القائمة.وصول المنصةسجل بمتى وصل فريق دعم المنصة إلى حسابك، وماذا فعل وبأي تفويض.White-space (الفجوات البيضاء)رؤية ما تبقى بيعه لمن هم بالفعل عملاء — من خلال مقارنة القاعدة المثبتة بما يمتلكه العملاء المشابهون بالفعل.عنصر القالبشاشة الربط الخاصة بقاموس التفاصيل (عناصر القالب). لا تظهر في القائمة.Assistente fiscalQuatro passos para a nota sair do Tenka: estado, regime, código de segurança (CSC) e certificado A1 — com a r…الشحنيتحكم في تجهيز وشحن ما تم بيعه. الشحن يؤكد أن البضاعة خرجت فعليًا: التباين بين ما تم شحنه وما تمت فوترته هو أ…نطاق المنصبشاشة الربط الخاصة بقاموس التفاصيل (نطاقات المنصب). لا تظهر في القائمة.المدونة — الاتصال بـ WordPressالموضع الذي تربط فيه ووردبريس شركتك وتعلّم الذكاء الاصطناعي أن يكتب مثلك: الخط التحريري (عمّا تتحدث)، ونبرة ا…
أكاديمية تينكا
استكشف الأكاديميةمسارات تعلم لقطاعك، خطوة بخطوة، داخل المنصة.