---
title: "Zapier"
description: "اربط Quire بـZapier باستخدام خطافات الويب وREST API."
image: "https://docs.quirelms.com/og.png"
---

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

# Zapier

<span id="zapier"></span>

يتصل Zapier بـQuire عبر REST API وعملاء OAuth وخطافات الويب نفسها التي تستخدمها عمليات التكامل الأخرى. ولا تحتاج أي من الجهتين إلى شيفرة خاصة بـQuire، لذا يمكن لإجراء Zap تنفيذ أي وظيفة يقدمها [مرجع API](https://docs.quirelms.com/api/).

## ابدأ Zap عند وقوع حدث في Quire <!--quire:start-a-zap-when-something-happens-in-quire-->

1. اختر **Webhooks by Zapier** كمُشغّل في Zapier، مع الحدث **Catch Raw Hook**. اختر البيانات الخام لأن التوقيع يُحسب من البايتات نفسها التي أرسلها Quire. انسخ العنوان الذي يمنحك إياه Zapier.
2. افتح `/admin/webhooks` في Quire واختر **إضافة اشتراك** والصق العنوان واختر الأحداث، مثل `course_completion.changed`. يرسل Quire حدث اختبار أولًا؛ ويبدأ الاشتراك بعد أن يستلمه Zapier.
3. أضف خطوة **Code by Zapier** للتحقق من التوقيع باستخدام سر الاشتراك كما هو موضح في [دليل المطور](/ar/developer/#webhooks). أوقف Zap إذا لم يجتز الحدث التحقق.
4. حلل محتوى الطلب وتابع بالخطوات المطلوبة.

## نفّذ إجراءً في Quire من Zap <!--quire:act-in-quire-from-a-zap-->

استخدم **Webhooks by Zapier** مع إجراء **Custom Request**، أو **API Request** في خطوة تطبيق:

- **URL**: `https://acme.quirelms.com/api/v1/...`، مثل `/api/v1/enrolments` لتسجيل شخص.
- **Headers**: `Authorization: Bearer qk_live_...` مع مفتاح أُنشئ لهذا Zap وحده في `/admin/integrations/api-keys`، ورأس `Idempotency-Key` مبني من معرف الحدث حتى لا يؤدي تكرار Zapier للطلب إلى تسجيل الشخص نفسه مرتين.
- **Data**: بصيغة JSON كما يوضح مرجع API.

لكي تتصرف بصفتك شخصًا بدل المؤسسة، سجّل عميل OAuth في `/admin/integrations/oauth-clients` بعنوان إعادة التوجيه لـZapier واستخدمه ضمن تكامل خاص في Zapier.

## مثال: سجّل عميلًا عند إغلاق صفقة <!--quire:example-enrol-a-customer-when-a-deal-closes-->

1. المُشغّل: حدث «تم الفوز بالصفقة» في نظام CRM.
2. طلب مخصص `PUT /api/v1/users/ext:{customer id}` مع اسم الشخص وبريده الإلكتروني؛ ينشئ المستخدم أو يحدّثه إن كان موجودًا.
3. طلب مخصص `POST /api/v1/enrolments` مع المستخدم والمقرر، والرأس `Idempotency-Key: deal-{deal id}`.

Source: https://docs.quirelms.com/ar/integrations/zapier/index.mdx