مع API REST من Papo، يمكنك عرض الشركات والبحث عنها وإنشائها وتحديثها وربط جهات الاتصال بها في CRM — كل ذلك عبر طلبات موثّقة، دون فتح اللوحة. هذه هي الطريقة البرمجية لإبقاء إدارة عملاء B2B متزامنة مع الأنظمة الخارجية وأنظمة ERP وCRM وأدوات الأتمتة.
تُتيح API من Papo موارد وحدة الشركات حتى تنظّم عملياتك حسابات B2B، وتوحّد جهات الاتصال المرتبطة، وتتابع المحادثات الأخيرة لكل شركة. ومع المصادقة عبر مفتاح سري واستجابات JSON، تسمح نقاط النهاية هذه بدمج رؤية الحسابات مع النصوص البرمجية والأتمتة وإعادة البيع بالعلامة البيضاء.
ملخص عمليات الشركات عبر API
| العملية | ما الذي تفعله | متى تستخدمها |
|---|---|---|
| عرض قائمة الشركات | ترجع الشركات المسجلة في CRM مع الاسم والنطاق وعدد جهات الاتصال. | لتدقيق قاعدة الحسابات أو مزامنة الشركات مع نظام آخر. |
| البحث بالاسم أو النطاق | يحدد موقع شركات معينة في CRM. | للعثور على حساب B2B قبل تحديث البيانات أو ربط جهات الاتصال. |
| تفاصيل الشركة | ترجع بيانات شركة عبر المعرّف. | للاستعلام عن حساب معين أثناء التكامل. |
| إنشاء شركة | تنشئ شركة جديدة؛ الاسم إلزامي، بينما النطاق والوصف اختياريان. | لتسجيل حسابات B2B تلقائيًا من ERP أو موقع أو تدفق خارجي. |
| تحديث شركة | تحدّث اسم الشركة ونطاقها ووصفها. | لإبقاء CRM متوافقًا دائمًا مع قاعدة عملاء B2B. |
| ربط جهة اتصال | تربط جهة اتصال موجودة في CRM بشركة. | لتوحيد العلاقة والسجل بين جهات الاتصال والحسابات. |
| عرض جهات الاتصال والمحادثات | تجلب جهات الاتصال المرتبطة بالشركة والمحادثات الأخيرة لهذه الجهات. | للحصول على رؤية كاملة للحساب أثناء خدمة العملاء أو المتابعة. |
كيف تعمل مصادقة API
تتطلب جميع مسارات الكتابة، بما فيها عمليات الشركات، المفتاح السري للحساب. ويجب إرساله كرمز Bearer. المفتاح العام للحساب اختياري، لكن إذا أُرسل فيجب أن يتوافق مع الحساب نفسه الخاص بالمفتاح السري.
عنوان URL الأساسي لواجهة API هو https://app.papo.global/api/v1. يتم إنشاء المفاتيح في منطقة المطورين في لوحة Papo. يظهر المفتاح السري مرة واحدة فقط عند الإنشاء؛ احفظه في مكان آمن وأبطله إذا اشتبهت في تسريبه.
نظرًا لأن API من نوع REST ويستخدم JSON، يمكن استخدام أي لغة تدعم HTTP لدمج الشركات مع النصوص البرمجية أو أنظمة ERP أو CRM أو أدوات الأتمتة. الوثائق الرسمية على https://papo.global/pt/docs تتضمن تفاصيل المصادقة والمعاملات والاستجابات وأمثلة الشيفرة.
كيفية إدارة الشركات عبر API عمليًا
- انتقل إلى منطقة المطورين في لوحة Papo وأنشئ مفتاحًا سريًا. انسخ أيضًا المفتاح العام للحساب.
- في كل طلب، صادق باستخدام المفتاح السري كرمز Bearer. إذا أردت تعزيز التحقق، أرسل المفتاح العام في الترويسة المحددة في الوثائق.
- لعرض قائمة شركات CRM، استدعِ نقطة نهاية عرض الشركات. تتضمن الاستجابة اسم كل حساب ونطاقه وعدد جهات الاتصال فيه.
- لتحديد موقع شركة معينة، استخدم نقطة نهاية البحث بالاسم أو النطاق. وهكذا تحصل على المعرّف اللازم لتحديث البيانات أو ربط جهات الاتصال.
- لإنشاء شركة، أرسل حمولة JSON تتضمن الاسم الإلزامي. يمكن تضمين النطاق والوصف كبيانات اختيارية.
- لتحديث شركة، أرسل القيم الجديدة للاسم أو النطاق أو الوصف إلى نقطة نهاية التحديث.
- لربط جهة اتصال موجودة، استخدم معرّف جهة الاتصال ومعرّف الشركة في عملية الربط.
بما أن API يعالج عملية واحدة لكل طلب، تُنفّذ الإدارة الجماعية عبر استدعاءات متتابعة. يمكن لنص برمجي بلغة Python أو Node.js أو أتمتة في أدوات مثل n8n قراءة الحسابات من ملف CSV أو ERP، وتسجيل الشركات، وربط جهات الاتصال، وجمع الاستجابات لمعالجة الأخطاء.
لمن يكون هذا التكامل مناسبًا
- الشركات B2B التي تحتفظ بحساباتها في CRM أو ERP آخر وتريد مزامنتها تلقائيًا مع وحدة الشركات في Papo.
- الفرق التجارية التي تتعامل مع عملاء الحسابات، مثل الوكالات والاستشارات والبرمجيات كخدمة (SaaS) ومزودي الخدمات، وتحتاج إلى توحيد جهات الاتصال والمحادثات حسب الشركة.
- العمليات التي تجمع الشركات من النماذج أو الصفحات المقصودة أو الأنظمة الخارجية وترغب في إنشائها في CRM دون إعادة عمل يدوية.
- شركات إعادة البيع بالعلامة البيضاء والمكاملون الذين يربطون Papo بأنظمة العملاء ويريدون إبقاء إدارة الحسابات متسقة بين البيئات المختلفة.
- فرق تقنية المعلومات التي تبني عمليات تكامل مخصصة باستخدام API كجسر بين قاعدة الشركات وبقية العملية.
الأسئلة الشائعة
هل أحتاج إلى إنشاء جهة الاتصال قبل ربطها بشركة؟
نعم. تربط API جهة اتصال موجودة بالفعل في CRM. لتسجيل جهة اتصال جديدة، استخدم نقاط نهاية إنشاء جهات الاتصال ثم نفّذ الربط بالشركة.
ما البيانات التي يمكنني تحديثها في شركة عبر API؟
يمكن تحديث اسم الشركة ونطاقها ووصفها. يتطلب الإنشاء الاسم؛ النطاق والوصف اختياريان.
هل تسمح API بعرض محادثات شركة؟
نعم. تتيح وحدة الشركات عرض جهات الاتصال المرتبطة بشركة والمحادثات الأخيرة لهذه الجهات، ما يسهّل رؤية الحساب أثناء خدمة العملاء.
هل المصادقة نفسها المستخدمة في نقاط النهاية الأخرى في Papo؟
نعم. تتطلب مسارات الكتابة المفتاح السري للحساب، يُرسل كرمز Bearer. المفتاح العام اختياري، وإذا أُرسل فيجب أن يتوافق مع الحساب نفسه.
أين أجد المسارات الدقيقة وتنسيق الحمولة؟
في الوثائق الرسمية لواجهة API، المتاحة على https://papo.global/pt/docs. هناك تفاصيل المصادقة والمعاملات والاستجابات وأمثلة الشيفرة للشركات وبقية الموارد.
هل يمكنني استخدام API لمزامنة قاعدة الشركات مع CRM الحالي؟
نعم. بما أن API من نوع REST ويستخدم JSON، يمكنك أتمتة العرض والإنشاء والتحديث وربط جهات الاتصال بالتتابع، مع إبقاء النظامين متوافقين.
اقرأ أيضًا
- كيفية استخدام وحدة الشركات في CRM من Papo
- كيفية استخدام API من Papo لإدارة السمات المخصصة لجهات الاتصال
ابدأ مجانًا وأدر الشركات في CRM عبر API →
المستخدم الأول من Papo مجاني للأبد، دون بطاقة.