تكامل Zapier

يربط تطبيق Wbiztool على Zapier رقم WhatsApp الخاص بك بالتطبيقات الأخرى التي تستخدمها. ابدأ Zap عند وصول رسالة WhatsApp، أو أرسل رسالة WhatsApp عند حدوث شيء في تطبيق آخر.

قبل أن تبدأ#

• حساب Wbiztool مع رقم WhatsApp متصل في WhatsApp settings (إعدادات WhatsApp).
• Client ID (معرّف العميل) وAPI key (مفتاح API) من Settings → API keys (الإعدادات ← مفاتيح API).
• لمشغّل الرسائل الواردة: إضافة Unibox في باقتك. راجع متطلبات المشغل.

اربط حسابك#

1. أضف Wbiztool إلى Zap

   في Zapier، أنشئ Zap وابحث عن Wbiztool كتطبيق المشغّل أو الإجراء.

2. سجّل الدخول

   عندما يطلب منك Zapier ربط حساب، أدخل Client ID وAPI key من Settings → API keys.

يحدد مفتاح API مساحة العمل التي يستخدمها Zapier. إذا كنت تنتمي إلى أكثر من مساحة عمل، فاستخدم مفتاحًا أُنشئ في مساحة العمل التي تريد ربطها. إذا كان Client ID أو API key خاطئًا، يعرض Zapier الخطأ عند الربط، مثل Auth Error: invalid api key.

مشغّل رسائل WhatsApp الواردة#

يبدأ هذا المشغّل Zap الخاص بك في كل مرة يرسل فيها أحدهم رسالة إلى أحد أرقام WhatsApp الخاصة بك. استخدمه لإضافة الدردشات الجديدة إلى نظام CRM، أو نشر الرسائل في قناة الفريق، أو تسجيل المحادثات في جدول بيانات.

1. اختر المشغّل

   اختر Wbiztool كتطبيق وIncoming WhatsApp Message (رسالة WhatsApp واردة) كحدث المشغّل.

2. اختر رقم WhatsApp

   تحت WhatsApp Number (رقم WhatsApp)، اختر الرقم المتصل الذي يجب أن تبدأ رسائله الواردة Zap. تعرض القائمة أرقام الهواتف المتصلة في مساحة عملك.

3. اختبر المشغّل

   انقر على Test trigger (اختبار المشغّل). يحمّل Zapier أحدث الرسائل المستلمة على ذلك الرقم، لتتمكن من ربط حقول حقيقية في الخطوات التالية. إذا لم يكن للرقم رسائل بعد، يعرض Zapier رسالة نموذجية بدلًا من ذلك.

4. فعّل Zap

   انشر Zap. تتصل Wbiztool بـ Zapier تلقائيًا. لا تحتاج إلى إضافة رابط webhook في أي مكان في Wbiztool.

متطلبات المشغل#

• إضافة Unibox. يستخدم المشغّل مستمع Unibox على رقمك. بدون الإضافة، يفشل تفعيل Zap مع Unibox add-on subscription required. اشترِها من Billing & Plans (الفوترة والباقات): 20 دولارًا شهريًا أو 200 دولار سنويًا لكل رقم WhatsApp مستخدم في Unibox.
• خانة Unibox متاحة. إذا لم يكن الرقم مستمع Unibox بعد، فإنه يُحتسب ضمن عدد المستمعين الذي تسمح به إضافتك. الأرقام التي لها مستمع بالفعل لا تستخدم خانة أخرى.
• دور Owner أو Editor. يجب أن ينتمي مفتاح API إلى مالك (Owner) أو محرر (Editor) في مساحة العمل.
• رقم WhatsApp متصل. يجب أن يبقى الرقم متصلًا لالتقاط الرسائل الجديدة.

كيف يعمل المشغّل مع مستمعيك#

• لا تبدأ Zap إلا الرسائل الواردة. أما الرسائل المرسلة من رقمك فلا تبدؤه.
• لا تُرسل إلا الرسائل المستلمة بعد تفعيل Zap. لا يُعاد إرسال الرسائل الأقدم.
• إذا كان للرقم بالفعل مستمع برابط webhook خاص بك، يحل webhook الخاص بـ Zapier محله ما دام Zap مفعّلًا. عند إيقاف Zap، يُعاد رابط webhook وسره وإعدادات الأحداث الخاصة بك.
• إذا حذفت Zap دون إيقافه أولًا، تتوقف Wbiztool عن الإرسال إليه بمجرد أن يبلّغ Zapier بأن Zap لم يعد موجودًا.
• في Unibox listeners (مستمعو Unibox)، يعرض المستمع شارة Zapier. إذا حذفته أو عطّلته هناك، يبقى Zap مفعّلًا في Zapier لكنه لا يتلقى أي رسائل، وتحذّرك الصفحة أولًا. لإيقاف Zap، أوقفه في Zapier بدلًا من ذلك. لاستئناف تدفق الرسائل بعد حذف المستمع، أوقف Zap ثم فعّله مرة أخرى في Zapier.

راجع مستمعو Webhook لمعرفة كيف يعمل المستمعون وwebhooks.

بيانات المشغل#

يتلقى كل تشغيل لـ Zap رسالة واحدة، مثل هذه:

{
  "event": "message_received",
  "timestamp": "2026-09-16T10:31:12.482913+00:00",
  "webhook_id": 42,
  "whatsapp_client_id": "678",
  "whatsapp_phone": "919812345678",
  "message": {
    "id": "[email protected]_3EB0C1A2B3D4E5F60718",
    "type": "chat",
    "content": "Hi, is my order #4821 out for delivery?",
    "from": "919876543210",
    "from_name": "Aman",
    "to": "919812345678",
    "timestamp": "2026-09-16T10:29:58+00:00",
    "whatsapp_timestamp": 1789554598,
    "direction": "incoming",
    "status": "pending",
    "is_forwarded": false,
    "forwarding_score": 0
  },
  "contact": {
    "whatsapp_id": "[email protected]",
    "phone": "919876543210",
    "lid": null,
    "phone_hidden": false,
    "name": "Aman",
    "is_group": false,
    "is_business": false
  },
  "organisation": {
    "id": "5021",
    "name": "Acme Stores"
  }
}

تتضمن بعض الرسائل حقولًا إضافية: message.media (اسم الملف ونوعه وحجمه) للوسائط، وmessage.quoted_message_id للردود وgroup لرسائل المجموعات.

مثال: سجّل الرسائل الواردة في Google Sheets#

1. المشغّل: Wbiztool، Incoming WhatsApp Message.
2. الإجراء: Google Sheets، Create Spreadsheet Row (إنشاء صف في الجدول). اربط Contact Phone (هاتف جهة الاتصال) بعمود Phone، وContact Name (اسم جهة الاتصال) بعمود Name، وMessage Content (محتوى الرسالة) بعمود Message.

أرسل رسائل WhatsApp من Zap#

أضف Wbiztool كإجراء واختر أحد أحداث الإجراء التالية:

في كل إجراء، اختر رقم الإرسال تحت WhatsApp Number. أدخل رقم هاتف المستلم مع رمز الدولة، مثل 919876543210، أو ضع رمز الدولة في الحقل الاختياري Country Code (رمز الدولة)، مثل 91. لا يحتوي Send WhatsApp Message on Group على هاتف ولا رمز دولة؛ بل يأخذ Group Name (اسم المجموعة) بدلًا من ذلك.

عندما لا تستطيع Wbiztool قبول رسالة، تفشل الخطوة ويعرض Zapier السبب، مثل WbizTool: Invalid phone number أو WbizTool: Not enough credits. تعني الخطوة الناجحة أن الرسالة أُضيفت إلى قائمة الانتظار. ثم ترسلها Wbiztool من رقمك المتصل.

يمكنك أيضًا استدعاء API مباشرة باستخدام Webhooks by Zapier:

راجع أرسل رسائل WhatsApp من أي أداة أتمتة لمعرفة معنى كل حقل، وإرسال رسالة لكل الخيارات.

استكشاف الأخطاء وإصلاحها#