انتقل إلى المحتوى
WbizTool

التكاملات

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.
ZapierLeadConnector ‏Pipeline Stage Changed ‏← WbizTool ‏Send Text-Only WhatsApp MessageWbizTool ‏Incoming WhatsApp Message ‏← LeadConnector ‏Add/Update Contact أو Add Taskحساب Zapier. الاستقبال: إضافة Unibox.
Makeإجراء Webhook في HighLevel ‏← Webhooks في Make ‏← وحدة HTTPwebhook من WbizTool ‏← Webhooks في Make ‏← API ‏HighLevelحساب Make. الاستقبال: إضافة Unibox.
n8nإجراء Webhook في HighLevel ‏← Webhook في n8n ‏← WbizTool Send Messagewebhook من WbizTool ‏← Webhook في n8n ‏← عقدة HighLeveln8n مع العقدة المجتمعية لـ WbizTool. الاستقبال: إضافة Unibox.
Pabbly Connectإجراء Webhook في HighLevel ‏← مشغّل webhook في Pabbly ‏← طلب API (Pabbly)webhook من WbizTool ‏← مشغّل webhook في Pabbly ‏← خطوة HighLevel الخاصة بكحساب Pabbly Connect. الاستقبال: إضافة Unibox.

إرسال رسائل WhatsApp من مسار عمل في HighLevel#

  1. افتح مسار عمل أو أنشئه

    في حسابك الفرعي في HighLevel، افتح Automation وأنشئ مسار عمل، أو عدّل مسارًا موجودًا. أعطه المشغّل الذي تريده، مثل إرسال نموذج أو وسم جديد أو موعد محجوز.

  2. أضف إجراء Custom Webhook

    انقر على + حيث يجب أن تُرسل الرسالة، ثم Send Data → Custom Webhook (أو ابحث في الإجراءات عن "webhook" واختر Custom Webhook). أما إجراء Webhook العادي فلا يستطيع ضبط الترويسة والجسم اللذين يحتاجهما هذا API.

  3. اضبط الطلب

    اضبط 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.

  4. الصق الجسم

    الصق إحدى الكتل الجاهزة للنسخ في Raw Body واستبدل 678 بـ WhatsApp Client ID الخاص بك. استخدم أيقونة الوسم في HighLevel لإضافة حقول أخرى من جهة الاتصال إلى الرسالة.

  5. اختبر وانشر

    احفظ الإجراء وانشر مسار العمل. شغّله على جهة اتصال تجريبية برقم هاتفك. يظهر كل تشغيل في سجلات التنفيذ الخاصة بمسار العمل. عندما تقبل 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

Raw Body لإجراء Custom Webhook
{
  "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: معرّف الرقم الذي تُرسل منه. لا يمكنك حذفه إلا عندما يكون في مساحة عملك رقم متصل واحد بالضبط.
  • 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.

  1. أنشئ مسار عمل بمشغّل Inbound Webhook

    في HighLevel، أنشئ مسار عمل واختر المشغّل Inbound Webhook. انسخ رابط webhook الذي يعرضه.

  2. وجّه رقم WhatsApp الخاص بك إليه

    في WbizTool، افتح أرقام صندوق الوارد. انقر على إضافة رقم إلى صندوق الوارد، واختر الرقم والصق رابط HighLevel تحت رابط Webhook (اختياري). للرقم الموجود بالفعل في صندوق الوارد، الصقه في إعدادات webhook الخاصة بالرقم. تحت الرسائل المراد إرسالها، حدّد الرسائل المستلمة فقط. كل إرسال هو تشغيل مميز واحد في HighLevel، لذا اترك الرسائل المُرسَلة غير محددة ما لم تحتج إليها.

  3. أرسل رسالة تجريبية

    من هاتف آخر، أرسل رسالة إلى رقم WhatsApp الخاص بك. تُرسَل بعد الفحص التالي، عادةً خلال دقيقة أو دقيقتين. في HighLevel، انقر على Test Trigger، واختر الطلب تحت Mapping Reference واحفظ المشغّل. الحقول مذكورة في الحمولة.

  4. تخطَّ المجموعات والأرقام المخفية

    أضف خطوة If/Else لا تتابع إلا عندما يكون event هو message_received، وcontact.is_group هو false، وcontact.phone غير فارغ. يخفي WhatsApp أحيانًا رقم المرسل، ورسائل المجموعات تحمل معرّف المجموعة بدلًا من رقم هاتف.

  5. اعثر على جهة الاتصال أو أنشئها

    في إجراء Create/Update Contact، اضبط Phone على + متبوعًا بـ contact → phone من قيم Inbound Webhook. ترسل WbizTool الرقم دون +، وعلامة + تخبر HighLevel بأنه يتضمن رمز الدولة. يمكنك أيضًا ربط contact → name. إنه اسم المرسل على WhatsApp، وقد يحل محل اسم عدّلته في HighLevel.

  6. أضف الرسالة إلى جهة الاتصال

    أضف إجراء Add to Notes. اكتب ملاحظة مثل "رسالة WhatsApp:" واختر message → content وmessage → timestamp من قيم Inbound Webhook. يمكنك أيضًا إضافة Add Contact Tag (مثل whatsapp)، أو مهمة أو إشعار داخلي لفريقك.

  7. انشر

    انشر مسار العمل وأرسل رسالة تجريبية أخرى.

قيمة Inbound Webhookاستخدمها لـ
contact.phoneهاتف جهة الاتصال. أضف + في بدايته.
contact.nameاسم المرسل على WhatsApp. قد يكون فارغًا.
message.contentالنص. للصور والرسائل الصوتية والملفات يكون تسمية مثل 📸 Image، ولا تُضمَّن التعليقات.
message.timestampوقت إرسال الرسالة على WhatsApp ‏(ISO 8601، بتوقيت UTC).
message.media.urlرابط تنزيل لصورة أو ملف. تنتهي صلاحيته بعد 3.5 إلى 7 أيام، فلا تعتمد عليه في ملاحظة.
whatsapp_phoneأي من أرقامك استلمها، إذا كانت عدة أرقام ترسل إلى مسار العمل نفسه.
eventmessage_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) الخاص بك (راجع أدناه).

  1. استورد المخطط

    نزّل قالبًا من القوالب أدناه. في Make، أنشئ سيناريو، وافتح القائمة … واختر Import blueprint.

  2. أنشئ webhook

    افتح وحدة Webhooks، وانقر على Add لإنشاء webhook وانسخ عنوانه.

  3. املأ العناصر النائبة

    استبدل كل عنصر نائب مكتوب بأحرف كبيرة في وحدات HTTP، مثل YOUR_WBIZTOOL_API_KEY وYOUR_WHATSAPP_CLIENT_ID.

  4. اربط webhook

    الإرسال: في HighLevel، أضف إجراء Webhook إلى مسار العمل مع عنوان Make كرابط له. تحت Custom Data، أضف المفتاح phone_raw بالقيمة {{contact.phone_raw}}. الاستقبال: الصق عنوان Make كرابط webhook للرقم في أرقام صندوق الوارد، مع تحديد الرسائل المستلمة فقط.

  5. شغّله مرة واحدة

    انقر على 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.

  1. استورد مسار العمل

    نزّل قالبًا من القوالب أدناه. في n8n، أنشئ مسار عمل واستورد الملف (القائمة … ‏← Import from File، أو الصق JSON على اللوحة).

  2. أضف بيانات الاعتماد

    افتح عقدة WbizTool Send Message واختر بيانات اعتماد WbizTool API أو أنشئها. في مسار عمل الاستقبال، افتح عقدة HighLevel واختر بيانات اعتماد HighLevel أو أنشئها.

  3. اربط webhook

    انسخ رابط الإنتاج (production URL) لعقدة Webhook. الإرسال: استخدمه كرابط لإجراء Webhook في HighLevel، مع مفتاح Custom Data ‏phone_raw مضبوطًا على {{contact.phone_raw}}. الاستقبال: الصقه كرابط webhook للرقم في أرقام صندوق الوارد، مع تحديد الرسائل المستلمة فقط.

  4. فعّل

    فعّل مسار العمل وشغّل اختبارًا.

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.jsonMake: ‏webhook من HighLevel ‏← رسالة WhatsApp.
whatsapp-to-gohighlevel.make.jsonMake: رسالة WhatsApp واردة ‏← جهة اتصال وملاحظة في HighLevel.
gohighlevel-to-whatsapp.n8n.jsonn8n: ‏webhook من HighLevel ‏← رسالة WhatsApp.
whatsapp-to-gohighlevel.n8n.jsonn8n: رسالة 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.
توقفت الرسائل الواردة بعد تفعيل ZapZap فيه مشغّل WbizTool ‏Incoming WhatsApp Message يستولي على webhook الخاص بالرقم ما دام مفعّلًا. أوقف Zap، أو استخدم رقمًا آخر.

ذات صلة#