التكاملات

التكامل هو ما يحوِّل WA Sender Plus من إضافة Chrome إلى منصة أتمتة. وهو يعمل في الاتجاهين:

• الصادر — واجهة HTTP API حقيقية لرقم واتساب الخاص بك. أي سكربت أو خادم أو أداة بلا كود يمكنه إرسال رسائل واتساب بطلب POST واحد، مع مصادقة برمز شخصي.
• الوارد — كل رسالة تصل إلى واتساب الخاص بك تُسلَّم، لحظيًا، إلى سير عمل في حسابك الخاص على n8n — الذي ينشئه WA Sender Plus ويوصِّله من أجلك.

اجمع الاتجاهين معًا فيصبح واتساب عقدة في منظومة عملك: العملاء المحتملون يدخلون Google Sheets في اللحظة التي يراسلونك فيها، وGmail ينبّهك عند الكلمات المفتاحية الساخنة، ومتجرك يؤكد الطلبات على واتساب تلقائيًا، ويمكن لوكيل ذكاء اصطناعي قراءة المحادثات والرد عليها — كل ذلك دون كتابة خادم خلفي.

نافذة الوصول إلى API

كل شيء يعيش في مكان واحد: افتح أيقونة التكاملات في الشريط واختر الوصول إلى API. النافذة من نصفين يعكسان الاتجاهين: الصادر — إرسال الرسائل في الأعلى والوارد — الاستقبال عبر n8n في الأسفل.

نافذة الوصول إلى API — واجهة الإرسال الصادر في الأعلى وتدفق n8n المُدار للوارد في الأسفل

الصادر — إرسال الرسائل

العنوان يقولها بوضوح: "أرسل رسائل واتساب عبر الـ API. الرمز أدناه هو مفتاح الوصول (استخدمه كـ Bearer)." الرسائل التي ترسلها عبر الـ API تخرج من رقمك أنت، عبر تبويب WhatsApp Web المفتوح لديك — وتبدو للمستلم تمامًا كرسالة كتبتها بنفسك.

يعرض سطر الحالة الارتباط الحي بين الإضافة وخادم الـ API: غير متصل، جارٍ الاتصال…، متصل، أو خطأ في المصادقة. لا يعمل الإرسال إلا عندما تقرأ الحالة متصل.

أنشئ رمزك

1. تأكد أنك مسجَّل الدخول في WhatsApp Web (وإلا أخبرتك النافذة: "سجّل الدخول إلى WhatsApp Web أولاً.").
2. اضغط اتصل وأنشئ رمزًا. يمتلئ حقل رمز API بمفتاح يبدأ بـ wa_live_ — انسخه الآن. الخادم يخزّن تجزئة (hash) فقط، لذا يظهر الرمز الكامل هذه المرة الوحيدة.
3. انتهيت. تتحول الحالة إلى متصل ويصبح الرمز فعّالًا.

تحتاج مفتاحًا جديدًا؟ إعادة إنشاء الرمز تبدّله (يتوقف القديم فورًا). قطع الاتصال والإلغاء يقتل الرمز ويُخرج الرقم من الخدمة لمن يستدعي الـ API.

زر جرّبها بنفسك يفتح مستكشف الـ API التفاعلي على https://waapi.effess.in/v1/docs — وحدة تحكم حية تلصق فيها رمزك وتطلق استدعاءات تجريبية من المتصفح وتقرأ المخطط الكامل لكل نقطة نهاية.

أرسل رسالة نصية

طلب واحد:

curl -X POST https://waapi.effess.in/v1/wa/messages/text \
  -H "Authorization: Bearer wa_live_…your-token…" \
  -H "Content-Type: application/json" \
  -d '{"to": "919876543210", "message": "Hello from the API 👋"}'

• to — هاتف المستلم بالصيغة الدولية، أرقام فقط، بلا + (مثال: 919876543210).
• message — النص، حتى 65,536 حرفًا.

الرد الناجح يحمل معرّف رسالة واتساب الحقيقي من الجهاز:

{ "success": true, "result": { "messageId": "3EB0…" } }

أرسل وسائط وملفات

POST /v1/wa/messages/media يرسل صورة أو فيديو أو ملفًا صوتيًا أو مستندًا:

curl -X POST https://waapi.effess.in/v1/wa/messages/media \
  -H "Authorization: Bearer wa_live_…your-token…" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "type": "image",
    "dataUrl": "data:image/jpeg;base64,/9j/4AAQ…",
    "fileName": "offer.jpg",
    "caption": "This week only"
  }'

• type — ‏image أو video أو audio أو document (الافتراضي document).
• الملف نفسه يُرسَل كـ dataUrl (بصيغة data:<mime>;base64,<data>)، أو كـ base64 مع mimeType.
• ‏fileName وcaption اختياريان.

أرسل أزرارًا تفاعلية

الرمز نفسه يمكنه أيضًا إطلاق رسائل الأزرار عبر POST /v1/wa/baileys/send-buttons. الأزرار لا تمر عبر تبويب WhatsApp Web لديك — بل تخرج من رقم متصل على الخادم عبر Connect WhatsApp في لوحة التحكم (راجع قسم جانب الخادم في مستند أدوات Agentic). إذا ربطت رقمًا هناك، تستطيع تدفقات n8n لديك إرسال أزرار الرد السريع وأزرار الروابط وقوائم الاختيار فورًا.

الحالة والأخطاء والحدود

حدود المعدل: 60 استدعاء نص و30 استدعاء وسائط في الدقيقة. وأمر لا تحميك منه الحدود: استدعاءات الـ API تنطلق في لحظة استدعائها بالضبط — إيقاع المرسل الجماعي الشبيه بالبشر لا يُطبَّق هنا. إذا برمجت سلسلة رسائل، أضف تأخيرات عشوائية بنفسك واقرأ دليل منع الحظر أولًا.

الوارد — الاستقبال عبر n8n

هذا هو النصف الذي يجعل الميزة مميزة. بدل أن نطلب منك استئجار خادم واستضافة مستقبِل webhook، يمنحك WA Sender Plus حساب n8n مُدارًا — تسجيل دخول خاص بك على نسخة n8n مستضافة، يُنشأ من داخل الإضافة. ‏n8n هي أداة الأتمتة مفتوحة المصدر التي تستخدمها مئات آلاف الفرق: تدفقات مرئية، مئات الموصِّلات الجاهزة (Google وأنظمة CRM والمتاجر والذكاء الاصطناعي)، دون الحاجة إلى كود.

ترشدك النافذة عبر خطوتين مرقّمتين، تمامًا كما هما في الواجهة.

أنشئ حساب n8n الخاص بك

اكتب بريدك تحت بريدك الإلكتروني واضغط إنشاء حساب n8n. تؤكد النافذة: "تم إرسال الدعوة إلى بريدك — تحقق من بريدك لتعيين كلمة مرور n8n ثم سجّل الدخول." افتح الدعوة، عيِّن كلمة مرور، وستحصل على مساحة عمل n8n كاملة خاصة بك. (إذا ظهر رابط الدعوة في النافذة أيضًا باسم فتح رابط الدعوة، يمكنك النقر عليه مباشرة.)

اربط مفتاح n8n API الخاص بك

الخطوة 2 كما تقول النافذة: "في n8n → Settings → n8n API، أنشئ مفتاحًا والصقه:". في مساحة n8n الجديدة افتح Settings → n8n API، أنشئ مفتاح API، والصقه في الحقل واضغط اتصال.

لحظة الاتصال، يبني WA Sender Plus التمديدات نيابة عنك داخل حساب n8n الخاص بك: ينشئ ويفعّل سير عمل باسم WA Incoming — رقمك، مع عقدة مشغِّل Webhook جاهزة للاستخدام. تعرض النافذة الآن تم ربط API key ورابط الويب هوك الخاص بك — العنوان الذي ستصله حركة واتساب لديك. لن تضطر أبدًا إلى إعداد المشغِّل بنفسك.

وجِّه الرسائل الواردة

فعِّل المفتاح توجيه الرسائل الواردة إلى n8n. من تلك اللحظة، يتدفق نوعان من الأحداث إلى سير عملك:

• message.received — كل رسالة واتساب واردة على رقمك.
• button.pressed — كل نقرة على زر تفاعلي أُرسل عبر بوابة الأزرار.

التسليم جاد: يُعاد إرسال كل حدث حتى 3 مرات مع تباطؤ تدريجي إذا تأخر سير عملك في الرد، وكل تسليم موقَّع (القسم التالي). المفتاح يوقف التوجيه مؤقتًا في أي وقت دون فقدان الإعداد؛ وفصل n8n يزيل سير العمل المُنشأ تلقائيًا ويمسح الاتصال.

ما الذي يستقبله سير عملك

كل حدث هو POST HTTP إلى رابط الويب هوك الخاص بك بهذا الغلاف:

{
  "event": "message.received",
  "account": "917284043210",
  "timestamp": "2026-06-10T09:30:00.000Z",
  "data": {
    "messageId": "3EB0A1B2C3…",
    "from": "[email protected]",
    "phone": "919876543210",
    "chatPhone": "919876543210",
    "senderName": "Asha Patel",
    "isGroup": false,
    "body": "Hi, what is the price?",
    "type": "chat",
    "isoTime": "2026-06-10T09:29:58.000Z",
    "isFirst": true,
    "quotedMsgId": null,
    "hasMedia": false,
    "mimetype": null,
    "lat": null,
    "lng": null
  }
}

الحقول المفيدة في لمحة:

كل طلب يحمل ترويستين: X-WA-Event (اسم الحدث) وX-WA-Signature (بصيغة sha256=<hex> — توقيع HMAC-SHA256 لجسم الطلب الخام بسرّ نقطتك)، ليتمكن سير العمل من التحقق أن الاستدعاء جاء فعلًا من WA Sender Plus.

ابنِ الأتمتة في n8n

مساحة n8n لديك لوحة مرئية: سير العمل المُنشأ تلقائيًا WA Incoming يبدأ بمشغِّل الويب هوك، وتبني بتركيب العقد بعده — مرشّحات وتحويلات وموصِّلات إلى خدمات خارجية. بلا كود: اسحب ووصِّل.

<!-- screenshot: drop /screenshots/docs/integrations/n8n-workflow.jpeg here -->

أول تدفق رد تلقائي لك

البناء الأول الكلاسيكي — الرد على أسئلة السعر تلقائيًا، من البداية للنهاية في خمس دقائق:

1. افتح سير العمل WA Incoming في n8n.
2. أضف عقدة IF بعد الويب هوك: الشرط — data.body يحتوي على price.
3. على الفرع الصحيح أضف عقدة HTTP Request: الطريقة POST، والرابط https://waapi.effess.in/v1/wa/messages/text، وترويسة Authorization: Bearer wa_live_…، والجسم {"to": "{{ $json.data.phone }}", "message": "Our price list: …"}.
4. انشر سير العمل وراسل نفسك من هاتف آخر.

اكتملت الدائرة: واتساب يدخل، المنطق في المنتصف، واتساب يخرج — باستخدام رمز الصادر نفسه من أعلى النافذة. للردود اليومية بالكلمات المفتاحية، أدوات Agentic داخل الإضافة أبسط؛ أما n8n فلِما يحتاج فيه الرد لمسّ أنظمة أخرى — استعلام المخزون، فحص الـ CRM، المدفوعات.

Google Sheets

التكامل الأكثر طلبًا، وسبب تألق مسار n8n: يأتي n8n بعقدة Google Sheets من الطراز الأول مع تسجيل دخول Google الرسمي. لا مفاتيح API تديرها — اربط حساب Google مرة واحدة داخل n8n وتصبح جداولك قابلة للكتابة من أي تدفق.

<!-- screenshot: drop /screenshots/docs/integrations/google-sheets-flow.jpeg here -->

التقط كل عميل محتمل في جدول

دفتر العملاء المحتملين في خمس دقائق:

1. في سير العمل WA Incoming، أضف عقدة IF: ‏data.isFirst تساوي true — فلا يمر إلا جهات الاتصال الجديدة كليًا.
2. أضف عقدة Google Sheets → Append row وسجّل الدخول بحساب Google.
3. اربط الأعمدة: data.phone ← الهاتف، data.senderName ← الاسم، data.body ← أول رسالة، data.isoTime ← الوقت.

انتهيت. كل جهة اتصال جديدة تهبط صفًا جديدًا في جدولك في اللحظة التي تراسلك فيها — دفتر عملاء حي يستطيع فريقك كله رؤيته وتصفيته والعمل عليه. أضف فروعًا أخرى لتسجيل إصابات كلمات مفتاحية ("مهتم"، "طلب"، "عرض") في تبويبات أخرى.

نصيحة: نتائج الحملات لها تصدير بنقرة واحدة أيضًا — عرض Analytics في المرسل الجماعي فيه زر Open in Google Sheets لكل حملة (راجع المرسل الجماعي).

أرسل من جدول

الاتجاه العكسي يعمل أيضًا: عقدة Schedule Trigger تقرأ صفوفًا من جدول (مثلًا تذكيرات الدفع لليوم)، وتمر عليها، وتستدعي واجهة الإرسال لكل صف — ثم تكتب "تم الإرسال" في عمود الحالة. قاعدتان تُبقيانه آمنًا:

• ضع عقدة Wait بتأخير عشوائي بين الإرسالات — فالـ API لا تطبّق أي إيقاع من تلقاء نفسها.
• للحملات الحقيقية لمئات الأشخاص، استخدم المرسل الجماعي بدلًا من ذلك — الإيقاع والسقف الساعي والـ spintax والتحليلات مدمجة فيه. الإرسال من جدول مخصص للقوائم الصغيرة المُطلَقة بحدث والمعاملاتية.

مزيد من أدوات Google

تسجيل دخول Google نفسه داخل n8n يفتح عائلة Workspace كاملة. كل واحدة من هذه عقدة واحدة تُضاف بعد مشغِّل الويب هوك:

Gmail

أرسل بريدًا لنفسك (أو لفريق المبيعات) عندما يحدث شيء مهم على واتساب: عقدة IF تراقب كلمات مثل عاجل أو شكوى، ثم Gmail → Send email مع المرسِل والرسالة والوقت معبأة من الحمولة. أو اعكسها — Schedule Trigger يومي يجمع عملاء اليوم المحتملين ويرسل ملخصًا واحدًا بالبريد.

Google Calendar

عندما يكتب عميل "حجز" أو "موعد" أو "عرض"، أنشئ حدثًا عبر Google Calendar → Create event، ثم أكِّد له على واتساب عبر واجهة الإرسال — عقدة HTTP Request بجسم {"to": "{{ $json.data.phone }}", "message": "تم الحجز! نراك غدًا الساعة 4 عصرًا."}.

Google Drive وDocs

أرشِف ما يهم: أضف المحادثات المهمة إلى مستند Google Doc متجدد، أو أنشئ مجلد Drive لكل عميل جديد عند أول رسالة منه (data.isFirst)، ليكون للعروض والفواتير بيت قبل أول مكالمة أصلًا.

Google Contacts

احفظ كل عميل محتمل جديد تلقائيًا: عند data.isFirst، عقدة Google Contacts → Create contact تخزّن الرقم والاسم — فيوجد العميل في دفتر عناوينك على كل أجهزتك، حتى لو لم تحفظه على الهاتف أبدًا.

اربط أي خدمة أخرى

‏Google مجرد البداية. حساب n8n لديك يأتي بـمئات الموصِّلات الجاهزة، وكلها تتركب على مشغِّل واتساب نفسه:

• أنظمة CRM — ‏HubSpot وSalesforce وZoho CRM وPipedrive: أنشئ أو حدِّث جهة اتصال/صفقة من كل محادثة واتساب.
• المتاجر — ‏Shopify وWooCommerce: الطلب الجديد يطلق تأكيدًا على واتساب عبر واجهة الإرسال؛ ورسالة "أين طلبي" تستعلم عن الطلب وترد بالحالة الحية.
• دردشة الفريق — ‏Slack وTelegram وDiscord: مرِّر العملاء الساخنين إلى قناة مبيعاتك لحظة كتابتهم.
• قواعد البيانات والمستندات — ‏Airtable وNotion وMySQL وPostgres: سجِّل، استعلم، أثرِ البيانات.
• الذكاء الاصطناعي — ‏OpenAI وأشباهه: صنِّف النية، صِغ ردًا، لخِّص شكوى عميل طويلة قبل أن يقرأها إنسان.

وللأداة الوحيدة التي بلا عقدة جاهزة: عقدة HTTP Request العامة تخاطب أي REST API على الإنترنت — في الاتجاهين، لأن جانب واتساب لديك صار هو نفسه مجرد HTTP. هذه هي فكرة الميزة كلها: لم يعد واتساب جزيرة معزولة.

جدير بالمعرفة

• الرمز يظهر مرة واحدة. الخادم يحتفظ بتجزئة فقط. فقدته؟ → إعادة إنشاء الرمز (المفتاح القديم يموت فورًا).
• الإرسال يركب تبويب WhatsApp Web المفتوح لديك. يجب أن يكون Chrome شغّالًا وWhatsApp Web مسجَّل الدخول والإضافة نشطة — وإلا تلقّى المستدعون 409 device-offline. (رسائل الأزرار هي الاستثناء: تخرج من الرقم المتصل على الخادم.)
• لا إيقاع في الـ API. باعد بين رسائل السلاسل المبرمجة بنفسك؛ وللحجم الكبير استخدم المرسل الجماعي.
• حساب n8n ملكك فعلًا. بريدك، كلمة مرورك، تدفقاتك — لا ينشئ WA Sender Plus بداخله سوى سير العمل WA Incoming. عدِّله بحرية؛ فقط أبقِ على عقدة مشغِّل الويب هوك.
• الملفات الثنائية للوسائط لا تُمرَّر إلى n8n — تصلك البيانات الوصفية (type وmimetype وfilename وduration)، لا الملف.
• حركة المجموعات معلَّمة — ‏isGroup تكون true، وfrom هو المجموعة، وauthor هو الإنسان الذي كتب.
• الرمز يشغّل أيضًا صندوق Cloud. القناة نفسها التي تحمل إرسالات الـ API تسلّم إشعارات Cloud API الحية — مع رمز متصل، يتحدّث ذلك الصندوق لحظيًا.
• كل شيء لكل رقم على حدة. كل حساب واتساب تشغّله له رمزه الخاص وتوجيه n8n الخاص به وسرّ ويب هوك خاص.

استكشاف الأخطاء

• الحالة عالقة على غير متصل — سجّل الدخول إلى WhatsApp Web ثم اضغط اتصل وأنشئ رمزًا (أو إعادة إنشاء الرمز) مجددًا.
• استدعاءات الـ API ترجع 409 device-offline — تبويب WhatsApp Web مغلق، أو فقدت الإضافة اتصالها. افتح التبويب وانتظر متصل.
• سير عمل n8n لا ينطلق — تلميح النافذة نفسه هو الحل: "لا يعمل؟ في n8n ألغِ نشر سير العمل ثم انشره مرة أخرى — هذا يسجّل الويب هوك." وتأكد أيضًا أن مفتاح توجيه الرسائل الواردة إلى n8n مفعَّل.
• "لم يتم إعداد n8n على الخادم بعد." — خدمة n8n المُدارة غير مفعَّلة في نسخة الخادم لديك؛ تواصل مع الدعم.
• "مفتاح n8n API غير صالح." — كُتب المفتاح خطأ أو حُذف في n8n. أنشئ مفتاحًا جديدًا من Settings → n8n API واربط من جديد.
• لم يصل بريد الدعوة — افحص الرسائل غير المرغوبة، أو استخدم فتح رابط الدعوة في النافذة عند ظهوره.
• حذفت سير العمل WA Incoming بالخطأ؟ اضغط فصل n8n ثم أعد خطوة الربط — سيُنشأ سير عمل ورابط ويب هوك جديدان.
• فشل التحقق من التوقيع — احسب الـ HMAC على جسم الطلب الخام (قبل أي إعادة ترميز JSON) بالسر، وقارنه بقيمة X-WA-Signature بعد البادئة sha256=.