تركيب Activepieces والتكامل مع Telegram وSheets

مقدمة حول الأتمتة المفتوحة باستخدام Activepieces

في العديد من المنظمات والمشاريع، يتم استلام البيانات عبر قنوات تواصل سريعة مثل Telegram، ولكن حفظ هذه البيانات وتحليلها يتطلب نقلها إلى جداول بيانات مثل Google Sheets. القيام بذلك يدوياً هو هدر للوقت وعرضة للأخطاء. منصة Activepieces هي بديل مفتوح المصدر لـ Zapier، وتتيح لك بناء هذه الأتمتة بسهولة، وباستضافة ذاتية تضمن خصوصيتك.

الجزء الأول: تثبيت Activepieces مع قاعدة بيانات Postgres

لضمان بيئة إنتاجية مستقرة، يفضل تثبيت Activepieces باستخدام Docker Compose وربطه بقاعدة بيانات PostgreSQL بدلاً من قاعدة بيانات SQLite الافتراضية المخصصة للتجارب.

قم بإنشاء مجلد المشروع واصنع ملف docker-compose.yml.
أضف خدمتين داخل الملف: خدمة لقاعدة البيانات postgres:13، وخدمة لـ activepieces/activepieces.
اربط التطبيق بقاعدة البيانات عبر إعداد متغيرات البيئة (Environment Variables) مثل AP_POSTGRES_DATABASE و AP_POSTGRES_USERNAME و AP_POSTGRES_PASSWORD.
شغل الحاوية عبر الأمر docker-compose up -d.
افتح المتصفح على http://localhost:8080 (أو المنفذ الذي حددته) وأكمل إعداد حساب المسؤول.

الجزء الثاني: بناء مسار العمل (Flow)

بعد الدخول إلى واجهة Activepieces، حان الوقت لإنشاء مسار العمل الذي يربط تيليجرام بجداول جوجل.

1. إعداد المشغل (Trigger) – Telegram

انقر على New Flow، وفي عقدة البداية (Trigger)، ابحث عن تطبيق Telegram.
اختر حدث New Message (رسالة جديدة).
ستحتاج إلى ربط حسابك بإنشاء بوت جديد عبر BotFather في تيليجرام، والحصول على الـ Bot Token لإضافته كـ (Connection) في Activepieces.

2. إعداد الإجراء (Action) – Google Sheets

أضف خطوة جديدة (Step) بعد التيليجرام، وابحث عن Google Sheets.
اختر الإجراء Insert Row (إدراج صف).
قم بعمل مصادقة (OAuth) بحساب جوجل الخاص بك.
حدد جدول البيانات (Spreadsheet) وورقة العمل (Worksheet) التي تريد إضافة البيانات إليها.
في إعدادات الأعمدة، قم بربط بيانات الأعمدة بالمتغيرات القادمة من عقدة التيليجرام. مثلاً: اجعل العمود الأول يقرأ {{telegram.message.chat.username}} والعمود الثاني يقرأ نص الرسالة {{telegram.message.text}} والعمود الثالث يقرأ تاريخ وتوقيت الرسالة.

الاختبار والتشغيل

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

الخلاصة

منصة Activepieces توفر توازناً مذهلاً بين السهولة البصرية وقوة الاستضافة الذاتية. خلال دقائق معدودة، تمكنت من ربط تطبيق مراسلة (Telegram) بتطبيق بيانات (Sheets)، مما يمهد الطريق لأتمتة آلاف المهام الروتينية الأخرى داخل منظمتك بدون أي تكاليف إضافية.