التكاملات
Pipedrive وWhatsApp
اربط Pipedrive برقم WhatsApp الذي ربطته بـ WbizTool. راسل الشخص عندما تنتقل صفقته إلى مرحلة ما، وسجّل رسائل WhatsApp التي يرسلها إليك كملاحظات في Pipedrive.
ليس لدى WbizTool تطبيق على Pipedrive. تربط الاثنين بأداة قد تستخدمها بالفعل: Automations الخاصة بـ Pipedrive، أو Zapier أو Make أو n8n أو Pabbly Connect. تعرض هذه الصفحة كل طريقة خطوة بخطوة، مع قوالب جاهزة لـ Make وn8n.
من يمكنه ذلك: يستطيع أي شخص لديه مفتاح API من WbizTool إرسال الرسائل. أما تسجيل الرسائل الواردة فيتطلب إضافة Unibox (20 دولارًا شهريًا أو 200 دولار سنويًا بأسعار القائمة الأمريكية لكل رقم في صندوق الوارد، على باقة مدفوعة أو باقة مدى الحياة) ومالكًا أو محررًا لإعداد webhook. في Pipedrive، تحتاج إلى الصلاحيات التي تطلبها طريقتك (راجع اختر طريقة الربط).
ما يمكنك فعله#
| الاتجاه | مثال | ما يحتاجه في WbizTool |
|---|---|---|
| Pipedrive ← WhatsApp | تنتقل صفقة إلى Proposal sent: يتلقى الشخص "مرحبًا Emma، عرضك موجود في بريدك الوارد." يُضاف شخص جديد: يتلقى رسالة ترحيب. | مفتاح API ورقم WhatsApp متصل. |
| WhatsApp ← Pipedrive | يكتب عميل إلى رقم WhatsApp الخاص بك: تُضاف الرسالة كملاحظة على الشخص الذي يحمل رقم الهاتف ذاك، ويُنشأ الشخص إن لم يكن موجودًا في Pipedrive. | إضافة Unibox، والرقم مضاف في أرقام صندوق الوارد. |
تُرسل الرسائل من رقم WhatsApp الخاص بك، لذا تنطبق قواعد WhatsApp: راسل من يتوقعون رسائلك، مثل العملاء المحتملين والعملاء.
قبل أن تبدأ#
- رقم WhatsApp متصل في أرقام WhatsApp، وWhatsApp Client ID الخاص به من الصفحة نفسها.
- Client ID ومفتاح API من الإعدادات ← مفاتيح API. أنشئ مفتاحًا خاصًا بـ Pipedrive، لتتمكن من حذفه وحده لاحقًا. راجع مفاتيح API.
- أرقام هواتف مع رمز الدولة في Pipedrive، مثل
+44 20 7946 0018. راجع أرقام الهواتف. - للرسائل الواردة: إضافة Unibox مع رقم متاح في صندوق الوارد. راجع أرقام صندوق الوارد وwebhooks الرسائل الواردة.
اختر طريقة الربط#
| الطريقة | Pipedrive ← WhatsApp | WhatsApp ← Pipedrive | باقة Pipedrive والصلاحيات |
|---|---|---|---|
| Pipedrive Automations | نعم، دون أي أداة أخرى: إجراء webhook في الأتمتة يستدعي WbizTool API. | لا | تتوفر Automations وإجراء webhook فيها على باقة Growth وما فوقها. ولا ينشئ automated webhook إلا المسؤولون العامّون (global admins). |
| Zapier | نعم، بإجراءات تطبيق WbizTool. | نعم، بمشغّل WbizTool Incoming WhatsApp Message. | أي باقة فيها وصول إلى Zapier. |
| Make | نعم، بوحدة HTTP في Make. المخطط أدناه. | نعم، بـ webhook في Make. المخطط أدناه. | أي باقة. تستخدم المخططات webhooks في Pipedrive (كل الباقات) ورمز API من Pipedrive. |
| n8n | نعم، بـ Pipedrive Trigger وعقدة WbizTool. مسار العمل أدناه. | نعم، بعقدة Webhook وعقدة Pipedrive. مسار العمل أدناه. | أي باقة. يحتاج n8n إلى رمز API من Pipedrive. |
| Pabbly Connect | نعم، بإجراء الطلب API (Pabbly). | نعم، بمشغّل webhook فيه. | أي باقة. |
ترسل Webhooks الخاصة بـ Pipedrive (كل الباقات) جسمًا ثابتًا لا يستطيع WbizTool API قراءته، لذا لا تستدعي WbizTool مباشرة. بل تبدأ مسار عمل في Make أو n8n أو Pabbly بدلًا من ذلك، كما في وصفة Make.
أرقام الهواتف#
يكتب الطرفان الأرقام بطريقتين مختلفتين. تذكّر هذه القواعد عند ربط الحقول:
- للإرسال، مرّر هاتف Pipedrive كما هو. يزيل API إرسال رسالة المسافات والشرطات والنقاط والأقواس وعلامة
+. الرقم المكتوب بـ+، مثل+44 20 7946 0018، يحتفظ برمز دولته. أما الرقم المحلي، مثل020 7946 0018، فيحتاج إلىcountry_code(هنا44)، وإلا فإنه يذهب إلى رقم خاطئ أو يفشل. - الرسائل الواردة تعطي أرقامًا فقط. في webhook، يكون
contact.phoneهو الرقم دون+، مثل442079460018. ابحث في Pipedrive بهذه الأرقام، وأضف+في البداية عند إنشاء شخص. - يحفظ Pipedrive الهواتف كما كُتبت. يعثر بحثه على الشخص بأرقام هاتفه، لكن الرقم المحفوظ دون رمز دولته قد يفوته. احفظ الأرقام مع رمز الدولة.
- الأرقام المخفية والمجموعات. يخفي WhatsApp أحيانًا رقم المرسل: عندها يكون
contact.phoneفارغًا وcontact.phone_hiddenهوtrue. ولمحادثات المجموعاتcontact.is_groupمضبوط علىtrue. تتخطى الوصفات أدناه الحالتين.
Pipedrive Automations#
تستطيع Automations في Pipedrive إرسال طلب webhook كإجراء. وجّهه إلى API إرسال رسالة في WbizTool فترسل الأتمتة رسالة WhatsApp بنفسها، دون أي أداة أخرى.
في Pipedrive: باقة Growth أو أعلى. لا ينشئ automated webhook إلا المسؤولون العامّون؛ ويتطلب إنشاء الأتمتة صلاحيات استخدام Automations.
أنشئ automated webhook
في Pipedrive، افتح قائمة الحساب وانتقل إلى Tools and apps → Webhooks. انقر على + Webhooks واختر Automated webhook. سمّه "WbizTool"، وأدخل
https://wbiztool.com/api/v1/كرابط نقطة النهاية (endpoint URL). يجب أن ينتهي الرابط بـ/، لأن الأتمتة تضيف المسار. اترك المصادقة فارغة: بيانات اعتماد WbizTool توضع في الجسم.أنشئ الأتمتة
افتح قائمة الحساب في أعلى اليمين، وانتقل إلى Tools and apps → Automations وانقر على + Automation. اختر Event trigger، واختر deal كعنصر واضبط حدث المشغّل على Updated. اختر مرحلة الصفقة كحقل تُراقَب تغييراته، وانقر على Apply trigger. ثم أضف شرطًا يحدد اسم مرحلة الصفقة، حتى لا تعمل الأتمتة إلا عندما تنتقل صفقة إلى تلك المرحلة.
لرسالة ترحيب، اختر person كعنصر والحدث Added بدلًا من ذلك.
أضف إجراء webhook
أضف الإجراء webhook واختر webhook "WbizTool". اضبط الطريقة على POST وأضف المسار
send_msg/.املأ الجسم
اختر الجسم Key-value وأضف الحقول أدناه. استخدم زر الحقول لإدراج هاتف الشخص واسمه.
المفتاح القيمة client_idClient ID الخاص بك. api_keyمفتاح API الخاص بك. whatsapp_clientWhatsApp Client ID للرقم الذي تُرسل منه. phoneهاتف الشخص (contact person)، من زر الحقول. country_codeفقط إذا كانت أرقامك في Pipedrive محلية، دون رمز دولة: رمز الاتصال، مثل 44.msgرسالتك، مثل Hi [person's first name], your proposal is in your inbox. Reply here if you have questions.يمكنك أيضًا اختيار Raw وكتابة الحقول نفسها بصيغة JSON. مع Key-value لا تحتاج إلى الانتباه لعلامات الاقتباس في الأسماء.
اختبرها
احفظ الأتمتة، واجعلها نشطة وانقل صفقة تجريبية إلى المرحلة. افتح Automations → History ثم التشغيل: يعرض الجسم الذي أُرسل. تجيب WbizTool بـ
"status": 1عندما تُضاف الرسالة إلى قائمة الانتظار؛ أما الخطأ فيُجاب عنه بـ HTTP 400وmessage، مثلInvalid phone number.
Zapier#
استخدم تطبيق WbizTool على Zapier مع تطبيق Pipedrive على Zapier.
تتغير مرحلة صفقة: أرسل رسالة WhatsApp#
المشغّل: Pipedrive Updated Deal Stage
اختر Pipedrive والمشغّل Updated Deal Stage. لرسالة ترحيب، استخدم New Person بدلًا منه.
المرشّح: مرحلتك فقط
أضف Filter by Zapier ولا تتابع إلا عندما تكون مرحلة الصفقة هي التي تريدها. يعمل المشغّل مع كل تغيير في المرحلة.
اعثر على هاتف الشخص
إذا لم تحتوِ بيانات المشغّل على هاتف لشخص الصفقة، فأضف البحث Get Person من Pipedrive مع معرّف الشخص في الصفقة.
الإجراء: WbizTool Send Text-Only WhatsApp Message
اختر رقم الإرسال تحت WhatsApp Number. اربط هاتف الشخص بـ Phone Number، ولا تملأ Country Code إلا إذا كانت أرقامك في Pipedrive محلية، واكتب Message مع اسم الشخص.
اختبر وانشر
نجاح الخطوة يعني أن الرسالة أُضيفت إلى قائمة الانتظار. إذا لم تستطع WbizTool قبولها، تفشل الخطوة مع السبب، مثل
WbizTool: Invalid phone number.
تصل رسالة WhatsApp: أضف ملاحظة في Pipedrive#
يتطلب إضافة Unibox. راجع متطلبات المشغل.
المشغّل: WbizTool Incoming WhatsApp Message
اختر الرقم تحت WhatsApp Number. عندما تنشر Zap، تضيف WbizTool الرقم إلى صندوق الوارد وترسل رسائله المستلمة إلى Zapier.
المرشّح: أشخاص، لا مجموعات
أضف Filter by Zapier: لا تتابع إلا عندما تكون Is Group خاطئة (false) وContact Phone Hidden خاطئة (false).
اعثر على الشخص أو أنشئه
أضف Find or Create Person من Pipedrive: يبحث في الأشخاص حسب حقل (اختر حقل الهاتف، مع Contact Phone) وينشئ شخصًا عندما لا يُعثر على أحد. للشخص الجديد، اضبط الاسم على Contact Name والهاتف على
+متبوعًا بـ Contact Phone.أنشئ الملاحظة
أضف Create Note من Pipedrive. اربطها بالشخص من الخطوة السابقة، واكتب المحتوى، مثل:
WhatsApp from Contact Name: Message Content، مع Message Time إذا أردت الوقت.
Make#
لا يوجد تطبيق WbizTool على Make. يستخدم المخططان وحدات Make الخاصة: Webhooks وHTTP وJSON: وحدة HTTP تستدعي WbizTool API وAPI Pipedrive.
| المخطط | ما يفعله |
|---|---|
| pipedrive-deal-stage-to-whatsapp.blueprint.json | webhook من Pipedrive (تغيّرت صفقة) ← ترشيح على مرحلتك ← جلب شخص الصفقة ← إرسال رسالة WhatsApp إليه. |
| whatsapp-to-pipedrive-note.blueprint.json | webhook الرسائل الواردة من WbizTool ← العثور على الشخص بالهاتف ← إضافة ملاحظة، أو إنشاء الشخص أولًا. |
المخططان مبنيان على وحدات Make العامة، لذا يعملان على أي باقة Make ولا يحتاجان إلى اتصال Pipedrive في Make.
تحتاج إلى رمز API من Pipedrive (في Pipedrive، Settings → Personal preferences → API) وعنوان شركتك في Pipedrive، مثل yourcompany.pipedrive.com.
تتغير مرحلة صفقة: أرسل رسالة WhatsApp#
استورد المخطط
أنشئ سيناريو في Make، وانقر على النقاط الثلاث في الشريط السفلي، واختر Import Blueprint واختر الملف.
أنشئ webhook
افتح الوحدة الأولى (Webhooks → Custom webhook)، وانقر على Add، واحفظ، وانسخ العنوان الذي يعرضه Make.
املأ العناصر النائبة
- في المرشّح بعد webhook، استبدل
YOUR_STAGE_IDبمعرّف مرحلتك. لمعرفته، انقل صفقة تجريبية إلى المرحلة مرة واحدة واقرأdata.stage_idفي مخرجات webhook. - في وحدة Get the person، استبدل
YOUR_COMPANYوYOUR_PIPEDRIVE_API_TOKEN. - في وحدة Send WhatsApp، استبدل
YOUR_WBIZTOOL_API_KEYفي ترويسةAuthorization، وYOUR_WHATSAPP_CLIENT_IDفي الجسم، ونص الرسالة.
- في المرشّح بعد webhook، استبدل
وجّه webhook في Pipedrive إلى Make
في Pipedrive، انتقل إلى Settings → Tools and apps → Webhooks وأنشئ webhook: event action change (updated في الإصدارات الأقدم)، وevent object deal، وعنوان Make كرابط نقطة النهاية.
شغّله
شغّل السيناريو وانقل صفقة تجريبية إلى المرحلة. تعرض مخرجات وحدة HTTP إجابة WbizTool:
"status": 1يعني أن الرسالة أُضيفت إلى قائمة الانتظار.
لبنائه بوحدات Pipedrive في Make بدلًا من ذلك، استخدم Watch New Events (أو Custom webhook كما سبق)، وGet a Person، ووحدة HTTP بالطلب نفسه الموجود في وحدة Send WhatsApp في المخطط. تُرجع وحدات Pipedrive في Make شخص الصفقة كمعرّف فقط، لذا تحتاج إلى Get a Person للحصول على الهاتف.
تصل رسالة WhatsApp: أضف ملاحظة في Pipedrive#
استورد المخطط
استورد
whatsapp-to-pipedrive-note.blueprint.jsonفي سيناريو جديد.أنشئ webhook
افتح Webhooks → Custom webhook، وانقر على Add، واحفظ وانسخ العنوان.
املأ العناصر النائبة
استبدل
YOUR_COMPANYوYOUR_PIPEDRIVE_API_TOKENفي وحدات HTTP الأربع الخاصة بـ Pipedrive (البحث، وإنشاء الشخص، والملاحظتين).أضف العنوان في WbizTool
في أرقام صندوق الوارد، أضف رقمك إلى صندوق الوارد، أو افتح إعدادات webhook في بطاقته. الصق عنوان Make تحت رابط Webhook (اختياري)، وأبقِ الرسائل المستلمة وحدها محددة، واحفظ.
شغّله واختبره
شغّل السيناريو وأرسل رسالة إلى رقم WhatsApp الخاص بك من هاتف آخر. خلال دقيقة أو دقيقتين تظهر الملاحظة على الشخص في Pipedrive.
يتخطى المخطط محادثات المجموعات والأرقام المخفية والرسائل المُرسَلة. لبنائه بوحدات Pipedrive في Make بدلًا من ذلك، استخدم Search Persons على حقل الهاتف، وموجّهًا (router)، وCreate a Person وCreate a Note.
n8n#
استخدم عقدتَي Pipedrive Trigger وPipedrive في n8n مع العقدة المجتمعية لـ WbizTool (n8n-nodes-wbiztool). ثبّت العقدة المجتمعية أولًا.
| مسار العمل | ما يفعله |
|---|---|
| pipedrive-deal-stage-to-whatsapp.n8n.json | Pipedrive Trigger (تغيّرت صفقة) ← If انتقلت الصفقة إلى مرحلتك ← Pipedrive Get الشخص ← WbizTool Send Message. |
| whatsapp-to-pipedrive-note.n8n.json | Webhook (رسالة واردة من WbizTool) ← If كانت رسالة من شخص ← Pipedrive Search عن الشخص بالهاتف ← Create ملاحظة، مع إنشاء الشخص أولًا عندما لا يُعثر على أحد. |
استورد مسار العمل
في n8n، أنشئ مسار عمل، وافتح القائمة ⋯ واختر Import from File. يمكنك أيضًا لصق محتوى الملف على اللوحة.
أضف بيانات الاعتماد
افتح كل عقدة Pipedrive وأنشئ بيانات اعتماد Pipedrive API برمز API من Pipedrive (Settings → Personal preferences → API في Pipedrive). افتح عقدة WbizTool Send Message واختر بيانات اعتماد WbizTool API الخاصة بك (Client ID، ومفتاح API، وWhatsApp Client ID الذي تُرسل منه).
اضبط المرحلة والرسالة
في مسار العمل الأول، استبدل
YOUR_STAGE_IDفي عقدة If بمعرّف مرحلتك (انقل صفقة تجريبية إلى المرحلة واقرأdata.stage_idفي مخرجات المشغّل)، وعدّل Message Text. اترك Country Code فارغًا عندما تتضمن أرقامك في Pipedrive رمز الدولة.فعّل
فعّل مسار العمل. ينشئ Pipedrive Trigger webhook الخاص به في Pipedrive بنفسه.
لمسار العمل الثاني، انسخ Production URL لعقدة Webhook والصقه تحت رابط Webhook (اختياري) في أرقام صندوق الوارد، مع تحديد الرسائل المستلمة فقط.
عقد Pipedrive في هذه الملفات هي الإصدار 2 من عقدة Pipedrive في n8n. إذا كان إصدار n8n لديك أقدم وعرضها كعقد غير معروفة، فحدّث n8n أو استبدلها بعقدة Pipedrive في إصدارك، بالإعدادات نفسها.
Pabbly Connect#
لا يوجد تطبيق WbizTool على Pabbly Connect: استخدم وحداته العامة.
- Pipedrive ← WhatsApp: ابدأ مسار العمل بمشغّل Pipedrive في Pabbly، أو بمشغّل webhook فيه يغذّيه webhook من Pipedrive. ثم أضف API (Pabbly) مع Execute API Request إلى
https://wbiztool.com/api/v1/send_msg/، مضبوطًا كما في Pabbly Connect، واربط هاتف الشخص واسمه. - WhatsApp ← Pipedrive: ابدأ بمشغّل webhook في Pabbly، والصق عنوانه تحت رابط Webhook (اختياري) في أرقام صندوق الوارد، وأرسل رسالة تجريبية إلى رقمك ليرى Pabbly الحقول. ثم أضف خطوات Pipedrive في Pabbly: اعثر على الشخص بـ
contact.phone، وأنشئه إن لزم، وأضف ملاحظة بـmessage.content.
ما يصل من WhatsApp#
كل رسالة واردة هي طلب JSON واحد. الحقول التي تستخدمها الوصفات:
| الحقل | مثال | استخدمه لـ |
|---|---|---|
event | message_received | تخطَّ message_sent إذا حدّدت الرسائل المُرسَلة أيضًا. |
contact.phone | 12125550120 | البحث في Pipedrive، وهاتف الشخص الجديد (مع +). |
contact.name | Emma Thompson | اسم الشخص الجديد. قد يكون فارغًا: استخدم الهاتف عندها. |
contact.is_group، contact.phone_hidden | false | تخطَّ محادثات المجموعات والأرقام المخفية. |
message.content | Can I add a gift note to it? | الملاحظة. تصل الصور والملفات كتسمية، مثل 📸 Image. |
message.timestamp | 2026-10-15T10:30:04+00:00 | وقت إرسالها، بتوقيت UTC. |
كل الحقول والتوقيع وإعادة المحاولة موجودة في أرقام صندوق الوارد وwebhooks الرسائل الواردة.
استكشاف الأخطاء وإصلاحها#
| المشكلة | ما يجب التحقق منه |
|---|---|
Auth Error: invalid api key | حُذف المفتاح أو كُتب خطأً، أو لا ينتمي إلى مساحة العمل الخاصة بـ Client ID. في Make وn8n، تحقق من ترويسة Authorization: Bearer أو من بيانات الاعتماد. |
Invalid phone number | كان حقل الهاتف فارغًا أو يحتوي على شيء آخر، مثل اسم. تحقق من أن للشخص هاتفًا في Pipedrive ومن أنك ربطت حقل الهاتف. |
| ذهبت الرسالة إلى رقم خاطئ | الرقم محفوظ في Pipedrive دون رمز دولته. احفظه مع الرمز، مثل +44 20 7946 0018، أو أرسل country_code. |
Invalid JSON format: … | انكسر جسم JSON خام، غالبًا بسبب علامة اقتباس أو فاصل أسطر في حقل مربوط. في Pipedrive Automations استخدم الجسم Key-value؛ وفي Make أبقِ وحدات JSON الموجودة في المخطط. |
| يقول تشغيل الأتمتة "Maximum retry limit reached" | أجابت WbizTool بخطأ. افتح التشغيل في Automations → History واقرأ الجسم الذي أُرسل. |
| لا يصل أي webhook من WbizTool | يجب أن يظهر الرقم بالحالة قيد المزامنة في أرقام صندوق الوارد، مع تحديد الرسائل المستلمة، على إضافة Unibox. يجب أن تجيب Make وn8n وPabbly بـ 2xx خلال 8 ثوانٍ: شغّل السيناريو أو مسار العمل. تُرسَل الرسائل خلال دقيقة أو دقيقتين. |
| خادمك أو جدار الحماية يرفض webhook من WbizTool | اسمح بالطلبات ذات User-Agent WbizTool-Webhooks/1. تحظر بعض الاستضافات العملاء غير المعروفين بـ 403. |
| تُضاف ملاحظة لكن لا يُعثر على الشخص، فيُنشأ شخص مكرر | رقم الشخص محفوظ في Pipedrive بصيغة أخرى، مثل دون رمز الدولة. احفظه مع الرمز، ثم ادمج الشخصين في Pipedrive. |
| لا يحدث شيء لرسالة مجموعة | هذا مقصود: تتخطى الوصفات محادثات المجموعات والأرقام المخفية، التي ليس لها هاتف للمطابقة. |
ذات صلة#
- API إرسال رسالة: كل حقل يمكنك إرساله
- أرقام صندوق الوارد وwebhooks الرسائل الواردة
- مفاتيح API
- تكامل Zapier
- تكامل n8n
- أرسل رسائل WhatsApp من أي أداة أتمتة: Make وPabbly Connect وغيرهما

