باستخدام API REST الخاصة بـ Papo، يمكنك بناء نقطة نهاية (endpoint) في موقعك تستقبل بيانات نموذج التسجيل وتستدعي API جهات الاتصال لإنشاء سجلات في CRM تلقائياً، بما في ذلك السمات المخصصة — مما يلغي الإدخال اليدوي ويسرّع دمج العملاء المحتملين.
بدلاً من تصدير جداول البيانات أو نسخ البيانات بين الأنظمة، تجعل هذه التكاملات كل تسجيل جديد في موقعك يتحول إلى جهة اتصال في CRM الخاص بـ Papo في الوقت الفعلي. التدفق بسيط: يرسل النموذج البيانات إلى خادم خلفي (backend) تتحكم به، ويقوم هذا الخادم بالمصادقة على API Papo وإنشاء جهة الاتصال بالاسم والبريد الإلكتروني والهاتف وأي حقول مخصصة يحتاجها تشغيلك.
ملخص التكامل
| المكوّن | ما يفعله | مثال |
|---|---|---|
| نموذج في الموقع | يجمع الاسم والبريد الإلكتروني والهاتف وحقولاً إضافية للعميل المحتمل. | صفحة التقاط، صفحة هبوط، إتمام الشراء. |
| نقطة نهاية وسيطة | تستقبل بيانات النموذج وتستدعي API Papo. | سكربت بـ Node.js أو Python أو أتمتة عبر n8n/Zapier. |
| API جهات الاتصال في Papo | ينشئ جهة الاتصال في CRM بالبيانات المرسلة. | طلب POST موثّق بمفتاح سري. |
| السمات المخصصة | تضيف حقولاً مثل المصدر أو الاهتمام أو النقاط إلى جهة الاتصال. | custom_attributes مع "origem": "site"، "plano_interesse": "gold". |
كيف يعمل: خطوة بخطوة
-
أنشئ مفاتيح API في لوحة تحكم Papo
انتقل إلى منطقة المطورين في حسابك على Papo وأنشئ مفتاحاً سرياً. يظهر المفتاح العام للحساب أيضاً في هذه الشاشة. يظهر المفتاح السري مرة واحدة فقط؛ احتفظ به في مكان آمن ولا تكشفه أبداً في الواجهة الأمامية (frontend). -
أنشئ النموذج في موقعك
أنشئ النموذج بالحقول التي تريد إرسالها إلى CRM: الاسم، البريد الإلكتروني، الهاتف وأي بيانات إضافية (الاهتمام، المصدر، المدينة، إلخ). يجب أن يرسل النموذج طلب HTTP (POST) إلى نقطة النهاية التي ستبنيها في الخطوة التالية. -
ابنِ نقطة النهاية الوسيطة
على خادمك أو في دالة بدون خادم (serverless) (Node.js، Python، PHP، إلخ)، أنشئ مساراً يستقبل بيانات النموذج. ستكون هذه الشيفرة مسؤولة عن:- التحقق من الحقول المستلمة.
- تكوين حمولة JSON لـ API Papo.
- المصادقة بالمفتاح السري (Bearer token)، واختيارياً إرسال المفتاح العام في الترويسة
X-Papo-Public-Key. - استدعاء نقطة نهاية إنشاء جهات الاتصال في Papo.
-
استدعِ API جهات الاتصال في Papo
استخدم نقطة نهاية إنشاء جهات الاتصال (راجع الوثائق الرسمية علىhttps://papo.global/pt/docsلمعرفة المسار الدقيق وتنسيق الحمولة). أرسل، كحد أدنى، الاسم والبريد الإلكتروني أو الهاتف. سيؤكد رد API الإنشاء ببيانات جهة الاتصال الجديدة. -
أضف سمات مخصصة
إذا كان حسابك يحتوي على تعريفات لسمات مخصصة (مثل "origem"، "utm_source"، "score")، يمكنك إرسالها في نفس الحمولة أو في استدعاء تكميلي. تتيح API تعريف/دمجcustom_attributesفي جهة الاتصال، مما يلغي الحاجة إلى ملء هذه الحقول يدوياً لاحقاً. -
عالج الرد وأعد النتيجة إلى المستخدم
بعد الإنشاء الناجح، يمكن لنقطة النهاية إعادة توجيه العميل المحتمل إلى صفحة شكر أو عرض رسالة نجاح. في حال حدوث خطأ (مفتاح غير صالح، بيانات ناقصة)، سجّل الخطأ في السجل وأعد رسالة ودّية.
بما أن API Papo هي REST وتستخدم JSON، يمكن استخدام أي لغة تدعم HTTP. توفر الوثائق الرسمية أمثلة بـ JavaScript وPython وcurl، بالإضافة إلى تفاصيل المصادقة ورموز الأخطاء.
لمن يكون هذا التكامل مناسباً
- المواقع وصفحات الهبوط التي تجمع العملاء المحتملين والتي تريد إلغاء النقل اليدوي للبيانات إلى CRM.
- متاجر التجارة الإلكترونية وSaaS التي ترغب في إنشاء جهة اتصال تلقائياً عند التسجيل أو الشراء.
- الوكالات والاستشارات التي تدير حملات لجمع العملاء المحتملين وتحتاج إلى دخولهم إلى CRM في الوقت الفعلي للمتابعة الفورية.
- الموزعون بالعلامة البيضاء (white label) والمكاملون الذين يبنون تدفقات مخصصة للعملاء، ويربطون نماذج المواقع بـ Papo دون تدخل يدوي.
- فرق التسويق والمبيعات التي تستخدم سمات مخصصة للتقسيم وتريد ملء هذه الحقول تلقائياً عند المصدر.
الأسئلة الشائعة
هل أحتاج إلى معرفة برمجية متقدمة لتنفيذ هذا التكامل؟
نعم. من الضروري تطوير نقطة نهاية على خادمك أو استخدام أدوات أتمتة (n8n، Zapier) تقوم بالربط بين النموذج وAPI Papo. الشيفرة نفسها بسيطة، لكنها تتطلب معرفة أساسية بـ HTTP والتعامل مع JSON.
هل يمكنني استخدام أي لغة برمجة؟
نعم. API Papo هي REST وتستجيب بصيغة JSON. يمكن استخدام أي لغة تدعم طلبات HTTP (Python، Node.js، PHP، Ruby، إلخ). توفر الوثائق الرسمية أمثلة بـ JavaScript وPython.
هل يمكن إنشاء سمات مخصصة مباشرة عند إنشاء جهة الاتصال؟
نعم. تتيح API Papo تعريف custom_attributes الخاصة بجهة الاتصال في وقت الإنشاء أو تحديثها لاحقاً. راجع الوثائق لمعرفة التنسيق الدقيق للحمولة وللتحقق مما إذا كانت تعريفات السمات موجودة بالفعل في الحساب.
كيف أضمن أمان المفتاح السري؟
لا ينبغي أبداً كشف المفتاح السري في الواجهة الأمامية (HTML/JavaScript العام). يجب أن يبقى فقط على الخادم، في متغيرات البيئة. استخدم HTTPS في جميع الاتصالات وألغِ المفتاح فوراً إذا كان هناك اشتباه في تسربه.
ماذا أفعل إذا أعادت API خطأ؟
تعيد API Papo ردوداً موحّدة مع success: false وكائن error يحتوي على الرمز والرسالة. عالج هذه الأخطاء في شيفرتك: تحقق من إرسال الحقول الإلزامية، ومن أن المفتاح نشط، ومن أن تنسيق الحمولة صحيح. تسرد الوثائق رموز الأخطاء الرئيسية.
هل يمكنني استخدام هذا التكامل مع نماذج من منصات مثل WordPress أو Typeform أو RD Station؟
نعم. يمكنك إعداد webhooks في هذه المنصات لإرسال بيانات النموذج إلى نقطة النهاية الوسيطة، والتي ستستدعي بعد ذلك API Papo. البديل الآخر هو استخدام تكاملات جاهزة عبر Zapier أو n8n، لإنشاء تدفق يستقبل حدث النموذج ويطلق إنشاء جهة الاتصال في Papo.
اقرأ أيضاً
أنشئ حسابك المجاني على Papo وابدأ بربط نماذج التسجيل بـ CRM في دقائق، دون إدخال يدوي.