الانتقال إلى المحتوى الرئيسي
يجمع مركز المطورين كل ما تحتاجه للبناء على Flowella REST API. يعرض عنوان API، وسجلًا لطلبات API الأخيرة، ومفتاح API sandbox على مستوى المؤسسة، وأدلة البدء السريع، وروابط إلى وثائق API. لفتحه، انتقل إلى Settings، ثم اختر Developer hub في مجموعة Developer.

​
من يمكنه استخدامه

​
عنوان API الأساسي

تعرض هذه البطاقة عنوان REST API. في تكاملك، استخدم https://api.flowella.io/v1 كعنوان أساسي، حتى لو عرضت البطاقة عنوانًا ينتهي بـ /api/v1. راجع عنوان URL الأساسي لمعرفة السبب.

​
طلبات API الأخيرة

تسرد هذه البطاقة أحدث 25 طلب API أُجريت على مؤسستك باستخدام مفاتيح API أو رموز وصول OAuth، بدءًا من الأحدث. لا تُدرج الطلبات التي يرفضها Flowella قبل تشغيلها. ومنها الطلبات التي تحتوي على رمز مفقود أو غير صالح، أو نطاق مفقود، أو ترويسة API-Version غير مدعومة، أو التي تتجاوز حد المعدل. لرؤية كل ما يرتبط بطلب ما، مثل الأحداث والمهام وعمليات تسليم webhook التي تسبب فيها، استدعِ GET /v1/requests/{requestId} باستخدام Request id. يحتاج ذلك إلى النطاق account:read. راجع معرّفات الطلبات.

​
بيئة API التجريبية

تحتوي بطاقة API sandbox على مفتاح على مستوى المؤسسة للاختبار دون إرسال أي شيء إلى WhatsApp. تعرض الشارة Active عندما تكون البيئة التجريبية مفعّلة وOff عندما تكون متوقفة. يفتح Sandbox guide دليل البيئة التجريبية في التطبيق. لتشغيل البيئة التجريبية، يحدد صاحب دور Owner أو Admin مربع الاختيار في أسفل البطاقة. ألغِ تحديده لإيقاف البيئة التجريبية. يُطبَّق التغيير فورًا على المؤسسة بأكملها. يمكنك أيضًا قراءة الإعداد وتغييره باستخدام GET /v1/sandbox وPATCH /v1/sandbox، مع نص الطلب { "enabled": true } أو { "enabled": false }. يحتاج كلاهما إلى النطاق sandbox:manage.
تؤثر بيئة API التجريبية في أكثر من استدعاءات API. فأثناء تشغيلها، يتوقف أيضًا Bulk send في التطبيق وإجراء Send WhatsApp Template في مسارات عمل HubSpot عن الوصول إلى جهات الاتصال. أما الردود من Inbox وإجراءا HubSpot Send WhatsApp Message وSend WhatsApp Reply فتُرسل فعليًا. أوقف البيئة التجريبية بمجرد انتهائك من الاختبار.

​
بيئة API التجريبية ومفاتيح sandbox

هناك طريقتان لاستخدام البيئة التجريبية. تغطي API sandbox على مستوى المؤسسة كل طلب، بينما يغطي مفتاح sandbox الطلبات المُجراة بذلك المفتاح فقط.

​
ما الذي يتغير في البيئة التجريبية

عندما تغطي البيئة التجريبية طلبًا ما:
  • يخزّن POST /v1/messages الرسالة في المحادثة ويُرجع "sandbox": true مع تعيين metaMessageId على null. لا يصل أي شيء إلى WhatsApp، ولا يُطلق webhook message.sent.
  • لا يصل إرسال القالب عبر POST /v1/templates/{id}/submit إلى Meta. بل يعتمد القالب فورًا، أو يرفضه إذا كان اسم القالب يحتوي على reject_. تُرفض ترويسة الوسائط التي تكون عينتها مجرد عنوان ويب مع 400 INVALID_TEMPLATE_COMPONENTS. يظهر القرار في API وفي موجز الأحداث، لكن صفحة Templates في التطبيق لا تتغير.
  • تعمل البيئة التجريبية في مؤسستك الحقيقية. تُخزَّن جهات الاتصال والمحادثات والرسائل المُنشأة أثناء الاختبارات مثل أي بيانات أخرى وتظهر في التطبيق.

​
أدوات الاختبار في البيئة التجريبية

تساعدك نقاط النهاية هذه على محاكاة النشاط. تحتاج إلى النطاق sandbox:manage، وتعمل سواء كانت البيئة التجريبية مفعّلة أم لا، لذا لا تستخدمها إلا مع بيانات الاختبار. لا تكتب أدوات الاختبار إلا في موجز الأحداث (GET /v1/events). ولا ترسل webhooks ولا تغيّر الرسالة نفسها.

​
أدلة البدء السريع

ترتبط بطاقة Quickstarts بأدلة خطوة بخطوة. يُفتح كل منها كملف Markdown في علامة تبويب جديدة.

​
الروابط

​
ذات صلة

مقدمة API

المصادقة والنطاقات وحدود المعدل والأخطاء.

مفاتيح API

أنشئ مفاتيح حية ومفاتيح sandbox.

تطبيقات المطورين

سجّل تطبيق OAuth وأدِر التطبيقات المثبتة.

مرجع Webhooks

أنواع الأحداث والحمولات والتحقق من التوقيعات.
آخر تعديل في ٢٤ أكتوبر ٢٠٢٦