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

التكاملات

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: راسل من يتوقعون رسائلك، مثل العملاء المحتملين والعملاء.

قبل أن تبدأ#

اختر طريقة الربط#

الطريقةPipedrive ‏← WhatsAppWhatsApp ‏← 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.

  1. أنشئ automated webhook

    في Pipedrive، افتح قائمة الحساب وانتقل إلى Tools and apps → Webhooks. انقر على + Webhooks واختر Automated webhook. سمّه "WbizTool"، وأدخل https://wbiztool.com/api/v1/ كرابط نقطة النهاية (endpoint URL). يجب أن ينتهي الرابط بـ /، لأن الأتمتة تضيف المسار. اترك المصادقة فارغة: بيانات اعتماد WbizTool توضع في الجسم.

  2. أنشئ الأتمتة

    افتح قائمة الحساب في أعلى اليمين، وانتقل إلى Tools and apps → Automations وانقر على + Automation. اختر Event trigger، واختر deal كعنصر واضبط حدث المشغّل على Updated. اختر مرحلة الصفقة كحقل تُراقَب تغييراته، وانقر على Apply trigger. ثم أضف شرطًا يحدد اسم مرحلة الصفقة، حتى لا تعمل الأتمتة إلا عندما تنتقل صفقة إلى تلك المرحلة.

    لرسالة ترحيب، اختر person كعنصر والحدث Added بدلًا من ذلك.

  3. أضف إجراء webhook

    أضف الإجراء webhook واختر webhook ‏"WbizTool". اضبط الطريقة على POST وأضف المسار send_msg/.

  4. املأ الجسم

    اختر الجسم 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 لا تحتاج إلى الانتباه لعلامات الاقتباس في الأسماء.

  5. اختبرها

    احفظ الأتمتة، واجعلها نشطة وانقل صفقة تجريبية إلى المرحلة. افتح Automations → History ثم التشغيل: يعرض الجسم الذي أُرسل. تجيب WbizTool بـ "status": 1 عندما تُضاف الرسالة إلى قائمة الانتظار؛ أما الخطأ فيُجاب عنه بـ HTTP ‏400 وmessage، مثل Invalid phone number.

Zapier#

استخدم تطبيق WbizTool على Zapier مع تطبيق Pipedrive على Zapier.

تتغير مرحلة صفقة: أرسل رسالة WhatsApp#

  1. المشغّل: Pipedrive ‏Updated Deal Stage

    اختر Pipedrive والمشغّل Updated Deal Stage. لرسالة ترحيب، استخدم New Person بدلًا منه.

  2. المرشّح: مرحلتك فقط

    أضف Filter by Zapier ولا تتابع إلا عندما تكون مرحلة الصفقة هي التي تريدها. يعمل المشغّل مع كل تغيير في المرحلة.

  3. اعثر على هاتف الشخص

    إذا لم تحتوِ بيانات المشغّل على هاتف لشخص الصفقة، فأضف البحث Get Person من Pipedrive مع معرّف الشخص في الصفقة.

  4. الإجراء: WbizTool ‏Send Text-Only WhatsApp Message

    اختر رقم الإرسال تحت WhatsApp Number. اربط هاتف الشخص بـ Phone Number، ولا تملأ Country Code إلا إذا كانت أرقامك في Pipedrive محلية، واكتب Message مع اسم الشخص.

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

    نجاح الخطوة يعني أن الرسالة أُضيفت إلى قائمة الانتظار. إذا لم تستطع WbizTool قبولها، تفشل الخطوة مع السبب، مثل WbizTool: Invalid phone number.

تصل رسالة WhatsApp: أضف ملاحظة في Pipedrive#

يتطلب إضافة Unibox. راجع متطلبات المشغل.

  1. المشغّل: WbizTool ‏Incoming WhatsApp Message

    اختر الرقم تحت WhatsApp Number. عندما تنشر Zap، تضيف WbizTool الرقم إلى صندوق الوارد وترسل رسائله المستلمة إلى Zapier.

  2. المرشّح: أشخاص، لا مجموعات

    أضف Filter by Zapier: لا تتابع إلا عندما تكون Is Group خاطئة (false) وContact Phone Hidden خاطئة (false).

  3. اعثر على الشخص أو أنشئه

    أضف Find or Create Person من Pipedrive: يبحث في الأشخاص حسب حقل (اختر حقل الهاتف، مع Contact Phone) وينشئ شخصًا عندما لا يُعثر على أحد. للشخص الجديد، اضبط الاسم على Contact Name والهاتف على + متبوعًا بـ Contact Phone.

  4. أنشئ الملاحظة

    أضف 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.jsonwebhook من Pipedrive (تغيّرت صفقة) ‏← ترشيح على مرحلتك ‏← جلب شخص الصفقة ‏← إرسال رسالة WhatsApp إليه.
whatsapp-to-pipedrive-note.blueprint.jsonwebhook الرسائل الواردة من WbizTool ‏← العثور على الشخص بالهاتف ‏← إضافة ملاحظة، أو إنشاء الشخص أولًا.

المخططان مبنيان على وحدات Make العامة، لذا يعملان على أي باقة Make ولا يحتاجان إلى اتصال Pipedrive في Make.

تحتاج إلى رمز API من Pipedrive (في Pipedrive، Settings → Personal preferences → API) وعنوان شركتك في Pipedrive، مثل yourcompany.pipedrive.com.

تتغير مرحلة صفقة: أرسل رسالة WhatsApp#

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

    أنشئ سيناريو في Make، وانقر على النقاط الثلاث في الشريط السفلي، واختر Import Blueprint واختر الملف.

  2. أنشئ webhook

    افتح الوحدة الأولى (Webhooks → Custom webhook)، وانقر على Add، واحفظ، وانسخ العنوان الذي يعرضه Make.

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

    • في المرشّح بعد 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 في الجسم، ونص الرسالة.
  4. وجّه webhook في Pipedrive إلى Make

    في Pipedrive، انتقل إلى Settings → Tools and apps → Webhooks وأنشئ webhook: ‏event action ‏change (‏updated في الإصدارات الأقدم)، وevent object ‏deal، وعنوان Make كرابط نقطة النهاية.

  5. شغّله

    شغّل السيناريو وانقل صفقة تجريبية إلى المرحلة. تعرض مخرجات وحدة HTTP إجابة WbizTool: ‏"status": 1 يعني أن الرسالة أُضيفت إلى قائمة الانتظار.

لبنائه بوحدات Pipedrive في Make بدلًا من ذلك، استخدم Watch New Events (أو Custom webhook كما سبق)، وGet a Person، ووحدة HTTP بالطلب نفسه الموجود في وحدة Send WhatsApp في المخطط. تُرجع وحدات Pipedrive في Make شخص الصفقة كمعرّف فقط، لذا تحتاج إلى Get a Person للحصول على الهاتف.

تصل رسالة WhatsApp: أضف ملاحظة في Pipedrive#

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

    استورد whatsapp-to-pipedrive-note.blueprint.json في سيناريو جديد.

  2. أنشئ webhook

    افتح Webhooks → Custom webhook، وانقر على Add، واحفظ وانسخ العنوان.

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

    استبدل YOUR_COMPANY وYOUR_PIPEDRIVE_API_TOKEN في وحدات HTTP الأربع الخاصة بـ Pipedrive (البحث، وإنشاء الشخص، والملاحظتين).

  4. أضف العنوان في WbizTool

    في أرقام صندوق الوارد، أضف رقمك إلى صندوق الوارد، أو افتح إعدادات webhook في بطاقته. الصق عنوان Make تحت رابط Webhook (اختياري)، وأبقِ الرسائل المستلمة وحدها محددة، واحفظ.

  5. شغّله واختبره

    شغّل السيناريو وأرسل رسالة إلى رقم 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.jsonPipedrive Trigger (تغيّرت صفقة) ‏← If انتقلت الصفقة إلى مرحلتك ‏← Pipedrive ‏Get الشخص ‏← WbizTool Send Message.
whatsapp-to-pipedrive-note.n8n.jsonWebhook (رسالة واردة من WbizTool) ‏← If كانت رسالة من شخص ‏← Pipedrive ‏Search عن الشخص بالهاتف ‏← Create ملاحظة، مع إنشاء الشخص أولًا عندما لا يُعثر على أحد.
  1. استورد مسار العمل

    في n8n، أنشئ مسار عمل، وافتح القائمة ⋯ واختر Import from File. يمكنك أيضًا لصق محتوى الملف على اللوحة.

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

    افتح كل عقدة Pipedrive وأنشئ بيانات اعتماد Pipedrive API برمز API من Pipedrive (‏Settings → Personal preferences → API في Pipedrive). افتح عقدة WbizTool Send Message واختر بيانات اعتماد WbizTool API الخاصة بك (Client ID، ومفتاح API، وWhatsApp Client ID الذي تُرسل منه).

  3. اضبط المرحلة والرسالة

    في مسار العمل الأول، استبدل YOUR_STAGE_ID في عقدة If بمعرّف مرحلتك (انقل صفقة تجريبية إلى المرحلة واقرأ data.stage_id في مخرجات المشغّل)، وعدّل Message Text. اترك Country Code فارغًا عندما تتضمن أرقامك في Pipedrive رمز الدولة.

  4. فعّل

    فعّل مسار العمل. ينشئ 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 واحد. الحقول التي تستخدمها الوصفات:

الحقلمثالاستخدمه لـ
eventmessage_receivedتخطَّ message_sent إذا حدّدت الرسائل المُرسَلة أيضًا.
contact.phone12125550120البحث في Pipedrive، وهاتف الشخص الجديد (مع +).
contact.nameEmma Thompsonاسم الشخص الجديد. قد يكون فارغًا: استخدم الهاتف عندها.
contact.is_group، contact.phone_hiddenfalseتخطَّ محادثات المجموعات والأرقام المخفية.
message.contentCan I add a gift note to it?الملاحظة. تصل الصور والملفات كتسمية، مثل 📸 Image.
message.timestamp2026-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.
لا يحدث شيء لرسالة مجموعةهذا مقصود: تتخطى الوصفات محادثات المجموعات والأرقام المخفية، التي ليس لها هاتف للمطابقة.

ذات صلة#