واجهة برمجة تطبيقات Papo (https://papo.global/) هي واجهة برمجية تسمح للمطورين بربط أنظمة أخرى، مثل CRMs أو ERPs أو منصات الأتمتة (مثل n8n)، مباشرة بحساب Papo الخاص بهم. تُستخدم لأتمتة الإجراءات، مثل إرسال رسائل WhatsApp، أو الاستعلام عن جهات الاتصال من Extractor، أو تفعيل الذكاء الاصطناعي للمنصة، دون الحاجة إلى استخدام الواجهة الرسومية.
تفتح واجهة برمجة التطبيقات مجموعة واسعة من الإمكانيات لتخصيص عملياتك وتوسيع نطاقها، من خلال دمج وظائف Papo مع سير العمل الحالي في شركتك. بدلاً من تنفيذ الإجراءات يدويًا في لوحة التحكم، يمكن لبرنامجك الخاص أن يأمر Papo بتنفيذ المهام.
واجهة برمجة التطبيقات (API)، Webhooks، والتكاملات الجاهزة: ما الفرق؟
من الشائع الخلط بين هذه المفاهيم الثلاثة. يلخص الجدول أدناه الفرق الرئيسي بينها ومتى تستخدم كل منها.
| الميزة | واجهة برمجة التطبيقات (API) | Webhooks | التكاملات الجاهزة |
|---|---|---|---|
| الاتجاه | نظامك يطلب أو يرسل البيانات إلى Papo. | Papo يرسل البيانات إلى نظامك. | Papo يتصل بخدمة أخرى. |
| مبادرة الإجراء | نظامك الخارجي. | منصة Papo. | المستخدم، عند التكوين في لوحة التحكم. |
| المعرفة التقنية | تتطلب برمجة أو استخدام أدوات مثل n8n. | تتطلب نقطة نهاية (URL) في نظامك لاستقبال البيانات. | لا تتطلب برمجة، فقط إعداد في لوحة التحكم. |
| مثال على الاستخدام | إرسال رسالة WhatsApp عند الموافقة على عملية شراء في متجرك الإلكتروني. | إخطار نظام الفوترة الخاص بك كلما تم إنشاء جهة اتصال جديدة في Papo. | ربط حسابك في Google Agenda لتمكين الذكاء الاصطناعي لـ Papo من تحديد المواعيد. |
ما هي استخدامات واجهة برمجة تطبيقات Papo؟
باستخدام واجهة برمجة التطبيقات، يمكنك بناء أتمتة وتكاملات مخصصة لعملك. تشمل بعض التطبيقات الرئيسية ما يلي:
- إرسال الرسائل: ابدأ المحادثات أو أرسل إشعارات WhatsApp من نظامك الخاص (مثال: تأكيد الطلب، تذكير بالدفع).
- الوصول إلى جهات الاتصال من Extractor: استعرض قائمة العملاء المحتملين التي تم إنشاؤها بواسطة Extractor من Papo واستوردها إلى CRM أو أداة التسويق الخاصة بك.
- إدارة المثيلات: تحقق من حالة اتصالات WhatsApp الخاصة بك مباشرة من الواجهة الخلفية لنظامك.
- استخدام الذكاء الاصطناعي: أرسل نصًا إلى واجهة برمجة تطبيقات الذكاء الاصطناعي واستقبل ردًا تم إنشاؤه بناءً على المطالبة المكونة في حساب Papo الخاص بك، مما يسمح باستخدام نفس الذكاء في سياقات أخرى.
- مزامنة البيانات: حافظ على مزامنة جهات الاتصال والشركات والصفقات بين Papo وCRM الرئيسي الخاص بك.
- إنشاء لوحات تحكم مخصصة: استخرج بيانات الدعم والأداء لتغذية لوحات معلومات Business Intelligence (BI) بمقاييس محددة لعملياتك.
كيفية البدء في استخدام واجهة برمجة التطبيقات
لاستخدام واجهة برمجة التطبيقات، يلزم وجود معرفة تقنية أو استخدام أداة أتمتة مرئية تدعم استدعاءات REST API، مثل n8n. العملية العامة بسيطة:
| الخطوة | الإجراء | التفاصيل |
|---|---|---|
| 1. إنشاء مفاتيح API | ادخل إلى لوحة تحكم Papo وانتقل إلى قسم المطورين لإنشاء مفاتيحك. | سيكون لديك مفتاح عام (pk_live_...) لتعريف حسابك ومفتاح سري (sk_live_...) للمصادقة. يتم عرض المفتاح السري مرة واحدة فقط. |
| 2. مراجعة الوثائق | قم بزيارة الوثائق الرسمية لواجهة برمجة التطبيقات للاطلاع على جميع نقاط النهاية المتاحة. | توضح الوثائق عناوين URL والمعلمات المطلوبة وتنسيقات الاستجابة لكل إجراء (إرسال رسالة، سرد جهات الاتصال، إلخ). |
| 3. تنفيذ الاستدعاءات | اكتب الكود في نظامك أو قم بتكوين الكتل في أداة الأتمتة الخاصة بك. | تتم الاستدعاءات عبر HTTPS إلى عنوان URL الأساسي https://app.papo.global/api/v1، مع إرسال المفتاح السري في رأس التفويض. |
| 4. اختبار التكامل | قم بإجراء اختبارات للتأكد من أن نظامك يتواصل بشكل صحيح مع Papo. | تحقق مما إذا كانت الرسائل تُرسل وما إذا كانت البيانات تُستقبل كما هو متوقع. |
الأسئلة الشائعة
هل أحتاج أن أكون مبرمجًا لاستخدام واجهة برمجة التطبيقات؟
نعم، يتطلب الاستخدام المباشر لواجهة برمجة التطبيقات معرفة بالبرمجة. ومع ذلك، تسمح أدوات الأتمتة مثل n8n أو Make بالاتصال بواجهة برمجة التطبيقات من خلال واجهة مرئية، دون الحاجة إلى كتابة تعليمات برمجية، فقط عن طريق تكوين كتل الإجراءات وإدخال مفاتيحك.
أين أجد مفاتيح واجهة برمجة التطبيقات الخاصة بي؟
يمكن إنشاء مفاتيح واجهة برمجة التطبيقات في لوحة إعدادات حساب Papo الخاص بك، في قسم مخصص للمطورين. تذكر أن المفتاح السري (secret key) يُعرض مرة واحدة فقط عند إنشائه. احتفظ به في مكان آمن، حيث لا يمكن استعادته. إذا فقدته، ستحتاج إلى إلغائه وإنشاء مفتاح جديد.
ماذا يمكنني أن أفعل بالضبط باستخدام واجهة برمجة التطبيقات؟
يمكنك تنفيذ العديد من الإجراءات التي كنت ستفعلها يدويًا على المنصة. تسرد الوثائق الرسمية جميع نقاط النهاية، ولكن الرئيسية منها هي: إرسال رسائل نصية عبر WhatsApp (/messages)، سرد جهات الاتصال المستخرجة (/contacts)، سرد اتصالات WhatsApp الخاصة بك (/instances)، واستخدام محرك الذكاء الاصطناعي لـ Papo لإنشاء نصوص (/ai/v1/complete).
هل استخدام واجهة برمجة التطبيقات له أي تكلفة إضافية؟
الوصول إلى واجهة برمجة التطبيقات بحد ذاته لا يولد تكاليف إضافية على خطتك. ومع ذلك، فإن الإجراءات التي تنفذها من خلالها قد تستهلك موارد يتم تحصيل رسوم عليها، مثل إرسال الرسائل عبر واجهة برمجة تطبيقات WhatsApp أو استخراج عملاء محتملين جدد باستخدام Extractor. للحصول على تفاصيل حول التكاليف التشغيلية، يرجى مراجعة صفحة الأسعار على موقع Papo.
هل واجهة برمجة تطبيقات Papo من نوع REST أم SOAP؟
واجهة برمجة تطبيقات Papo هي واجهة REST API حديثة. تستخدم طرق HTTP القياسية (GET، POST، إلخ) وتتواصل باستخدام تنسيق JSON، وهو خفيف وسهل التفسير لمعظم لغات البرمجة وأدوات الأتمتة.
ما الفرق بين استخدام واجهة برمجة التطبيقات مباشرة واستخدام تكامل جاهز مثل Google Agenda؟
توفر واجهة برمجة التطبيقات مرونة كاملة لإنشاء أي نوع من التكامل. أما التكاملات الجاهزة، مثل Google Agenda أو Wavoip، فهي حلول مبنية مسبقًا بواسطة Papo لحالات الاستخدام الشائعة. يتم تفعيلها ببضع نقرات، دون الحاجة إلى تعليمات برمجية، ولكنها تقتصر على الوظائف التي تم تطويرها مسبقًا.
اقرأ أيضًا
ابدأ مجانًا واستكشف الإمكانيات →
اربط قنواتك، قم بتكوين الذكاء الاصطناعي وابدأ في تقديم الدعم في نفس اليوم.