تتيح الواجهة الرسمية لوكلاء البرمجة قراءة المحادثات والبحث في مركز المساعدة وتجهيز أعمال الدعم من الطرفية. وتوجّههم المهارة المرفقة إلى انتظار موافقتك على أي إجراء يراه العملاء.
مفتوح المصدر · Chatwoot Cloud والاستضافة الذاتية
الوكيل لخّص المحادثات العاجلة. للقراءة فقط. لا تغيّر أي شيء.
● تحميل مهارة واجهة سطر أوامر Chatwoot وفحص قائمة المحادثات.
$ chatwoot convs --assignee all -s open -o json
{
"data": { "payload": [
{ "id": 8421, "priority": "urgent",
"status": "open", "inbox_id": 7 },
{ "id": 8398, "priority": "high",
"status": "open", "inbox_id": 3 }
] }
}
تمت قراءة القائمة
محادثتان تحتاجان إلى الاهتمام
التغييرات المنفذة
لا شيء
الملخص جاهز.
واجهة واحدة لأعمال دعم فعلية
تعيد الواجهة بيانات منظمة يستطيع وكيلك تحليلها. وعندما تكون الخطوة التالية ردا أو إسنادا أو تصنيفا أو إغلاقا، توجّه المهارة الرسمية الوكيل إلى عرض الأمر الدقيق عليك أولا.
ملخص قائمة المحادثات
لخّص المحادثات المفتوحة المسندة إليّ. جمّعها بحسب الاستعجال ولا تغيّر أي شيء في Chatwoot.
$ chatwoot convs --assignee me -s open -o jsonمخرجات منظمة ← ملخص الوكيل
القائمة المفتوحة: 12 محادثة
عاجلة: 2 · عالية: 3 · عادية: 7
#8421: استرداد متعثر بعد خصم مكرر
#8398: إعداد تسجيل دخول موحد لمؤسسة ينتظر منذ 18 ساعة
لم تُجرَ أي تغييرات.الفرز
اعثر على كل المحادثات المفتوحة العاجلة في جميع صناديق الوارد. أعِد المعرّفات وآخر رسائل العملاء. للقراءة فقط.
$ chatwoot convs --assignee all -s open -o json | jq '.data.payload[] | select(.priority == "urgent")'JSON مصفّى
{
"id": 8421,
"priority": "urgent",
"status": "open",
"inbox_id": 7
}البحث في المعرفة
ابحث في مركز المساعدة عن مقالات حول تغيير بريد الفوترة. أعطني النتيجة الأنسب مع رابطها العام.
$ chatwoot hc articles --query "بريد الفوترة" -o jsonنتيجة بحث مركز المساعدة
{
"title": "تحديث بيانات الفوترة",
"slug": "update-billing-details",
"category": "إعدادات الحساب",
"link": "https://support.example.com/..."
}إجراء يتطلب صلاحية
اقرأ المحادثة 8421 وصِغ ردا موجزا. اعرض أمر الرد الدقيق، لكن لا تنفّذه حتى أوافق.
$ chatwoot conv 8421 reply "عثرت على الخصم المكرر وطلبت من فريق الفوترة إلغاءه. سأطلعك على المستجدات هنا خلال يوم عمل واحد."نقطة التحقق من الموافقة
تم تجهيز رد مقترح يراه العميل.
لم يُنفّذ الأمر.
في انتظار موافقة صريحة للمحادثة #8421.Chatwoot لوكلاء البرمجة
يكون وكيل البرمجة مفيدا عندما يستطيع الوصول إلى سياق موثوق وعرض ما يفعله. وتوفر له واجهة Chatwoot الأمرين. بدلا من التنقل في لوحة التحكم أو استخلاص البيانات من جداول الطرفية، يستطيع الوكيل طلب مكتب الدعم ومحادثاته، وجهات اتصال إدارة علاقات العملاء، وصناديق الوارد والتصنيفات والفرق ومقالات مركز المساعدة بتنسيق متوقع.
إلى جانب واجهة سطر الأوامر، يقدم Chatwoot أيضا Captain، المساعد الذكي داخل المنتج، و روبوتات الدعم، التي تتيح ربط روبوتات مخصصة بصناديق الوارد. أما واجهة سطر الأوامر فهي لوكيل البرمجة الذي يعمل معك بالفعل في الطرفية: Codex أو Claude أو Cursor أو Grok أو أي أداة تنفّذ أوامر الصدفة.
اطلب القائمة المفتوحة أو محادثة بعينها أو كل رسالة تذكر استردادا. يستطيع الوكيل تلخيص النتائج وتجميع المشكلات المرتبطة وإرشادك إلى المحادثات التي تستحق فتحها في Chatwoot.
ابحث في مركز مساعدة Chatwoot قبل صياغة الرد. تستطيع الواجهة سرد البوابات والبحث في المقالات بعبارة أو تصنيف وجلب المقالة الكاملة ليستخدمها الوكيل كسياق.
المخرجات النصية مخصصة للأشخاص. ويمكن للوكلاء طلب JSON للتحليل، أو CSV للتصدير، أو الوضع الصامت عندما لا يحتاج مسار المعالجة سوى معرّفات الموارد. تعمل رموز الخروج والأخطاء كما في أدوات سطر الأوامر المعتادة.
لمهام الدعم الشائعة أوامر مخصصة. وعندما لا تغطي الواجهة نقطة نهاية بعد، يستطيع أمر API المباشر إرسال طلب موثّق إلى حساب Chatwoot المُعدّ. وتظل الطلبات غير GET بحاجة إلى الموافقة.
المساعد الذكي داخل Chatwoot. يجيب العملاء مباشرة اعتمادا على محتوى المساعدة لديك.
اربط روبوتك بأي صندوق وارد عبر Webhooks وواجهة API لروبوتات الدعم.
وكلاء برمجة في الطرفية يقرؤون قائمة المحادثات ويجهزون العمل لموافقتك.
كيف تعمل
تعلّم المهارة الرسمية وكيل البرمجة صياغة الأوامر وتنسيق المخرجات المنظمة، وقاعدة انتظار تأكيد صريح قبل تعديل البيانات المشتركة.
يكتشف المثبّت نظام التشغيل والبنية المعمارية، وينزّل الملف التنفيذي المناسب، ويتحقق من بصمته SHA256.
curl -fsSL https://chwt.app/install-cli | shأدخل عنوان Chatwoot الأساسي ومفتاح API ومعرّف الحساب. تتحقق الواجهة منها قبل حفظها، ويُخزّن مفتاح API في سلسلة مفاتيح النظام.
chatwoot auth loginثبّت المهارة الرسمية المرفقة ليتعرف وكيل البرمجة على صياغة الأوامر وتنسيقات المخرجات وقواعد الموافقة على التعديل.
npx skills add chatwoot/cliدع الوكيل يقرأ ويلخّص بحرية. وللردود والإسناد والتصنيفات والأولويات والحالات واستدعاءات API التي تعدّل البيانات، راجع الأمر الدقيق وأكّده أولا.
مصممة للوكلاء، والقرار للبشر.
يمكن للوكيل فحص القائمة وتجهيز خطة بنفسه. وتوجّهه المهارة الرسمية إلى التوقف وطلب موافقتك قبل تغيير بيانات الدعم المشتركة أو إرسال رسالة.
اقرأ بحرية
أكّد قبل التعديل
CHATWOOT_API_KEY لبيئات التكامل المستمر والبيئات دون واجهة تفاعلية.chatwoot api المباشر إجراء طلب موثّق ضمن الحساب المُعدّ.البدء السريع
ثبّت الإصدار وسجّل الدخول إلى حساب Chatwoot، ثم أضف المهارة الرسمية ليتعرف وكيلك على الأوامر وقواعد الأمان.
1: التثبيت
$ curl -fsSL https://chwt.app/install-cli | sh
2: الاتصال
$ chatwoot auth login
3: علّم وكيلك
$ npx skills add chatwoot/cli
✓ تم التحقق من بيانات الاعتماد
✓ حُفظ مفتاح API في سلسلة مفاتيح نظام التشغيل
✓ مهارة الوكيل جاهزة
جديد على Chatwoot؟
Chatwoot هو منصة دعم العملاء مفتوحة المصدر التي تعمل الواجهة معها: صندوق وارد متعدد القنوات ومركز مساعدة وCaptain AI. إذا كان فريقك يعمل مع وكيل برمجة، فيمكنه فرز المحادثات والبحث عن الإجابات المنشورة وصياغة الردود لموافقتك من اليوم الأول، على Chatwoot Cloud أو الاستضافة الذاتية.
وأي وكيل آخر يستطيع تنفيذ أوامر الصدفة.
إجابات عن أسئلتك
التفاصيل العملية قبل منح وكيل وصولا إلى حساب دعم حقيقي.
واجهة سطر أوامر Chatwoot هي الواجهة الرسمية مفتوحة المصدر للمنصة. تتيح للأشخاص والبرامج النصية ووكلاء البرمجة قراءة بيانات الدعم وتنفيذ سير عمل المحادثات الشائع من الطرفية.
تغطي ثلاثة استخدامات مختلفة. Captain هو مساعد Chatwoot الذكي داخل المنتج، ويجيب العملاء من محتوى المساعدة. تربط روبوتات الدعم روبوتا مخصصا بصناديق الوارد عبر API المخصصة لها. أما واجهة سطر أوامر Chatwoot فهي لوكلاء البرمجة في الطرفية، الذين يقرؤون بيانات الدعم ويجهزون العمل لموافقتك.
يمكن لأي وكيل ينفّذ أوامر الصدفة استخدام الواجهة، بما في ذلك Claude Code وCodex وCursor وGitHub Copilot وGemini CLI وGrok وWindsurf. صُممت مهارة Chatwoot المرفقة لبيئات الوكلاء التي تدعم تثبيت المهارات أو تعليمات المشاريع.
نعم. تقدم عند تسجيل الدخول عنوان Chatwoot الأساسي ومفتاح API ومعرّف الحساب. وهذا يتيح للواجهة نفسها الاتصال بـChatwoot Cloud أو تثبيت ذاتي الاستضافة.
تدعم الواجهة الردود والملاحظات الخاصة والإسناد والتصنيفات والأولويات وتغيير الحالة. تتعامل المهارة الرسمية معها كتعديلات تتطلب صلاحية: على الوكيل عرض الأمر الدقيق وانتظار موافقة صريحة قبل تنفيذه.
يخزّن تسجيل الدخول التفاعلي مفتاح API في سلسلة مفاتيح نظام التشغيل. وتُحفظ الإعدادات غير السرية في ملف إعدادات واجهة Chatwoot. ويمكن لبيئات التكامل المستمر والبيئات دون واجهة تفاعلية توفير CHATWOOT_API_KEY بدلا من ذلك.
نعم. استخدم JSON عندما تحتاج الشيفرة إلى الاستجابة الكاملة، أو CSV لتصدير الجداول، أو الوضع الصامت للحصول على معرّف في كل سطر. ويتوفر أمر API المباشر عندما لا يملك سير العمل أمرا مخصصا بعد.
الواجهة الرسمية لوكلاء البرمجة