كيفية إدارة الرسائل المجدولة عبر API

باستخدام واجهة برمجة التطبيقات REST من Papo (https://papo.global/)، يمكنك أتمتة إنشاء وعرض وإلغاء الرسائل المجدولة لواتساب والرسائل النصية القصيرة، ودمج جدولة الاتصالات مباشرة في أنظمتك أو أنظمة إدارة علاقات العملاء (CRM) أو تدفقات الأتمتة — دون الحاجة إلى الوصول إلى لوحة التحكم يدويًا.

توفر منصة Papo بالفعل منطقة مركزية لإدارة الرسائل المجدولة، ولكن عندما يكون حجم الجدولة مرتفعًا أو عندما تحتاج إلى برنامج آخر لبدء الإرسال، فإن API هو الحل. باستخدامها، يمكنك إنشاء تذكيرات ومتابعات وإشعارات برمجيًا، مع الحفاظ على نفس التحكم الذي ستحصل عليه في الواجهة المرئية.

ملخص عمليات الرسائل المجدولة عبر API

العملية	ما تفعله	متى تستخدمها
إنشاء جدولة	جدولة رسالة واتساب أو رسائل نصية قصيرة لجهة اتصال في تاريخ ووقت محددين.	جدولة تذكيرات المواعيد، متابعات المبيعات، أو إشعارات التحصيل من نظام خارجي.
عرض الجدولة	إرجاع جميع الرسائل المجدولة، مع إمكانية التصفية حسب الحالة (معلقة، مرسلة، ملغاة، فاشلة).	مزامنة جدول الإرسال مع لوحة المعلومات، التحقق من المعلقات قبل إنشاء جدولات جديدة، أو تدقيق الاتصالات المجدولة.
إلغاء الجدولة	إلغاء إرسال مجدول قبل وقت الإطلاق.	إيقاف رسالة لم تعد ذات صلة، مثل تذكير بحدث ملغى أو متابعة فقدت معناها.

كيف يعمل التكامل

تتبع API الخاصة بـ Papo معيار REST وتستخدم المصادقة عبر رمز Bearer. تتطلب جميع عمليات الكتابة (الإنشاء والإلغاء) المفتاح السري لحسابك، الذي يتم إنشاؤه في منطقة المطور في لوحة التحكم. عنوان URL الأساسي هو https://app.papo.global/api/v1.

لاستخدام ميزات الرسائل المجدولة:

أنشئ مفتاحًا سريًا في لوحة تحكم Papo (منطقة المطور/API). احتفظ به في مكان آمن — يتم عرضه مرة واحدة فقط.
في كل طلب، قم بتضمين الترويسة Authorization: Bearer {مفتاحك_السري}.
استخدم نقاط النهاية المحددة للرسائل المجدولة، وفقًا للوثائق الرسمية على https://papo.global/pt/docs. هناك ستجد المسارات الدقيقة، المعلمات المطلوبة (مثل معرف جهة الاتصال، القناة، المحتوى، التاريخ/الوقت) وأمثلة على حمولة JSON.
لعرض الجدولة، يمكنك تطبيق عوامل تصفية حسب الحالة، مما يسمح لك بالاستعلام فقط عن الإرسالات المعلقة أو المكتملة.

تعكس API سلوك وحدة الرسائل المجدولة في المنصة: تظهر الجدولة التي تم إنشاؤها عبر API في قائمة لوحة التحكم، وأي إلغاء يتم عبر API يحدّث الحالة فورًا.

لمن تُناسب هذه الأتمتة

المطورون وفرق تكنولوجيا المعلومات الذين يحتاجون إلى دمج جدولة الرسائل في أنظمتهم الخاصة، مثل أنظمة تخطيط موارد المؤسسات (ERP)، أو أنظمة إدارة علاقات العملاء (CRM)، أو منصات جدولة المواعيد.
الموزعون بعلامة بيضاء (white label) الذين يرغبون في تقديم إمكانية جدولة الإرسال عبر API لعملائهم، مما يزيد من قيمة الحل.
العمليات ذات الحجم الكبير من المتابعات (المبيعات، التحصيل، تأكيد الحضور) التي تريد أتمتة إنشاء التذكيرات دون تدخل يدوي.
الشركات التي تستخدم تدفقات الأتمتة وتطلق إنشاء الجدولة من أحداث في أدوات أخرى.

الأسئلة الشائعة

هل أحتاج إلى تنشيط وحدة الرسائل المجدولة لاستخدام API؟

نعم. تعمل API على نفس الوظيفة التي تجدها في لوحة التحكم. إذا كانت الوحدة متاحة في خطتك، فإن نقاط النهاية المقابلة ستكون متاحة أيضًا.

هل تسمح API بجدولة رسائل مع مرفقات أو وسائط؟

توضح الوثائق الرسمية أنواع المحتوى المدعومة. حاليًا، تستهدف الجدولة عبر المنصة الرسائل النصية. راجع مرجع API للتحقق من وجود دعم للوسائط في وقت التكامل.

كيف أقوم بمصادقة الطلبات؟

استخدم المفتاح السري لحسابك في Papo كرمز Bearer في الترويسة Authorization. يتم إنشاء المفتاح في منطقة المطور في لوحة التحكم.

هل يمكنني جدولة رسائل لعدة جهات اتصال في وقت واحد؟

تسمح API بإنشاء جدولة واحدة لكل طلب. لعدة جهات اتصال، يمكنك إجراء استدعاءات متسلسلة. تحقق في الوثائق من وجود نقاط نهاية للدفعات لحالتك.

ماذا يحدث إذا حاولت إلغاء رسالة تم إرسالها بالفعل؟

ستعيد API خطأً، لأنه يمكن فقط إلغاء الجدولة ذات الحالة المعلقة. بعد الإطلاق، لم يعد من الممكن تغيير الرسالة.

أين أجد مفاتيح API؟

في لوحة تحكم Papo، انتقل إلى منطقة المطور أو إعدادات API. يتم عرض المفتاح السري في وقت الإنشاء؛ إذا فُقد، ستحتاج إلى إنشاء مفتاح جديد.