لوحة تحكم المدير العام — Bekya Pay

إدارة محادثات العملاء عبر Instagram و Facebook Messenger وإعدادات الربط المباشر مع Meta API و Agent X AI.

إعدادات الربط الرسمية — Meta Graph API

إعدادات API ميتا (Facebook & Instagram)

أدخل مفاتيح الربط الرسمية: Meta App ID و Page Access Token و Instagram ID و Webhook URL.

ربط مباشر مع الماسنجر وإنستجرام

إعدادات الذكاء الاصطناعي — Agent X API

إعدادات API منصة Agent X للأتمتة

أدخل رابط الـ Endpoint ومفتاح الـ API الخاص بـ Agent X: API Base URL و API Key و Webhook Secret.

تحكم كامل في الرد الآلي والتسليم البشري

إجمالي المحادثات (Total)

تحديث فوري من قاعدة البيانات

المحادثات المفتوحة (Open)

غير مقروء: 0 • بانتظار الرد: 0

حسابات الموظفين النشطة

إدارة الموظفين والصلاحيات

القنوات المربوطة (Channels)

Instagram & Facebook Messenger

حالة اتصال الـ API المباشر (Meta & Agent X)

حالة الربط الفعلية والتحقق من المفاتيح

LIVE

إحصائيات الـ Webhooks وأتمتة Agent X

الأحداث المسجلة والرسائل المعالجة

Webhook Events

AI Executions

Integration Errors

أحدث محادثات العملاء

سجل العمليات والنشاط الإداري

Conversations (0) Latest Activity

لم يتم اختيار محادثة

اختر محادثة من القائمة الجانبية لعرض الرسائل والرد على العميل، أو قم بإعداد مفاتيح Meta API لاستقبال رسائل Instagram و Facebook Messenger.

Customer

Messenger Open

ID: -- • Thread: --

Manual Support Mode Human support operator is handling this thread.

Attach File

سجل العملاء (Customers Directory)

بيانات العملاء الواردة من محادثات Instagram و Facebook Messenger.

Customer Name	Platform	External ID (PSID / IGSID)	Contact Info	Last Interaction	Actions

إعدادات الربط الرسمية — Official Meta Graph API

Meta Integration Settings (إعدادات API ميتا)

أدخل بيانات الربط الخاصة بـ Facebook Messenger و Instagram Business. يتم حفظ الرموز السرية بشكل مشفر ومخفي (••••••••last4).

Connection Status

Unconfigured

Last Live Connection Check

Never tested

Last Verified Webhook Event

No webhook events received

Required Permissions Scope

pages_messaging, instagram_manage_messages

حالة التشخيص / آخر رسالة من Meta API

Ready for configuration.

حقول إدخال مفاتيح Meta API

تفعيل Meta Integration

Meta App ID *

Graph API Base URL *

Meta App Secret

Not set

Facebook Page ID *

Instagram Business Account ID

Facebook Page Access Token *

Not set

Instagram Access Token (اختياري إذا كان موحداً مع Page Token)

Not set

Webhook Callback URL

Webhook Verification Token Not set

خطوات ربط Meta Developer Portal

افتح Meta for Developers واختر تطبيقك ثم أضف منتجات Messenger و Instagram.
أدخل Meta App ID و Facebook Page ID و Page Access Token في الحقول المقابلة.
فعّل اشتراكات الـ Webhook للحقول: messages, messaging_postbacks, message_deliveries, message_reads.
اضغط على فحص الاتصال المباشر (Test Live Meta API) للتحقق الفوري من صلاحية التوكن.

الحسابات المربوطة (Connected Social Accounts)

إعدادات الربط الذكي — Agent X AI Automation API

Agent X Integration Settings (إعدادات API لـ Agent X)

أدخل رابط الـ API ومفتاح المصادقة الخاص بنظام أتمتة الذكاء الاصطناعي Agent X.

Connection Status

Unconfigured

Last Connection Check

Never tested

Last Successful Synchronization

No sync recorded

Adapter Contract State

Isolated Adapter Ready

حالة التشخيص / آخر رسالة من Agent X API

Ready for configuration.

حقول إدخال مفاتيح Agent X API

تفعيل Agent X Automation

Agent X API Base URL *

Agent X Workflow / Agent ID

Agent X API Key / Bearer Token *

Not set

Agent X Inbound Webhook URL

Webhook Signing Secret Not set

آلية عمل الربط مع Agent X

يرتبط النظام مع Agent X عبر محول معزول آمن يرسل الرسائل الواردة ويستقبل ردود الذكاء الاصطناعي، مع إيقاف الرد الآلي فوراً عند تدخل موظف خدمة العملاء.

سجل تنفيذ أتمتة Agent X

إدارة حسابات الموظفين والصلاحيات (Employees & RBAC)

يمتلك المدير العام (admin) كافة الصلاحيات لإنشاء حسابات الموظفين وتعديلهم وتخصيص صلاحياتهم.

إنشاء حساب موظف جديد

اسم الموظف الكامل *

البريد الإلكتروني أو اسم المستخدم *

الدور الوظيفي *

حالة الحساب

تخصيص الصلاحيات للموظف

قائمة الموظفين والحسابات

Employee	Role	Status	Last Login	Actions

مصفوفة صلاحيات الأدوار (RBAC Matrix)

تخصيص الصلاحيات الافتراضية لكل دور وظيفي.

Role:

مركز الإعدادات والـ API (Settings & API Center)

الوصول المباشر إلى إعدادات Meta API و Agent X API وقواعد التشغيل.

Meta Official Messaging API

Meta Integration Settings (Messenger & Instagram)

إدخال وإدارة Meta App ID, App Secret, Facebook Page ID, Page Access Token, Instagram Business Account ID, و Webhook Token.

Agent X AI Automation API

Agent X Integration Settings (AI Workflows)

إدخال وإدارة Agent X API Base URL, API Key / Bearer Token, Workflow ID, و Webhook Signing Secret.

قواعد التعايش بين الذكاء الاصطناعي وفريق الدعم

تفعيل تعيين المحادثات للموظفين

السماح بتوجيه المحادثات إلى موظفي خدمة العملاء.

إيقاف الرد الآلي لـ Agent X تلقائياً عند رد الموظف البشري

يمنع تداخل ردود الذكاء الاصطناعي عندما يتولى موظف بشري المحادثة.

حفظ ردود الذكاء الاصطناعي في سجل المحادثة للمراجعة

توثيق جميع ردود Agent X داخل سجل المحادثة.

سجل التدقيق الأمني والعمليات (Audit Logs)

سجل كامل لتسجيلات الدخول وتحديثات الصلاحيات وإعدادات الـ API.

Timestamp	Actor	Role	Category / Action	Target Resource	Outcome	Details

برومبت منصة الإنشاء الكامل (Master Creation Platform Prompt)

برومبت شامل جاهز للنسخ لبناء وتطوير المنصة باللونين الأزرق والأبيض مع كافة الميزات.

Complete Specification Prompt:

PROJECT: BEKYA PAY — UNIFIED MESSAGING DASHBOARD & AGENT X AI INTEGRATION (BLUE & WHITE EDITION)

ROLE & MISSION:
Act as a Senior Full-Stack Software Engineer, Software Architect, UI/UX Designer, Database Engineer, API Integration Specialist, Security Engineer, and QA Automation Engineer. Build a complete, production-ready web application for Bekya Pay that provides a unified customer messaging dashboard across Instagram Business and Facebook Messenger, integrated with Agent X AI automation workflows.
- Visual Theme: Crisp, high-trust Financial SaaS Blue & White palette (#FFFFFF backgrounds, #F8FAFC secondary surfaces, #1D4ED8 / #2563EB primary royal blue accents, official Bekya Pay logo on login background and header, responsive across desktop, tablet, and mobile).
- Mandatory Rule: ZERO fake or hardcoded customer/conversation data.

1. AUTHENTICATION, LOGIN PAGE & GENERAL MANAGER ACCOUNT:
- Build a dedicated, responsive login page (`login.html`) with the official Bekya Pay brand background and logo, Username/Email field, Password field, Show/Hide Password toggle, validation, and employee invitation token setup.
- Provision the General Manager account (`admin` / `admin123`) hashed via PBKDF2-SHA256 in `users` table with full Administrator privileges.

2. ADMINISTRATOR & EMPLOYEE MANAGEMENT (RBAC):
- The General Manager (`administrator`) holds unrestricted access to all dashboard sections, conversations, employee creation/editing, role management, Meta & Agent X API settings, webhook diagnostics, and security audit logs.
- Build an Employee Management & RBAC page allowing the Administrator to create and edit employees (Full Name, Email, Role, Status, Custom Permissions) and customize role permissions across 11 granular permissions.

3. DEDICATED API INTEGRATION SETTINGS (META & AGENT X):
- Create prominent, dedicated configuration pages in Settings for:
  A) Meta Integration Settings: Meta App ID, Meta App Secret, Facebook Page ID, Facebook Page Access Token, Instagram Business Account ID, Instagram Access Token, Webhook Callback URL, Webhook Verification Token, Environment selector (`Development` / `Production`), Connection Status, and real Graph API live connection test.
  B) Agent X Integration Settings: Agent X API Base URL, Workflow/Agent ID, Agent X API Key / Bearer Token, Inbound Webhook URL, Webhook Signing Secret, Environment selector (`Development` / `Production`), Connection Status, and AI-to-Human handoff controls.

4. THREE-PANEL UNIFIED MESSAGING INBOX & WEBHOOK ENGINE:
- Left Panel: Navigation Sidebar with direct API Settings section.
- Middle Panel: Real-time Conversation List from database with Search, Platform filter (Instagram / Messenger), Status filter, Assignment filter, and Pagination.
- Right Panel & Customer Drawer: Full message history, real delivery statuses (`sending`, `sent`, `delivered`, `read`, `failed`, `received`), retry action, status selector, employee assignment, AI handoff toggle, and customer profile notes.

5. RELATIONAL DATABASE & AUTOMATED QA SUITE:
- Persist all data across 14 relational tables: `users`, `roles`, `permissions`, `user_role_assignments`, `role_permissions`, `social_accounts`, `customers`, `conversations`, `messages`, `conversation_assignments`, `integrations`, `webhook_events`, `automation_events`, and `audit_logs`.

لوحة تحكم المدير العام — Bekya Pay

إعدادات API ميتا (Facebook & Instagram)

إعدادات API منصة Agent X للأتمتة

حالة اتصال الـ API المباشر (Meta & Agent X)

إحصائيات الـ Webhooks وأتمتة Agent X

أحدث محادثات العملاء

سجل العمليات والنشاط الإداري

لم يتم اختيار محادثة

Customer

سجل العملاء (Customers Directory)

Meta Integration Settings (إعدادات API ميتا)

حقول إدخال مفاتيح Meta API

خطوات ربط Meta Developer Portal

الحسابات المربوطة (Connected Social Accounts)

Agent X Integration Settings (إعدادات API لـ Agent X)

حقول إدخال مفاتيح Agent X API

آلية عمل الربط مع Agent X

سجل تنفيذ أتمتة Agent X

Meta & Agent X Webhook Console

1. التحقق من اشتراك الـ Webhook (`hub.verify_token`)

2. معالجة حمولة الـ Webhook (Payload Processor)

سجل أحداث الـ Webhook (Persisted Events)

إدارة حسابات الموظفين والصلاحيات (Employees & RBAC)

إنشاء حساب موظف جديد

قائمة الموظفين والحسابات

مصفوفة صلاحيات الأدوار (RBAC Matrix)

التقارير التشغيلية والإحصائيات (Operational Reports)

Conversations by Channel & Status

Messages by Sender & Delivery State

مركز الإعدادات والـ API (Settings & API Center)

Meta Integration Settings (Messenger & Instagram)

Agent X Integration Settings (AI Workflows)

قواعد التعايش بين الذكاء الاصطناعي وفريق الدعم

سجل التدقيق الأمني والعمليات (Audit Logs)

فحص الجودة الآلي (Automated QA Verification Suite)

برومبت منصة الإنشاء الكامل (Master Creation Platform Prompt)

تعديل بيانات وصلاحيات الموظف

لوحة تحكم المدير العام — Bekya Pay

إعدادات API ميتا (Facebook & Instagram)

إعدادات API منصة Agent X للأتمتة

حالة اتصال الـ API المباشر (Meta & Agent X)

إحصائيات الـ Webhooks وأتمتة Agent X

أحدث محادثات العملاء

سجل العمليات والنشاط الإداري

لم يتم اختيار محادثة

Customer

سجل العملاء (Customers Directory)

Meta Integration Settings (إعدادات API ميتا)

حقول إدخال مفاتيح Meta API

خطوات ربط Meta Developer Portal

الحسابات المربوطة (Connected Social Accounts)

Agent X Integration Settings (إعدادات API لـ Agent X)

حقول إدخال مفاتيح Agent X API

آلية عمل الربط مع Agent X

سجل تنفيذ أتمتة Agent X

Meta & Agent X Webhook Console

1. التحقق من اشتراك الـ Webhook (hub.verify_token)

2. معالجة حمولة الـ Webhook (Payload Processor)

سجل أحداث الـ Webhook (Persisted Events)

إدارة حسابات الموظفين والصلاحيات (Employees & RBAC)

إنشاء حساب موظف جديد

قائمة الموظفين والحسابات

مصفوفة صلاحيات الأدوار (RBAC Matrix)

التقارير التشغيلية والإحصائيات (Operational Reports)

Conversations by Channel & Status

Messages by Sender & Delivery State

مركز الإعدادات والـ API (Settings & API Center)

Meta Integration Settings (Messenger & Instagram)

Agent X Integration Settings (AI Workflows)

قواعد التعايش بين الذكاء الاصطناعي وفريق الدعم

سجل التدقيق الأمني والعمليات (Audit Logs)

فحص الجودة الآلي (Automated QA Verification Suite)

برومبت منصة الإنشاء الكامل (Master Creation Platform Prompt)

تعديل بيانات وصلاحيات الموظف

1. التحقق من اشتراك الـ Webhook (`hub.verify_token`)