التكاملات: مفاتيح API وWebhooks

من صفحة التكاملات تربط أنظمتك وتطبيقاتك بـ Flovoo، عن طريق مفاتيح API لإرسال الطلبات، وWebhooks لاستقبال الأحداث على خادمك.

المقال موجّه لفريقك التقني أو لمن يبني التكامل، ويشرح إنشاء المفاتيح وإدارتها وإضافة Webhooks.

إنشاء مفتاح API

لإنشاء مفتاح API:

1. 1
   اضغط التكاملات في القائمة الجانبية، ثم API.
2. 2
   اضغط إنشاء مفتاح API.
3. 3
   اكتب الاسم، مثل: تكامل الموقع.
4. 4
   من الصلاحيات، اختر ما يحتاجه التكامل فقط، أو اضغط اختيار الكل.
5. 5
   أكّد إنشاء المفتاح، ثم اضغط نسخ التوكن.

صلاحيات المفتاح

تحدد الصلاحيات ما يستطيع المفتاح الوصول إليه. لكل مجموعة صلاحية للعرض وأخرى للإدارة:

• جهات الاتصال والمحادثات والوسوم والمراحل.
• السيجمنتس والردود الجاهزة والحقول المخصصة.
• البرودكاست وقوالب واتساب وأعضاء الفريق.
• Webhooks لإنشاء Webhooks عن طريق الـ API.

إدارة مفاتيح API

تظهر مفاتيحك في جدول مفاتيح API مع الاسم والصلاحيات وآخر استخدام. ومن عمود الإجراءات يمكنك:

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

توثيق API

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

إضافة Webhook

يرسل Webhook إشعارًا إلى خادمك لحظة وقوع الحدث، مثل رسالة جديدة أو تحديث جهة اتصال أو تغيير حالة قالب. لإضافة Webhook:

1. 1
   اضغط التكاملات، ثم Webhooks.
2. 2
   اضغط إضافة Webhook.
3. 3
   أدخل الرابط واختر الأحداث التي تريد استقبالها.
4. 4
   انسخ المفتاح السري واحفظه على خادمك.

نستخدم المفتاح السري لتوقيع كل إرسال، حتى تتأكد أن الطلب صادر من Flovoo. وتحتاج إلى ربط قناة واتساب واحدة على الأقل قبل إضافة Webhook. لمعرفة طريقة ربط القنوات، يمكنك الاطلاع على مقال إدارة القنوات.

للتعرف على باقي أقسام Flovoo، يمكنك الاطلاع على مقال جولة سريعة في Flovoo.