التكاملات
GoHighLevel وWhatsApp
اربط GoHighLevel (HighLevel) بـ WbizTool، فترسل مسارات العمل لديك رسائل WhatsApp من رقم WhatsApp الخاص بك. ويمكن أن تعود رسائل WhatsApp الواردة إلى HighLevel أيضًا، كملاحظة أو وسم أو مهمة على جهة الاتصال.
كل ما في هذه الصفحة يستخدم ميزات موجودة بالفعل لدى الطرفين: webhooks مسارات العمل في HighLevel، وAPI إرسال رسالة وwebhooks الرسائل الواردة في WbizTool. لا تحتاج إلى تثبيت أي شيء.
من يمكنه ذلك: في WbizTool، ينشئ المالك مفتاح API (راجع مفاتيح API)، ويُعدّ المالك أو المحرر webhooks الرسائل الواردة. في HighLevel، يبنيها شخص يستطيع تعديل مسارات العمل في الحساب الفرعي. ويجب أن تفعّل الوكالة ميزات مسارات العمل المميزة في HighLevel (راجع قبل أن تبدأ).
ما يمكنك فعله#
| الاتجاه | مثال | الطريقة |
|---|---|---|
| HighLevel ← WhatsApp | يُرسَل نموذج، أو يُضاف وسم، أو يُحجز موعد، فتتلقى جهة الاتصال رسالة WhatsApp. | إجراء Custom Webhook في مسار عمل HighLevel يستدعي API إرسال رسالة في WbizTool. |
| WhatsApp ← HighLevel | يراسل عميل رقم WhatsApp الخاص بك، فتُضاف الرسالة كملاحظة على جهة اتصاله في HighLevel. وتُنشأ جهة الاتصال إن لم تكن موجودة بعد. | يرسل رقم في صندوق الوارد في WbizTool كل رسالة إلى مشغّل Inbound Webhook في HighLevel. يتطلب ذلك إضافة Unibox. |
قبل أن تبدأ#
- رقم WhatsApp متصل في أرقام WhatsApp، وWhatsApp Client ID الخاص به (المعرّف الظاهر للرقم)، مثل
678. - مفتاح API من WbizTool من الإعدادات ← مفاتيح API. في HighLevel يوضع في ترويسة
Authorization: Bearer، فلا تحتاج إلى Client ID. راجع إرسال المفتاح في ترويسة. - ميزات مسارات العمل المميزة في HighLevel. يصنّف HighLevel كلًّا من Custom Webhook وInbound Webhook ضمن ميزات مسارات العمل المميزة (premium). يمكن للوكالات على أي باقة HighLevel تفعيلها: في Agency View، انتقل إلى Settings → Company وفعّل Workflow - Premium Features. يحتسب HighLevel رسومًا على كل تشغيل مميز، ويحصل كل حساب فرعي على 100 تشغيل مميز مجانًا (مرة واحدة، لا كل شهر). ويمكن للوكالة إعادة تحميل هذه الرسوم على الحساب الفرعي. أسعار HighLevel موجودة في صفحة المساعدة الخاصة به.
- للرسائل الواردة فقط: إضافة Unibox على باقة WbizTool مدفوعة أو باقة مدى الحياة (لا الفترة التجريبية المجانية). تكلفتها 20 دولارًا شهريًا أو 200 دولار سنويًا بأسعار القائمة الأمريكية لكل رقم WhatsApp في صندوق الوارد. يضيفها المالك في الفوترة والباقات (راجع الإضافات).
اختر طريقة الربط#
مسارات عمل HighLevel هي الطريق الأقصر: يستدعي HighLevel WbizTool مباشرة، دون أي أداة أخرى بينهما. لا تستخدم أداة أتمتة إلا إذا كانت مسارات العمل لديك تعمل فيها بالفعل.
| الطريقة | الإرسال (HighLevel ← WhatsApp) | الاستقبال (WhatsApp ← HighLevel) | ما تحتاجه |
|---|---|---|---|
| مسارات عمل HighLevel (موصى بها) | إجراء Custom Webhook ← API إرسال رسالة | webhook من WbizTool ← مشغّل Inbound Webhook | ميزات مسارات العمل المميزة في HighLevel. الاستقبال: إضافة Unibox. |
| Zapier | LeadConnector Pipeline Stage Changed ← WbizTool Send Text-Only WhatsApp Message | WbizTool Incoming WhatsApp Message ← LeadConnector Add/Update Contact أو Add Task | حساب Zapier. الاستقبال: إضافة Unibox. |
| Make | إجراء Webhook في HighLevel ← Webhooks في Make ← وحدة HTTP | webhook من WbizTool ← Webhooks في Make ← API HighLevel | حساب Make. الاستقبال: إضافة Unibox. |
| n8n | إجراء Webhook في HighLevel ← Webhook في n8n ← WbizTool Send Message | webhook من WbizTool ← Webhook في n8n ← عقدة HighLevel | n8n مع العقدة المجتمعية لـ WbizTool. الاستقبال: إضافة Unibox. |
| Pabbly Connect | إجراء Webhook في HighLevel ← مشغّل webhook في Pabbly ← طلب API (Pabbly) | webhook من WbizTool ← مشغّل webhook في Pabbly ← خطوة HighLevel الخاصة بك | حساب Pabbly Connect. الاستقبال: إضافة Unibox. |
إرسال رسائل WhatsApp من مسار عمل في HighLevel#
افتح مسار عمل أو أنشئه
في حسابك الفرعي في HighLevel، افتح Automation وأنشئ مسار عمل، أو عدّل مسارًا موجودًا. أعطه المشغّل الذي تريده، مثل إرسال نموذج أو وسم جديد أو موعد محجوز.
أضف إجراء Custom Webhook
انقر على + حيث يجب أن تُرسل الرسالة، ثم Send Data → Custom Webhook (أو ابحث في الإجراءات عن "webhook" واختر Custom Webhook). أما إجراء Webhook العادي فلا يستطيع ضبط الترويسة والجسم اللذين يحتاجهما هذا API.
اضبط الطلب
اضبط Event على CUSTOM وMethod على POST. اضبط URL على
https://wbiztool.com/api/v1/send_msg/. في Authorization، اختر Bearer Token والصق مفتاح API من WbizTool، أو اختر بدون مصادقة وأضف الترويسةAuthorizationبالقيمةBearer YOUR_API_KEY. اضبط Content-Type علىapplication/json.الصق الجسم
الصق إحدى الكتل الجاهزة للنسخ في Raw Body واستبدل
678بـ WhatsApp Client ID الخاص بك. استخدم أيقونة الوسم في HighLevel لإضافة حقول أخرى من جهة الاتصال إلى الرسالة.اختبر وانشر
احفظ الإجراء وانشر مسار العمل. شغّله على جهة اتصال تجريبية برقم هاتفك. يظهر كل تشغيل في سجلات التنفيذ الخاصة بمسار العمل. عندما تقبل WbizTool الرسالة، تجيب بـ
"status": 1. ثم تُرسل الرسالة من رقم WhatsApp الخاص بك.
حقل رقم الهاتف#
استخدم {{contact.phone_raw}}، لا {{contact.phone}}. فـ {{contact.phone}} في HighLevel منسّق للقراءة، مثل (515) 555-2345، دون رمز الدولة. أما {{contact.phone_raw}} فهو الرقم نفسه بالصيغة الدولية، مثل +15155552345.
تزيل WbizTool علامة + والمسافات والشرطات والأقواس نيابةً عنك. الرقم المكتوب بـ + يتضمن رمز دولته بالفعل، فلا تحتاج إلى إرسال country_code. إذا حُفظت بعض جهات اتصالك دون رمز الدولة، فأضف "country_code": "1" (رمز الاتصال لدولتك) إلى الجسم. لا يُضاف إلا إلى الأرقام المكتوبة دون +. راجع إرسال رسالة ← phone.
كتل جاهزة للنسخ#
الرابط: https://wbiztool.com/api/v1/send_msg/ · الطريقة: POST · الترويسات: Authorization: Bearer YOUR_API_KEY وContent-Type: application/json
{
"whatsapp_client": 678,
"phone": "{{contact.phone_raw}}",
"msg": "Hi {{contact.first_name}}, thanks for contacting {{location.name}}. We'll reply here on WhatsApp."
}{
"whatsapp_client": 678,
"msg_type": 1,
"phone": "{{contact.phone_raw}}",
"img_url": "https://example.com/images/welcome-offer.jpg",
"msg": "Hi {{contact.first_name}}, here is your welcome offer from {{location.name}}."
}{
"whatsapp_client": 678,
"msg_type": 2,
"phone": "{{contact.phone_raw}}",
"file_url": "https://example.com/files/price-list.pdf",
"file_name": "price-list.pdf",
"msg": "Hi {{contact.first_name}}, here is our price list."
}{
"whatsapp_client": 678,
"phone": "{{contact.phone_raw}}",
"msg": "Hi {{contact.first_name}}, a reminder of your appointment with {{location.name}} at {{appointment.start_time}}.",
"expire_after_seconds": 3600
}{
"whatsapp_client": 678,
"group_name": "Sales team",
"msg": "New lead: {{contact.name}}, {{contact.phone_raw}}, {{contact.email}}"
}whatsapp_client: معرّف الرقم الذي تُرسل منه. لا يمكنك حذفه إلا عندما يكون في مساحة عملك رقم متصل واحد بالضبط.msg: حتى 3,000 حرف. يعمل تنسيق WhatsApp: *bold*و_italic_. لسطر جديد، اكتب\nداخل النص. فاصل الأسطر الحقيقي يجعل JSON غير صالح.- الصور والملفات: يجب أن تكون الروابط عامة. تصبح
msgهي التعليق. راجع إرسال الصور والملفات. expire_after_seconds: إذا لم تُرسل الرسالة خلال هذه المدة، مثلًا لأن الرقم انقطع اتصاله، تُعلَّم منتهية الصلاحية ولا تُرسل.- المجموعات:
group_nameهو الاسم الدقيق لمجموعة WhatsApp يوجد فيها رقمك. أرسلgroup_nameأوphone، لا الاثنين معًا أبدًا. راجع الإرسال إلى مجموعة.
تسجيل رسائل WhatsApp الواردة في HighLevel#
يتطلب هذا الاتجاه إضافة Unibox. تُرسَل كل رسالة يستلمها رقم WhatsApp الخاص بك إلى مشغّل Inbound Webhook في HighLevel. ثم يعثر مسار العمل على جهة الاتصال أو ينشئها ويضيف الرسالة كملاحظة أو وسم أو مهمة. لا تظهر الرسائل في أي مكان آخر في HighLevel.
أنشئ مسار عمل بمشغّل Inbound Webhook
في HighLevel، أنشئ مسار عمل واختر المشغّل Inbound Webhook. انسخ رابط webhook الذي يعرضه.
وجّه رقم WhatsApp الخاص بك إليه
في WbizTool، افتح أرقام صندوق الوارد. انقر على إضافة رقم إلى صندوق الوارد، واختر الرقم والصق رابط HighLevel تحت رابط Webhook (اختياري). للرقم الموجود بالفعل في صندوق الوارد، الصقه في إعدادات webhook الخاصة بالرقم. تحت الرسائل المراد إرسالها، حدّد الرسائل المستلمة فقط. كل إرسال هو تشغيل مميز واحد في HighLevel، لذا اترك الرسائل المُرسَلة غير محددة ما لم تحتج إليها.
أرسل رسالة تجريبية
من هاتف آخر، أرسل رسالة إلى رقم WhatsApp الخاص بك. تُرسَل بعد الفحص التالي، عادةً خلال دقيقة أو دقيقتين. في HighLevel، انقر على Test Trigger، واختر الطلب تحت Mapping Reference واحفظ المشغّل. الحقول مذكورة في الحمولة.
تخطَّ المجموعات والأرقام المخفية
أضف خطوة If/Else لا تتابع إلا عندما يكون
eventهوmessage_received، وcontact.is_groupهوfalse، وcontact.phoneغير فارغ. يخفي WhatsApp أحيانًا رقم المرسل، ورسائل المجموعات تحمل معرّف المجموعة بدلًا من رقم هاتف.اعثر على جهة الاتصال أو أنشئها
في إجراء Create/Update Contact، اضبط Phone على
+متبوعًا بـ contact → phone من قيم Inbound Webhook. ترسل WbizTool الرقم دون+، وعلامة+تخبر HighLevel بأنه يتضمن رمز الدولة. يمكنك أيضًا ربط contact → name. إنه اسم المرسل على WhatsApp، وقد يحل محل اسم عدّلته في HighLevel.أضف الرسالة إلى جهة الاتصال
أضف إجراء Add to Notes. اكتب ملاحظة مثل "رسالة WhatsApp:" واختر message → content وmessage → timestamp من قيم Inbound Webhook. يمكنك أيضًا إضافة Add Contact Tag (مثل
whatsapp)، أو مهمة أو إشعار داخلي لفريقك.انشر
انشر مسار العمل وأرسل رسالة تجريبية أخرى.
| قيمة Inbound Webhook | استخدمها لـ |
|---|---|
contact.phone | هاتف جهة الاتصال. أضف + في بدايته. |
contact.name | اسم المرسل على WhatsApp. قد يكون فارغًا. |
message.content | النص. للصور والرسائل الصوتية والملفات يكون تسمية مثل 📸 Image، ولا تُضمَّن التعليقات. |
message.timestamp | وقت إرسال الرسالة على WhatsApp (ISO 8601، بتوقيت UTC). |
message.media.url | رابط تنزيل لصورة أو ملف. تنتهي صلاحيته بعد 3.5 إلى 7 أيام، فلا تعتمد عليه في ملاحظة. |
whatsapp_phone | أي من أرقامك استلمها، إذا كانت عدة أرقام ترسل إلى مسار العمل نفسه. |
event | message_received أو message_sent. |
- الرسائل الجديدة فقط تُرسَل، من لحظة ضبط webhook. لا تُستورد المحادثات الأقدم.
- webhook واحد لكل رقم. يرسل كل رقم في صندوق الوارد إلى رابط واحد. إذا استخدم Zap في Zapier المشغّل Incoming WhatsApp Message للرقم نفسه، يستولي Zap على webhook ما دام مفعّلًا.
- الرد من HighLevel: للرد على WhatsApp من مسار العمل نفسه، أضف إجراء Custom Webhook مع
"phone": "{{contact.phone_raw}}". - أبقِ الرابط سريًا. لا يتحقق Inbound Webhook في HighLevel من توقيع WbizTool، لذا يستطيع أي شخص لديه الرابط أن يرسل إليه. إذا تسرّب، فأنشئ مشغّلًا جديدًا والصق رابطه في WbizTool.
Zapier#
تطبيق HighLevel على Zapier اسمه LeadConnector. له مشغّل واحد، Pipeline Stage Changed. ومن إجراءاته Add/Update Contact وAdd Task. راجع تكامل Zapier لربط WbizTool.
- الإرسال: المشغّل LeadConnector Pipeline Stage Changed، ثم خطوة Filter by Zapier للمرحلة التي تريدها، ثم WbizTool Send Text-Only WhatsApp Message. اختر الرقم تحت WhatsApp Number، واربط هاتف جهة الاتصال بـ Phone Number واكتب Message. لأحداث HighLevel الأخرى، استخدم إجراء Custom Webhook بدلًا من ذلك.
- الاستقبال: المشغّل WbizTool Incoming WhatsApp Message (يتطلب إضافة Unibox)، ثم خطوة Filter by Zapier لا تتابع إلا عندما تكون Contact Phone Hidden وIs Group خاطئتين (false). ثم LeadConnector Add/Update Contact مع ضبط الهاتف على
+وContact Phone، ثم LeadConnector Add Task مع Message Content.
Make#
تطبيق HighLevel على Make اسمه GoHighLevel. تستخدم هذه القوالب وحدات Make العامة فقط: Webhooks وJSON وHTTP، فلا تحتاج إلى اتصال GoHighLevel في Make. ويحتاج قالب الاستقبال بدلًا من ذلك إلى رمز Private Integration من HighLevel ومعرّف الموقع (location ID) الخاص بك (راجع أدناه).
استورد المخطط
نزّل قالبًا من القوالب أدناه. في Make، أنشئ سيناريو، وافتح القائمة … واختر Import blueprint.
أنشئ webhook
افتح وحدة Webhooks، وانقر على Add لإنشاء webhook وانسخ عنوانه.
املأ العناصر النائبة
استبدل كل عنصر نائب مكتوب بأحرف كبيرة في وحدات HTTP، مثل
YOUR_WBIZTOOL_API_KEYوYOUR_WHATSAPP_CLIENT_ID.اربط webhook
الإرسال: في HighLevel، أضف إجراء Webhook إلى مسار العمل مع عنوان Make كرابط له. تحت Custom Data، أضف المفتاح
phone_rawبالقيمة{{contact.phone_raw}}. الاستقبال: الصق عنوان Make كرابط webhook للرقم في أرقام صندوق الوارد، مع تحديد الرسائل المستلمة فقط.شغّله مرة واحدة
انقر على Run once في Make وشغّل مسار العمل، أو أرسل رسالة WhatsApp إلى رقمك.
يكتب قالب الاستقبال إلى HighLevel عبر API الخاص به باستخدام رمز Private Integration من إعدادات حسابك الفرعي، مع النطاق contacts.write، ومعرّف الموقع لحسابك الفرعي. يمكنك بدلًا من ذلك استخدام وحدتي Create a Contact وAdd a Note to the Contact من تطبيق GoHighLevel.
n8n#
في n8n عقدة HighLevel مدمجة. عمليتها Contact → Create or Update تعثر على جهة اتصال بالهاتف أو البريد الإلكتروني، أو تنشئ واحدة، ويمكنها إضافة Note. ثبّت العقدة المجتمعية لـ WbizTool أولًا: راجع تكامل n8n.
استورد مسار العمل
نزّل قالبًا من القوالب أدناه. في n8n، أنشئ مسار عمل واستورد الملف (القائمة … ← Import from File، أو الصق JSON على اللوحة).
أضف بيانات الاعتماد
افتح عقدة WbizTool Send Message واختر بيانات اعتماد WbizTool API أو أنشئها. في مسار عمل الاستقبال، افتح عقدة HighLevel واختر بيانات اعتماد HighLevel أو أنشئها.
اربط webhook
انسخ رابط الإنتاج (production URL) لعقدة Webhook. الإرسال: استخدمه كرابط لإجراء Webhook في HighLevel، مع مفتاح Custom Data
phone_rawمضبوطًا على{{contact.phone_raw}}. الاستقبال: الصقه كرابط webhook للرقم في أرقام صندوق الوارد، مع تحديد الرسائل المستلمة فقط.فعّل
فعّل مسار العمل وشغّل اختبارًا.
Pabbly Connect#
استخدم مشغّل webhook الخاص بـ Pabbly Connect وإجراء API (Pabbly)، مضبوطين كما في أرسل رسائل WhatsApp من أي أداة أتمتة. لاتجاه الإرسال، وجّه إجراء Webhook في HighLevel إلى رابط webhook في Pabbly واربط phone_raw بـ phone. للرسائل الواردة، الصق رابط webhook في Pabbly كرابط webhook للرقم في أرقام صندوق الوارد.
القوالب#
| الملف | ما يفعله |
|---|---|
| ghl-blocks.md | الكتل الجاهزة للنسخ الموجودة في هذه الصفحة، في ملف واحد. |
| gohighlevel-to-whatsapp.make.json | Make: webhook من HighLevel ← رسالة WhatsApp. |
| whatsapp-to-gohighlevel.make.json | Make: رسالة WhatsApp واردة ← جهة اتصال وملاحظة في HighLevel. |
| gohighlevel-to-whatsapp.n8n.json | n8n: webhook من HighLevel ← رسالة WhatsApp. |
| whatsapp-to-gohighlevel.n8n.json | n8n: رسالة WhatsApp واردة ← جهة اتصال في HighLevel مع ملاحظة. |
لا تحتوي القوالب على أي مفاتيح. أضف مفاتيحك في العناصر النائبة أو بيانات الاعتماد بعد الاستيراد.
استكشاف الأخطاء وإصلاحها#
| المشكلة | ما يجب فعله |
|---|---|
تذهب الرسالة إلى رقم خاطئ، أو Invalid phone number | استخدم {{contact.phone_raw}}، لا {{contact.phone}}. إذا لم يكن لرقم جهة الاتصال رمز دولة في HighLevel، فأضف country_code إلى الجسم أو صحّح جهة الاتصال. |
Either phone or group_name parameter is required | ليس لجهة الاتصال رقم هاتف. أضف خطوة If/Else قبل الإجراء. |
Auth Error: invalid api key | تحقق من ترويسة Authorization: Bearer، ثم مسافة، ثم المفتاح، دون علامات اقتباس. ربما حُذف المفتاح. راجع مفاتيح API. |
Invalid whatsapp client أو Invalid whatsapp client id. | استخدم WhatsApp Client ID من أرقام WhatsApp. وهو مطلوب عندما يكون لديك أكثر من رقم. |
Invalid JSON format: … | الجسم ليس JSON صالحًا: فاصلة ناقصة، أو فاصلة زائدة في النهاية، أو فاصل أسطر حقيقي في msg، أو قيمة مدمجة فيها علامة اقتباس مزدوجة. |
"status": 1، لكن لا يصل شيء | تبقى الرسالة في قائمة الانتظار حتى يتصل رقم WhatsApp الخاص بك. تحقق من أرقام WhatsApp وحالة الرسالة. |
| إجراء Custom Webhook أو Inbound Webhook غير موجود | لم تفعّل الوكالة ميزات مسارات العمل المميزة (Workflow - Premium Features)، أو استنفد الحساب الفرعي تشغيلاته المجانية ولا تُعاد الرسوم عليه. اسأل وكالتك. |
| لا تصل أي رسائل واردة إلى HighLevel | يجب أن يظهر الرقم بالحالة قيد المزامنة في أرقام صندوق الوارد، مع الرابط الصحيح وتحديد الرسائل المستلمة. يجب أن يجيب المستقبِل بـ 2xx خلال 8 ثوانٍ. تصل الطلبات بـ User-Agent WbizTool-Webhooks/1 (+https://wbiztool.com)، تحسبًا لجدار حماية يرشّح الطلبات بحسبه. المزيد في webhooks الرسائل الواردة. |
| يتطلب إضافة Unibox | تحتاج الرسائل الواردة إلى إضافة Unibox على باقة مدفوعة أو باقة مدى الحياة. راجع الباقات والفوترة. |
| تُنشأ جهة اتصال جديدة مع كل رسالة | اربط Phone مع + في بدايته، ليطابق HighLevel جهة الاتصال الموجودة. |
| محادثات المجموعات تنشئ جهات اتصال غريبة | تخطَّ الرسائل التي يكون فيها contact.is_group هو true في خطوة If/Else. |
| توقفت الرسائل الواردة بعد تفعيل Zap | Zap فيه مشغّل WbizTool Incoming WhatsApp Message يستولي على webhook الخاص بالرقم ما دام مفعّلًا. أوقف Zap، أو استخدم رقمًا آخر. |
ذات صلة#
- API إرسال رسالة: كل حقل وكل خطأ
- webhooks الرسائل الواردة: أرقام صندوق الوارد، والتسليم، والحمولة
- مفاتيح API وClient ID
- تكامل Zapier
- تكامل n8n
- الإرسال من أي أداة أتمتة: Make وPabbly Connect وغيرهما

