البناء على منصة Flowella برمجياً.
عندما لا تغطي أدوات «بدون برمجة» بعض الوظائف، فإن واجهة برمجة تطبيقات REST الخاصة بـ Flowella و«webhooks» الصادرة تتولى ذلك. استدعِ واجهة برمجة التطبيقات لإرسال رسائل WhatsApp، وإدارة جهات الاتصال وحالات إلغاء الاشتراك، واستخراج البيانات التحليلية. اشترك في «webhooks» للاستجابة للرسائل وعمليات التسليم وحالات إلغاء الاشتراك وتغييرات القوالب في الوقت الفعلي، دون الحاجة إلى إجراء عمليات استقصاء.
اتصل بهم، ودعهم يتصلون بك.
اتجاهان، محرك واحد. يستدعي تطبيقك واجهة برمجة التطبيقات (REST API) لتنفيذ المهام: إرسال قالب، أو تحديث جهة اتصال، أو استرداد البيانات التحليلية. وفي الاتجاه الآخر، تقوم Flowella بدفع أحداث webhook الموقعة إلى نقطة النهاية الخاصة بك فور حدوث أي شيء، مما يتيح لك الاستجابة فورًا بدلاً من إجراء عمليات الاستقصاء. ويسمح لك هذان الاتجاهان معًا ببناء كل ما تحتاجه من مكونات برمجية بناءً على نفس محرك WhatsApp وHubSpot.
الإرسال والإدارة وإعداد التقارير
واجهة برمجة تطبيقات REST بسيطة من الإصدار 1، تعتمد على مصادقة مفتاح الحامل وتتميز بسلوك يمكن التنبؤ به.
واجهة برمجة التطبيقات REST هي الإصدار v1، والمتاحة على الرابط https://app.flowella.io/api/v1. يحتوي كل طلب على مفتاح حامل (bearer key) على نطاق المؤسسة في رأس «التفويض» (Authorization)، ويتم إنشاؤه من خلال «الإعدادات» > «مفاتيح واجهة برمجة التطبيقات» بواسطة «المالك» أو «المسؤول»، ولا يُعرض إلا مرة واحدة. تستخدم نقاط نهاية القائمة ترقيم الصفحات باستخدام المؤشر بحد أقصى يتراوح بين واحد ومائة، وتُعرض الأخطاء في غلاف متسق مع حقل رمز ثابت، ويتم تحديد معدل الطلبات لكل مؤسسة مع ظهور الرمز 429 عند تجاوز السرعة المسموح بها. من الأفضل تمرير أرقام الهواتف بتنسيق E.164، كما يمكن إدراج مواصفات OpenAPI القابلة للقراءة آليًّا مباشرةً في Postman أو في مُنشئ الأكواد.
بالنسبة لعمليات الإرسال المجمعة الكبيرة، تقبل نقطة نهاية إرسال القوالب معلمة «الحد الأقصى للساعة»، بحيث تقوم Flowella بتنظيم وتيرة التسليم من جانب الخادم، بدلاً من أن تقوم أنت بتنظيم وتيرة الطلبات بنفسك.
التفاعل مع الأحداث في الوقت الفعلي
اشترك في الأحداث التي تهمك، وستقوم Flowella بنشر حزمة بيانات موقعة فور حدوثها.
| الحدث | عند تشغيله |
|---|---|
| message.received | وصول رسالة واردة عبر WhatsApp من أحد جهات الاتصال |
| message.sent | قبلت Flowella رسالتك الصادرة وأرسلتها إلى Meta |
| message.delivered | أكدت Meta تسليم الرسالة إلى جهاز المستلم |
| message.read | قام المستلم بفتح الرسالة |
| message.failed | أرجعت Meta رسالة فشل للرسالة |
| conversation.opened / closed | تغيرت حالة المحادثة |
| optout.created | قام أحد جهات الاتصال بإلغاء الاشتراك في قناة |
| template.status_updated | قام Meta بتغيير حالة القالب |
يتم توقيع كل طلب باستخدام ملخص سداسي عشري HMAC-SHA256 للنص الأصلي، لذا تحقق من التوقيع قبل المعالجة. تنتظر Flowella ما يصل إلى عشر ثوانٍ للحصول على رد 2xx، وتعيد المحاولة حتى ثلاث مرات مع التراجع التدريجي، وتقوم تلقائيًا بتعطيل نقطة النهاية بعد عشر محاولات فاشلة متتالية. ونظرًا لأن محاولات الإعادة قد تؤدي إلى تكرار الحدث، فاستخدم معرّف الحدث كمفتاح تكرار، وتعامل مع التكرارات على أنها عمليات لا تؤدي إلى أي نتيجة.
النهج الذي يركز على عدم استخدام الكود أولاً، واستخدامه عند الحاجة.
تعمل واجهة برمجة التطبيقات (API) على توسيع نطاق المنتج. وهي لا تحل محل الأجزاء التي تعمل بالفعل دون الحاجة إلى كتابة كود.
ابدأ من هنا للاطلاع على الوظائف الشائعة.
معظم ما تحتاجه الفرق — مثل إرسال القوالب، وتسجيل إجابات «Flow»، وتشغيل عمليات الأتمتة — يتم تغطيته بالفعل دون الحاجة إلى استخدام واجهة برمجة التطبيقات (API). لا تلجأ إلى البرمجة إلا عندما تحتاج إلى شيء يتجاوز ذلك.
- من «Form to Flow» إلى «HubSpot»، مزامنة أصلية مع HubSpot
- إجراءات سير العمل وصندوق الوارد
- لا حاجة لكتابة أي كود
استعن بالبرمجة عندما تحتاج إلى المزيد.
عندما تحتاج إلى ربط تطبيق «واتساب» بنظام مخصص، أو إجراء المزامنة مع أداة لا تحتوي على موصل مدمج، أو الاستجابة لأحداث في نظام الخلفية الخاص بك، فإن واجهة برمجة التطبيقات (API) و«ويبهوكس» تمنحك التحكم الكامل.
- التطبيقات المخصصة وعمليات التكامل المصممة حسب الطلب
- التفاعل مع الأحداث دون الحاجة إلى الاستقصاء
- عمليات الإرسال الجماعية مع التحكم في السرعة من جانب الخادم
- ⏱️ 30 ثانية · بطاقة مسجلة في النظام
- 👤 بالتعاون مع · فريق العضوية
- 📩 تم إرسال الإيصال إلى هنا بعد التجديد
اختر باقتك
- 🏆 سنوي · 49 جنيهًا إسترلينيًّا ✓
- 🎯 فصلي · 15 جنيهًا إسترلينيًّا ✓
- 📅 شهريًا · 6 جنيهات إسترلينية ✓
بواسطة Flowella · تجديد آمن
إجابات مباشرة.
الأسئلة التي يطرحها المطورون.
كيف يمكنني إتمام عملية المصادقة؟
مفتاح حامل على نطاق المؤسسة، يتم إنشاؤه من خلال «الإعدادات» > «مفاتيح واجهة برمجة التطبيقات» بواسطة المالك أو المسؤول. ولا يظهر هذا المفتاح إلا مرة واحدة عند إنشائه، لذا يجب حفظه في مكان آمن وتغييره عند مغادرة أي من أعضاء الفريق.
ما الذي يمكن أن تفعله واجهة برمجة التطبيقات (API)؟
إرسال رسائل وقوالب WhatsApp، وإدارة جهات الاتصال وحالات إلغاء الاشتراك، وإعداد قوائم القوالب وإرسالها بشكل جماعي، واستخراج التحليلات. يتم إنشاء قائمة نقاط النهاية الكاملة تلقائيًا استنادًا إلى مواصفات OpenAPI.
هل يمكنني إرسال رسائل جماعية بكميات كبيرة؟
نعم. استخدم نقطة نهاية الإرسال الخاصة بالقوالب مع معلمة «throttle-per-hour»، وستقوم Flowella بفرض السرعة من جانب الخادم، لذا لن تحتاج إلى إدارة التوقيت أو حدود معدل الاستدعاء بنفسك.
كيف يمكنني التحقق من صحة ويبهوك ما؟
يتم توقيع كل ويبهوك باستخدام ملخص HMAC-SHA256 لنص الطلب الخام. احسب نفس الملخص باستخدام مفتاح التوقيع السري الخاص بك وقارن النتائج، مع التأكد من توقيع البايتات الخام قبل إجراء أي تحليل لبيانات JSON.
ماذا لو تعطلت نقطة النهاية الخاصة بي؟
تقوم Flowella بإعادة المحاولة حتى ثلاث مرات مع تطبيق آلية التراجع (backoff)، وتقوم تلقائيًا بتعطيل نقطة النهاية بعد عشر محاولات فاشلة متتالية. يمكنك إعادة تفعيلها من «الإعدادات» > «Webhooks» بمجرد إصلاح نقطة النهاية.
كيف يمكنني تجنب معالجة البيانات المكررة؟
استخدم معرّف الحدث كمفتاح تكرار، واحتفظ بذاكرة تخزين مؤقتة قصيرة الأمد للمفاتيح التي تمت معالجتها، وتعامل مع التكرارات على أنها عمليات لا تؤدي إلى أي نتيجة. وتعني عمليات إعادة المحاولة أن الحدث نفسه قد يصل أكثر من مرة.
اقرأ وثائق المطورين
كل ما يرد في هذه الصفحة، بما في ذلك المراجع الكاملة وأمثلة الأكواد، متوفر في قسم الوثائق.
تتوفر مرجع المطور الكامل في قاعدة المعرفة.
تتناول مقدمة واجهة برمجة التطبيقات (API) عنوان URL الأساسي، والمصادقة، والأخطاء، وتقسيم الصفحات، وحدود المعدل، ومواصفات OpenAPI.
تتناول «webhooks الصادرة» تكوين webhook، وقائمة الأحداث الكاملة، والتحقق من التوقيع، وإعادة المحاولة، وخصائص الإيدمبوتينسي، مع أمثلة على الأكواد البرمجية.
استفد من نفس المحرك، على طريقتك الخاصة.
