ما الذي تغير في Chatwoot Cloud في يوليو 2026
في يوليو 2026، نشر فريق Chatwoot تحديثاً لسياسة الخطة المجانية. وفقاً للمنشورات المرتبطة، انتقلت الميزات التالية إلى الخطط المدفوعة:
- الوصول إلى الـ REST API: جميع مسارات /api/v1/profile و/api/v1/accounts/{id}/conversations والجهات والتسميات وجميع نقاط نهاية الإدارة تُعيد الآن HTTP 401 لحسابات الخطة المجانية.
- الـ webhooks الصادرة: أحداث conversation_created وmessage_created وconversation_status_changed وغيرها لم تعد تُرسَل إلى الـ URL المُكوَّنة.
- تكاملات الطرف الثالث: أي سير عمل في n8n أو Activepieces أو Zapier أو Make يعتمد على رمز مميز لـ API Chatwoot Cloud يتوقف عن العمل دون إشعار مسبق مرئي في لوحة التحكم.
ما الذي يُحجب في خطة Chatwoot Cloud المجانية
- استدعاءات الـ REST API: جميع مسارات
/api/v1/…تُعيد HTTP 401 للرموز المميزة الصادرة عن حساب على الخطة المجانية - الـ webhooks الصادرة: أحداث المحادثة والرسائل لم تعد تُرسَل إلى الـ URL المُكوَّنة
- تكاملات n8n: عقد Chatwoot واستدعاءات HTTP المباشرة إلى الـ API السحابي تفشل بصمت أو تُعيد خطأ مصادقة
- تكاملات Activepieces: أي مُشغّل أو إجراء يستهلك رمز API Chatwoot Cloud معطل
- مزامنة نظام إدارة علاقات العملاء: الموصلات التي ترفع محادثات Chatwoot إلى نظام إدارة علاقات العملاء عبر الـ API مقطوعة
- التقارير الآلية: النصوص البرمجية التي تُجمّع إحصائيات الدعم عبر الـ API لم تعد قادرة على المصادقة
الخطة المجانية على السحابة مقابل الاستضافة الذاتية: جدول مقارنة
مرّر الجدول أفقيًا
| المعيار | السحابة المجانية | الاستضافة الذاتية |
|---|---|---|
| الوصول إلى الـ REST API | محجوب منذ يوليو 2026 | كامل وغير مقيّد |
| الـ webhooks الصادرة | معطلة | قابلة للتكوين بحرية |
| عدد الوكلاء | محدود (2 في الخطة المجانية) | غير محدود (حسب مواردك) |
| التكلفة الشهرية | مجانية لكن بدون API | تكلفة الـ VPS فقط — لا رسوم برمجية إضافية |
| البيانات والامتثال | البيانات مستضافة لدى Chatwoot Inc. | البيانات تحت سيطرتك على خوادمك |
| التحديثات | تُدار بواسطة Chatwoot | تحت مسؤوليتك (docker pull) |
| تكاملات n8n / Activepieces | مستحيلة على الخطة المجانية | تعمل منذ النشر |
تصدير بياناتك من Chatwoot Cloud
قبل إغلاق حسابك السحابي، صدّر جميع البيانات المفيدة. يوفر Chatwoot مسارين للتصدير من لوحة التحكم.
إجراء التصدير من Chatwoot Cloud
تصدير جهات الاتصال
في لوحة تحكم Chatwoot Cloud، انتقل إلى جهات الاتصال ← أيقونة التنزيل (أعلى اليمين). يُنشئ Chatwoot ملف CSV يحتوي على الاسم الأول والاسم الأخير والبريد الإلكتروني والهاتف والتسميات لكل جهة اتصال. احتفظ بهذا الملف — سيُستخدم للاستيراد في نسختك المُستضافة ذاتياً.
تصدير المحادثات عبر الـ API (إذا كانت خطتك لا تزال تسمح بذلك)
إذا كان لديك وصول إلى الـ API أو كنت على خطة مدفوعة في طور الإلغاء، صدّر المحادثات بالأمر:
curl -H "api_access_token: <YOUR_TOKEN>" \ "https://app.chatwoot.com/api/v1/accounts/<ACCOUNT_ID>/conversations" \ -o conversations-export.jsonاستبدل
<YOUR_TOKEN>و<ACCOUNT_ID>بقيمك الخاصة. كرر الأمر مع ?page=2و?page=3… حتى تحصل على مصفوفة فارغة.تنزيل المرفقات
الملفات المرفقة بالمحادثات تُقدَّم من شبكة توصيل المحتوى لـ Chatwoot Cloud. لاحظ عناوين URL من نوع
https://app.chatwoot.com/rails/active_storage/…الموجودة في ملف JSON المُصدَّر. يمكن لنص برمجي بـ wgetأو curlتنزيلها بالجملة إذا كانت حصة وصولك لا تزال تسمح بذلك.تصدير ملفات تعريف الوكلاء
في الإعدادات ← الوكلاء، سجّل عنوان البريد الإلكتروني لكل وكيل. ستحتاجه لإعادة إنشاء الحسابات في نسختك المُستضافة ذاتياً. التصدير بصيغة CSV متاح من نفس الصفحة.
تصدير صناديق الوارد وإعداداتها
في الإعدادات ← صناديق الوارد، وثّق كل تكوين: نوع القناة (بريد إلكتروني، أداة ويب، واتساب للأعمال، إلخ)، إعدادات SMTP، مفاتيح API للقناة. هذه البيانات غير قابلة للتصدير تلقائياً — يكفي أخذ لقطة شاشة أو نسخ المعلومات.
تصدير التسميات والردود الجاهزة
في الإعدادات ← التسميات والردود الجاهزة، صدّر الإدخالات أو انسخها. الردود الجاهزة غير قابلة للتصدير بصيغة CSV بشكل مدمج — انسخها يدوياً أو عبر الـ API إذا كان لديك وصول:
GET /api/v1/accounts/<ID>/canned_responses.أرشفة حسابك السحابي
بمجرد استرداد البيانات، يمكنك إلغاء تنشيط حساب Chatwoot Cloud من إعدادات الحساب ← المنطقة الخطرة ← حذف الحساب. هذا الإجراء لا رجعة فيه.
نشر Chatwoot مُستضافاً ذاتياً على VPS من ServOrbit
يتم نشر Chatwoot عبر Docker Compose. الاعتراض المعتاد — «الاستضافة الذاتية معقدة للصيانة» — يُعالجه المتجر في ServOrbit: قالب Chatwoot يُكوّن Docker وnginx وTLS في عملية واحدة. تحتفظ بصلاحية root والـ API الكاملة.
النشر من متجر ServOrbit
اختيار الـ VPS المناسب
يحتاج Chatwoot إلى 2 vCPU و4 جيجابايت من الذاكرة كحد أدنى للاستخدام اليومي (عدد قليل من الوكلاء وبضع مئات من المحادثات النشطة). لفريق مؤلف من 10 وكلاء أو أكثر، خطط لـ 4 vCPU / 8 جيجابايت. قاعدة بيانات PostgreSQL هي المكوّن الأكثر استهلاكاً للذاكرة.
في منطقة عملاء ServOrbit، اختر VPS بهذه المواصفات واختر Ubuntu 22.04 أو Debian 12 كصورة أساسية.
تفعيل قالب Chatwoot من المتجر
في منطقة عملاء ServOrbit، انتقل إلى المتجر ← التعاون ← Chatwoot (أو استخدم الرابط المباشر /marketplace/collaboration/chatwoot). اختر الـ VPS المستهدف وابدأ النشر. يُثبّت القالب Docker وDocker Compose وnginx وCertbot، ثم يُكوّن Chatwoot عبر
docker-compose.yml.تكوين متغيرات البيئة
بعد النشر، اتصل بـ VPS عبر SSH وعدّل ملف
.envالمُنشأ في /opt/chatwoot/:SECRET_KEY_BASE=<generate with openssl rand -hex 64> FRONTEND_URL=https://chat.your-domain.com DEFAULT_LOCALE=ar [email protected] SMTP_ADDRESS=<your-smtp> SMTP_USERNAME=<login> SMTP_PASSWORD=<password>أعد تشغيل الحاويات:
docker compose down && docker compose up -d.توجيه نطاقك وتفعيل TLS
في Cloudflare (أو مدير DNS الخاص بك)، أضف سجل A لـ
chat.your-domain.comيشير إلى IP الخاص بـ VPS. يتضمن قالب nginx تكوين Certbot: نفّذ certbot --nginx -d chat.your-domain.comللحصول على شهادة Let's Encrypt وتجديدها تلقائياً.إنشاء حساب المسؤول الأول
انتقل إلى
https://chat.your-domain.comواتبع معالج الإعداد الأولي. أنشئ حساب المسؤول، ثم استورد الوكلاء عبر الإعدادات ← الوكلاء ← دعوة وكلاء. استخدم عناوين البريد الإلكتروني المُصدَّرة في الخطوة السابقة.استيراد جهات الاتصال
في جهات الاتصال ← استيراد، حمّل ملف CSV المُصدَّر من Chatwoot Cloud. يتعرف Chatwoot على أعمدة
nameوemailوphone_numberوidentifier. يتم اكتشاف التكرارات عند الاستيراد.
استعادة تكامل n8n أو Activepieces
بمجرد أن تصبح نسختك المُستضافة ذاتياً جاهزة، تتوفر رموز API المميزة دون قيود. إليك كيفية إعادة تكوين سير عمل n8n الذي يستعلم Chatwoot.
مثال — سير عمل n8n مع API Chatwoot المُستضاف ذاتياً
إنشاء رمز API مميز على نسختك
في Chatwoot المُستضاف ذاتياً، انتقل إلى إعدادات الملف الشخصي ← الوصول إلى الـ API. انسخ الرمز المميز المُنشأ. هذا الرمز لا تنتهي صلاحيته ويمنح وصولاً كاملاً إلى جميع مسارات REST على نسختك.
تكوين بيانات اعتماد Chatwoot في n8n
في n8n، أضف بيانات اعتماد من نوع Chatwoot API. أدخل:
- الـ URL الأساسي: https://chat.your-domain.com
- رمز الوصول: الرمز المميز المنسوخ في الخطوة السابقةتحقق من الاتصال — يجب أن يستجيب n8n بـ HTTP 200 وملف تعريف حسابك.
إعادة تكوين مُشغّلات الـ webhook
في Chatwoot المُستضاف ذاتياً، انتقل إلى الإعدادات ← التكاملات ← الـ Webhooks وأضف URL الـ webhook الخاص بـ n8n (بالشكل
https://n8n.your-domain.com/webhook/<uuid>). ضع علامة على الأحداث المراد الاستماع إليها: conversation_createdوmessage_createdوconversation_status_changed.شغّل محادثة اختبارية وتحقق في n8n من أن التنفيذ قد استُقبل.
تكييف سير عمل Activepieces
تتوفر في Activepieces موصّل Chatwoot أصلي. في لوحة تحكم Activepieces، عدّل كل تدفق كان يستخدم Chatwoot Cloud وحدّث الاتصال: استبدل
app.chatwoot.comبـ chat.your-domain.comوأعد إنشاء بيانات الاعتماد بالرمز الجديد. مُشغّلات الـ webhook تتبع نفس الإجراء الخاص بـ n8n.
مراقبة نسختك بعد الانتقال
بعد الانتقال، كوّن مسباراً بسيطاً لـ HTTP على نسختك: يكشف Chatwoot نقطة نهاية للتحقق من الصحة على https://chat.your-domain.com/auth/sign_in (HTTP 200 متوقع). أداة مثل Uptime Kuma أو Gatus، القابلة للنشر أيضاً من متجر ServOrbit، يمكنها مراقبة هذا الـ URL وتنبيهك في حالة تعطل.
راقب أيضاً مساحة القرص: المرفقات والصور الرمزية مخزّنة في docker volume chatwoot_storage. لفريق نشط، خطط لمسح المحادثات القديمة أو أرشفتها بانتظام.
استكشاف الأخطاء وإصلاحها — الأخطاء الشائعة بعد الانتقال
إليك أكثر خمسة أخطاء شيوعاً عند الانتقال من Chatwoot Cloud إلى الاستضافة الذاتية، وكيفية حلها.
الأخطاء الشائعة والحلول
- HTTP 401 على الـ API: الرمز المميز تم إنشاؤه على النسخة السحابية القديمة. أعد إنشاء رمز مميز من الملف الشخصي ← الوصول إلى الـ API على نسختك المُستضافة ذاتياً وحدّث جميع بيانات اعتماد n8n / Activepieces.
- HTTP 422 عند إنشاء محادثة: صندوق الوارد المستهدف غير موجود بعد في النسخة المُستضافة ذاتياً. أعد إنشاء صناديق الوارد في الإعدادات ← صناديق الوارد قبل استيراد المحادثات.
- عدم استقبال الـ webhook: تحقق من أن URL الـ webhook الخاص بـ n8n أو Activepieces يمكن الوصول إليه من VPS الخاص بك (
curl -I <webhook-url>). إذا كان n8n خلف وكيل عكسي، فتأكد من أن المنفذ 443 مفتوح وأن شهادة TLS صالحة. - خطأ SMTP عند البدء: إذا لم يتمكن Chatwoot من إرسال رسائل التأكيد عبر البريد الإلكتروني، تحقق من متغيرات
SMTP_ADDRESSوSMTP_PORT(587 لـ STARTTLS، 465 لـ SSL) وSMTP_AUTHENTICATIONفي .envالخاص بك. أعد تشغيل الحاويات بعد أي تعديل. - الواجهة باللغة الإنجليزية رغم تعيين
DEFAULT_LOCALE: متغير البيئة ينطبق على اللغة الافتراضية للحسابات الجديدة. يمكن لكل وكيل تغيير لغته في الملف الشخصي ← اللغة. لفرض لغة على جميع الحسابات الموجودة، حدّث عمود localeمباشرة في PostgreSQL عبر docker compose exec postgres psql -U chatwoot -c "UPDATE users SET locale='ar';"— احتفظ بنسخة احتياطية من قاعدة البيانات قبل أي تعديل مباشر.
استعادة السيطرة على دعم عملائك
أدى إزالة الـ API والـ webhooks من خطة Chatwoot Cloud المجانية في يوليو 2026 إلى تعطيل عشرات التكاملات في n8n وActivepieces وأنظمة CRM دون إشعار مرئي في لوحات التحكم. الاستضافة الذاتية ليست بديلاً منقوصاً: إنها النسخة غير المقيدة، مع صلاحية root وAPI كامل وwebhooks حرة وبيانات تحت سيطرتك.
الاعتراض الرئيسي — الصيانة — تعالجه خطة Chatwoot في متجر ServOrbit: Docker وnginx وTLS مُكوَّنة عند النشر. التحديثات تأتي بـ docker compose pull && docker compose up -d. على VPS بمواصفات 2 vCPU / 4 جيجابايت، تدعم نسخة Chatwoot المُستضافة ذاتياً عشرات الوكلاء المتزامنين بزمن استجابة لا يُمييزه المستخدم عن السحابة.
إذا كانت تكاملاتك في n8n أو Activepieces تستدعي API Chatwoot، فإن الانتقال هو المسار الوحيد المستدام: خطة Cloud المجانية لن تُعيد الوصول إلى API بشكلها الحالي.
