انتقل إلى المحتوى الرئيسي

دمج Mailjet مع OmniCRM

يتكامل OmniCRM مع Mailjet لإدارة جميع الاتصالات البريدية مع العملاء والموظفين، مما يضمن تسليم بريد إلكتروني احترافي ومميز وموثوق لكل من رسائل البريد الإلكتروني المعاملات وحملات التسويق.

نظرة عامة​

يوفر دمج Mailjet:

  • رسائل البريد الإلكتروني المعاملات الآلية - إعادة تعيين كلمة المرور، الفواتير، رسائل الترحيب، الإشعارات
  • مزامنة جهات الاتصال - جهات اتصال العملاء تتم مزامنتها تلقائيًا مع Mailjet للحملات
  • قوالب البريد الإلكتروني - أكثر من 10 أنواع قوالب بريد إلكتروني مسبقة التكوين مع قوالب Mailjet قابلة للتخصيص
  • حملات تسويقية - حملات بريد إلكتروني مقسمة بناءً على بيانات العملاء
  • ت��ليم موثوق - بنية تحتية احترافية للبريد الإلكتروني مع تتبع وتحليلات

التكوين​

يتم تكوين Mailjet في OmniCRM-API/crm_config.yaml تحت قسم mailjet.

التكوين الأساسي​

mailjet:
  api_key: your_mailjet_api_key
  api_secret: your_mailjet_api_secret

الحصول على بيانات اعتماد API:

  1. إنشاء حساب على <https://www.mailjet.com>
  2. الانتقال إلى إعدادات الحساب → مفاتيح API
  3. نسخ مفتاح API و المفتاح السري
  4. لصقها في crm_config.yaml

تكوين قالب البريد الإلكتروني​

يستخدم OmniCRM 10 أنواع مختلفة من قوالب البريد الإلكتروني للاتصالات الآلية. يتم تكوين كل قالب مع:

  • from_email - عنوان البريد الإلكتروني للمرسل
  • from_name - اسم العرض للمرسل
  • template_id - معرف قالب Mailjet (رقمي)
  • subject - سطر موضوع البريد الإلكتروني

أنواع القوالب والتكوين​

رسالة ترحيب العميل​

ترسل عند إنشاء حساب عميل جديد.

api_crmCommunicationCustomerWelcome:
  from_email: "support@yourcompany.com"
  from_name: "Your Company Support"
  template_id: 5977509
  subject: "Welcome to Your Company"

متى ترسل:

  • يقوم عميل جديد بالتسجيل عبر بوابة الخدمة الذاتية
  • يقوم الموظف بإنشاء حساب عميل جديد
  • يقوم العميل بتنشيط الخدمة لأول مرة

متغيرات القالب المتاحة:

  • {{ var:customer_name }} - الاسم الكامل للعميل
  • {{ var:email }} - عنوان البريد الإلكتروني للعميل
  • {{ var:company_name }} - اسم شركتك
  • {{ var:login_url }} - رابط إلى بوابة الخدمة الذاتية
  • {{ var:support_url }} - رابط إلى صفحة الدعم

رسالة فاتورة العميل​

ترسل عندما يتم إنشاء فاتورة وجاهزة للدفع.

api_crmCommunicationCustomerInvoice:
  from_email: "billing@yourcompany.com"
  from_name: "Your Company Billing"
  template_id: 6759851
  subject: "Your Invoice - "

متى ترسل:

  • تم إنشاء فاتورة تلقائيًا لفترة الفوترة
  • تم إنشاء فاتورة يدوية بواسطة الموظف
  • يطلب العميل نسخة من الفا��ورة

متغيرات القالب المتاحة:

  • {{ var:customer_name }} - الاسم الكامل للعميل
  • {{ var:invoice_number }} - معرف/رقم الفاتورة
  • {{ var:invoice_date }} - تاريخ إصدار الفاتورة
  • {{ var:due_date }} - تاريخ استحقاق الدفع
  • {{ var:total_amount }} - المبلغ الإجمالي المستحق
  • {{ var:invoice_url }} - رابط لعرض/تنزيل PDF الفاتورة
  • {{ var:pay_url }} - رابط لدفع الفاتورة عبر الإنترنت

مرفق الفاتورة:

يتم إرفاق PDF الفاتورة تلقائيًا بالبريد الإلكتروني.

تذكير فاتورة العميل​

ترسل لتذكير العملاء بالفواتير المتأخرة.

api_crmCommunicationCustomerInvoiceReminder:
  from_email: "billing@yourcompany.com"
  from_name: "Your Company Billing"
  template_id: 6759852
  subject: "Payment Reminder - Invoice Overdue"

متى ترسل:

  • الفاتورة متأخرة بمقدار X يوم (قابل للتكوين)
  • تم تفعيل تذكير يدوي بواسطة الموظف
  • سير عمل تذكير تلقائي (إذا تم تكوينه)

متغيرات القالب المتاحة:

  • {{ var:customer_name }}
  • {{ var:invoice_number }}
  • {{ var:due_date }}
  • {{ var:days_overdue }}
  • {{ var:total_amount }}
  • {{ var:pay_url }}

رسالة ترحيب مستخدم الموظف​

ترسل عند إنشاء حساب مستخدم موظف جديد.

api_crmCommunicationUserWelcome:
  from_email: "admin@yourcompany.com"
  from_name: "Your Company Admin"
  template_id: 5977510
  subject: "Welcome to the Team"

متى ترسل:

  • يقوم المسؤول بإنشاء مستخدم موظف جديد
  • تم النقر على زر "إرسال رسالة الترحيب" في إدارة المستخدم

متغيرات القالب المتاحة:

  • {{ var:user_name }} - الاسم الكامل لمستخدم الموظف
  • {{ var:email }} - بريد المستخدم الإلكتروني
  • {{ var:role }} - الدور (الأدوار) المعينة
  • {{ var:login_url }} - رابط لتسجيل الدخول إلى بوابة الإدارة
  • {{ var:temp_password }} - كلمة المرور المؤقتة (إذا كانت قابلة للتطبيق)
  • {{ var:support_email }} - جهة الاتصال للدعم الفني

إعادة تعيين كلمة مرور المستخدم​

ترسل عندما يطلب المستخدم إعادة تعي��ن كلمة المرور الخاصة به.

api_crmCommunicationUserPasswordReset:
  from_email: "noreply@yourcompany.com"
  from_name: "Your Company Security"
  template_id: 5977511
  subject: "Password Reset Request"

متى ترسل:

  • ينقر المستخدم على "نسيت كلمة المرور" في صفحة تسجيل الدخول
  • يقدم المستخدم طلب إعادة تعيين كلمة المرور

متغيرات القالب المتاحة:

  • {{ var:user_name }}
  • {{ var:reset_url }} - رابط إعادة تعيين كلمة المرور المحدود بالوقت (عادةً ساعة واحدة)
  • {{ var:expiry_time }} - متى تنتهي صلاحية رابط إعادة التعيين

ملاحظة أمنية:

تنتهي صلاحية روابط إعادة التعيين بعد فترة زمنية محددة (الافتراضي ساعة واحدة).

نجاح إعادة تعيين كلمة مرور المستخدم​

ترسل لتأكيد أنه تم تغيير كلمة المرور بنجاح.

api_crmCommunicationUserPasswordResetSuccess:
  from_email: "noreply@yourcompany.com"
  from_name: "Your Company Security"
  template_id: 5977512
  subject: "Password Changed Successfully"

متى ترسل:

  • يكمل المستخدم إعادة تعيين كلمة المرور بنجاح
  • مباشرة بعد تعيين كلمة المرور الجديدة

متغيرات القالب المتاحة:

  • {{ var:user_name }}
  • {{ var:change_date }} - تاريخ/وقت تغيير كلمة المرور
  • {{ var:ip_address }} - عنوان IP للتغيير (اختياري)
  • {{ var:support_email }} - جهة الاتصال إذا كان التغيير غير مصرح به

تغيير كلمة مرور المستخدم​

ترسل عندما يغير المستخدم كلمة المرور الخاصة به من الإعدادات.

api_crmCommunicationUserPasswordChange:
  from_email: "noreply@yourcompany.com"
  from_name: "Your Company Security"
  template_id: 5977513
  subject: "Password Change Notification"

متى ترسل:

  • يغير المستخدم كلمة المرور من الملف الشخصي/الإعدادات
  • يقوم المسؤول بإعادة تعيين كلمة مرور المستخدم

متغيرات القالب المتاحة:

  • {{ var:user_name }}
  • {{ var:change_date }}
  • {{ var:changed_by }} - "نفسه" أو اسم المسؤول
  • {{ var:support_email }}

التحقق من البريد الإلكتروني​

ترسل للتحقق من عنوان بريد المستخدم الإلكتروني.

api_crmCommunicationEmailVerification:
  from_email: "noreply@yourcompany.com"
  from_name: "Your Company"
  template_id: 5977514
  subject: "Verify Your Email Address"

متى ترسل:

  • تم إنشاء حساب جديد (عميل أو موظف)
  • يغير المستخدم عنوان البريد الإلكتروني
  • مطلوب التحقق من البريد الإلكتروني لأغراض الأمان

متغيرات القالب المتاحة:

  • {{ var:user_name }}
  • {{ var:verification_url }} - رابط للتحقق من البريد الإلكتروني
  • {{ var:verification_code }} - الرمز للدخول يدويًا (بديل للرابط)

إشعار انتهاء الرصيد​

ترسل عندما تنتهي صلاحية رصيد/مخصص خدمة العميل.

api_crmCommunicationsBalanceExpired:
  from_email: "support@yourcompany.com"
  from_name: "Your Company Support"
  template_id: 5977515
  subject: "Your Service Balance Has Expired"

متى ترسل:

  • انتهت صلاحية الرصيد المدفوع مسبقًا
  • مرت فترة تجديد المخصص الشهري
  • تم الوصول إلى تاريخ انتهاء الخدمة

متغيرات القالب المتاحة:

  • {{ var:customer_name }}
  • {{ var:service_name }} - اسم الخدمة المنتهية
  • {{ var:expiry_date }}
  • {{ var:balance_type }} - "بيانات"، "صوت"، "نقدي"، إلخ.
  • {{ var:renewal_url }} - رابط للتجديد/إعادة التعبئة

تنبيه انخفاض الرصيد​

ترسل عندما ينخفض رصيد العميل تحت العتبة المحددة.

api_crmCommunicationsBalanceLow:
  from_email: "support@yourcompany.com"
  from_name: "Your Company Support"
  template_id: 5977516
  subject: "Low Balance Alert"

متى ترسل:

  • ينخفض الرصيد تحت العتبة (على سبيل المثال، 20% المتبقية)
  • تم تكوينها في خطة الخدمة أو OCS
  • ي trigger التنبيه من خلال المراقبة في الوقت الحقيقي

متغيرات القالب المتاحة:

  • {{ var:customer_name }}
  • {{ var:service_name }}
  • {{ var:current_balance }}
  • {{ var:threshold }}
  • {{ var:balance_type }}
  • {{ var:topup_url }} - رابط لإضافة رصيد

إنشاء قوالب بريد إلكتروني Mailjet​

لكل نوع بريد إلكتروني، تحتاج إلى إنشاء قا��ب مطابق في Mailjet.

الخطوة 1: إنشاء قالب في Mailjet​

  1. تسجيل الدخول إلى لوحة معلومات Mailjet
  2. الانتقال إلى قوالب البريد الإلكتروني → القوالب المعاملات
  3. النقر على إنشاء قالب جديد
  4. اختيار برمجة قالبك الخاص (للمستخدمين المتقدمين) أو استخدام منشئ القوالب

الخطوة 2: تصميم القالب​

استخدم منشئ السحب والإفلات الخاص بـ Mailjet أو محرر HTML لتصميم بريدك الإلكتروني.

العناصر الأساسية:

  • رأس - شعار الشركة والعلامة التجارية
  • تحية - مخصصة باستخدام {{ var:customer_name }} أو {{ var:user_name }}
  • المحتوى - نص الرسالة الرئيسي
  • المتغيرات - إدراج متغيرات القالب من القائمة أعلاه
  • دعوة للعمل - أزرار/روابط لإجراءات المستخدم
  • تذييل - رابط إلغاء الاشتراك، عنوان الشركة، جهة الاتصال للدعم

مثال على القالب (إعادة تعيين كلمة المرور):

<!DOCTYPE html>
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; }
        .button { background-color: #4CAF50; color: white; padding: 14px 28px; }
    </style>
</head>
<body>
    <img src="https://yourcompany.com/logo.png" alt="Logo" width="200">

    <h2>Password Reset Request</h2>

    <p>Hello {{ var:user_name }},</p>

    <p>We received a request to reset your password. Click the button below to create a new password:</p>

    <a href="{{ var:reset_url }}" class="button">Reset Password</a>

    <p>This link expires in {{ var:expiry_time }}.</p>

    <p>If you didn't request this, please ignore this email.</p>

    <hr>
    <p style="font-size: 12px; color: #666;">
        Your Company | support@yourcompany.com<br/>
        123 Business St, City, Country
    </p>
</body>
</html>

الخطوة 3: الحصول على معرف القالب​

  1. حفظ القالب في Mailjet
  2. ملاحظة معرف القالب (رقمي، على سبيل المثال، 5977509)
  3. نسخ هذا المعرف إلى crm_config.yaml

الخطوة 4: اختبار القالب​

  1. في Mailjet، استخدم ميزة البريد الإلكتروني التجريبي
  2. قدم قيم عينة لجميع المتغيرات
  3. أرسل بريدًا تجريبيًا لنفسك
  4. تحقق من التنسيق والروابط والعلامة التجارية

الخطوة 5: التكوين في OmniCRM​

أضف تكوين القالب إلى crm_config.yaml:

mailjet:
  api_key: your_api_key
  api_secret: your_secret

  api_crmCommunicationUserPasswordReset:
    from_email: "noreply@yourcompany.com"
    from_name: "Your Company Security"
    template_id: 5977511
    subject: "Password Reset Request"

أعد تشغيل واجهة برمجة تطبيقات OmniCRM لتفعيل التغييرات:

cd OmniCRM-API
sudo systemctl restart omnicrm-api

مزامنة جهات الاتصال​

يتم مزامنة جميع جهات اتصال العملاء في OmniCRM تلقائيًا مع Mailjet.

ما الذي يتم مزامنته:

  • اسم جهة الاتصال
  • عنوان البريد الإلكتروني
  • نوع جهة الاتصال (فواتير، تقنية، إلخ.)
  • موقع العميل
  • حقول مخصصة

تكرار المزامنة:

تتم مزامنة جهات الاتصال في الوقت الحقيقي عندما:

  • يتم إنشاء عميل جديد
  • يتم إضافة/تحديث جهة الاتصال
  • يتم تعديل تفاصيل العميل

استكشاف الأخطاء وإصلاحها​

البريد الإلكتروني لا يُرسل

  • السبب: بيانات اعتماد API غير صحيحة، حساب Mailjet معلق، أو معرف القالب خاطئ
  • الإصلاح:
    • تحقق من api_key و api_secret في crm_config.yaml
    • تحقق من حالة حساب Mailjet والفوترة
    • تحقق من وجود معرف القالب في Mailjet
    • تحقق من سجلات API للخطأ

متغيرات القالب لا تستبدل

  • السبب: عدم تطابق اسم المتغير أو بيانات مفقودة في OmniCRM
  • الإصلاح:
    • تحقق من أن أسماء المتغيرات تتطابق تمامًا (حساسة لحالة الأحرف)
    • استخدم تنسيق {{ var:variable_name }}
    • تحقق من أن OmniCRM تمرر بيانات المتغير في استدعاء API
    • اختبر باستخدام بيانات عينة في Mailjet

PDF الفاتورة لا يُرفق

  • السبب: فشل في إنشاء PDF أو حجم الملف كبير جدًا
  • الإصلاح:
    • تحقق من سجلات إنشاء الفاتورة
    • تحقق من أن قالب الفاتورة يتم عرضه بشكل صحيح
    • تأكد من أن PDF أقل من 15 ميغا��ايت (حد Mailjet)
    • اختبر إنشاء PDF الفاتورة بشكل منفصل

جهات الاتصال لا تتم مزامنتها مع Mailjet

  • السبب: تجاوز حد معدل API أو خدمة المزامنة غير قيد التشغيل
  • الإصلاح:
    • تحقق من حدود معدل API لـ Mailjet (200 مكالمة/دقيقة)
    • تحقق من أن خدمة OmniCRM-API قيد التشغيل
    • راجع سجلات المزامنة للخطأ
    • قم بتفعيل المزامنة يدويًا للاختبار

الوثائق ذات الصلة​

  • administration_configuration - مرجع تكوين Mailjet الكامل
  • payments_invoices - إنشاء الفواتير وتسليم البريد الإلكتروني
  • authentication_flows - إعادة تعيين كلمة المرور ورسائل التحقق
  • customer_care - رسائل الترحيب في بوابة الخدمة الذاتية

قراءة إضافية​