Hamnivo GitHub

مفتوح المصدر · رخصة MIT · استضافة ذاتية

محادثة عملاء يعمل فيها الناس والذكاء الاصطناعي معًا

Hamnivo منصة مفتوحة المصدر لمحادثات العملاء. أضفها إلى موقعك بنص برمجي واحد، أو ابنِ واجهتك الخاصة على واجهتها البرمجية. يتشارك العملاء وموظفوك ووكلاء الذكاء الاصطناعي محادثة واحدة، على خوادم تديرها أنت.

ما زال Hamnivo قيد التطوير النشط. الميزات غير الجاهزة بعد عليها علامة «قريبًا». اطّلع على ما يعمل اليوم

نافذة محادثة بين بطاقة عميل وشعار Hamnivo، يربط بينها شريط متدفق باللونين الداكن والمرجاني.

العمل الجماعي

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

يتحدث العملاء وموظفوك ووكلاء الذكاء الاصطناعي في المحادثة نفسها. يمكن للذكاء الاصطناعي أن يرد أولًا، ويمكن لأحد أفراد فريقك أن يتدخل في أي لحظة.

  • يمكن للعميل أن يطلب التحدث إلى شخص في أي وقت. ويحصل فريقك على ملاحظة تسليم خاصة، فلا يضطر العميل إلى تكرار كلامه.
  • يرد الموظفون من صندوق وارد Chatwoot الذي يتصل به Hamnivo. وعندما يتولى شخص المحادثة يتوقف الذكاء الاصطناعي، ولا تُرسَل الردود التي كان يكتبها.
  • كل رسالة تُظهر من كتبها: المساعد الذكي أو موظف الدعم. ولا يتظاهر الذكاء الاصطناعي أبدًا بأنه إنسان.
  • قريبًا ربط نموذج الذكاء الاصطناعي الذي تختاره. حاليًا تأتي ردود الذكاء الاصطناعي من نموذج تجريبي مدمج.
  • قريبًا مساحة عمل Hamnivo لفريقك، مع ملاحظات خاصة ووكلاء ذكاء اصطناعي متخصصين يمكنك دعوتهم.
بطاقة شخص في المنتصف مع رد معتمد، وعلى جانبيها لوحتان للذكاء الاصطناعي من Hamnivo على حلقة مرجانية مشتركة.

الذاكرة

ذاكرة بموافقتك قريبًا

سيتذكر Hamnivo التفاصيل المفيدة، مثل اللغة التي يفضّلها العميل، في الحدود التي تسمح بها فقط. وسيتمكن الناس من رؤية ما يتذكره وتصحيحه وحذفه.

  • أنت تحدد النطاق: محادثة واحدة أو عميل واحد أو فريق واحد.
  • تحتفظ كل معلومة محفوظة بمصدرها وتاريخها، ويحلّ التصحيح محلّ المعلومة القديمة.
  • التعلّم من المحادثات السابقة يحتاج إلى موافقة منفصلة.
درج أرشيف لبطاقات مستندات يربطها خط زمني مرجاني؛ إحدى البطاقات قيد التحديث والأخيرة موثّقة.

المطوّرون

مصمَّم للمطوّرين

بُني Hamnivo حول واجهته البرمجية. أداة المحادثة وحزمة SDK وشيفرتك الخاصة تستخدم كلها الواجهة البرمجية العامة نفسها.

  • يضيف وسم script واحد المحادثة إلى موقعك. ولا تُحمَّل المحادثة نفسها إلا عندما يفتحها الزائر.
  • واجهة REST برمجية موصوفة بمعيار OpenAPI 3.1، مع مرجع تفاعلي على خادمك.
  • حزمة SDK بلغتَي JavaScript وTypeScript لبناء واجهة محادثة خاصة بك.
  • تحديثات مباشرة تستمر بعد انقطاع الاتصال.
  • قريبًا خطافات ويب (Webhooks) لتتفاعل أنظمتك مع المحادثات.
مركز Hamnivo متصل بكابلات مرجانية بموقع ويب وتطبيق جوال وكتلة شيفرة لواجهة برمجة التطبيقات وخادم.

اللغات

كل لغة يستخدمها عملاؤك

يكتب الناس باللغة التي يفكرون بها، وكثير منهم يمزج لغتين. صُمّم Hamnivo لذلك منذ البداية.

  • تعمل أداة المحادثة بالإنجليزية والعربية والهندية والأردية.
  • تُقرأ العربية والأردية من اليمين إلى اليسار، بينما تحافظ أرقام الطلبات والرموز على اتجاهها.
  • قريبًا فهم الهنغليزية (مزيج الهندية والإنجليزية) والأردية المكتوبة بحروف لاتينية، كما يكتبها الناس فعلًا.
  • قريبًا ترجمة بجانب كل رسالة أصلية، للعملاء والموظفين.

لم يراجع متحدثون أصليون بعدُ نصوص أداة المحادثة بالعربية والهندية والأردية.

أربع فقاعات حوار بالتحيات Hello ومرحبا ونमस्ते وسلام حول مركز Hamnivo، تربطها حلقة مرجانية.

التجارة

الدفع داخل المحادثة قريبًا

سيتمكن العملاء من اختيار منتج ومعرفة المبلغ الإجمالي والدفع دون مغادرة المحادثة.

  • لا تتم أي عملية شراء قبل أن يؤكدها العميل.
  • يوافق الموظفون على الاستثناءات، مثل استرداد مبلغ خارج سياستك.
  • تأتي الأسعار والمبالغ الإجمالية من متجرك، لا من الذكاء الاصطناعي.
  • لا يُعدّ الطلب مدفوعًا إلا بعد أن يؤكد ذلك مزوّد الدفع لديك.
بطاقة ملخص طلب، وخطوة تالية باللون المرجاني، وطرد مغلّف، وهاتف يعرض علامة موافقة.

تجربة

شاهده وهو يعمل

هذه النسخة من الموقع غير متصلة بمحادثة حية. شغّل Hamnivo بنفسك باتباع الخطوات أدناه، ثم أضف هذا النص البرمجي إلى أي صفحة ويب.

استخدم معرّف الأداة الخاص بك وعنوانَي خادم المحادثة وخادم الواجهة البرمجية لديك.

كيف تضع المحادثة على صفحة ويب

HTML
<script
  src="https://chat.example.com/loader.js"
  data-widget-id="wid_…"
  data-api="https://api.example.com"
  async
></script>

الاستضافة الذاتية

استضفه بنفسك

يعمل Hamnivo على خادمك الخاص. هذه الخطوات الأربع تشغّله على جهاز واحد للتطوير والاختبار.

  1. جهّز خادمًا

    استخدم Linux مع Docker وNode.js 24 وpnpm 10. للتطوير تحتاج إلى معالج بنواتين، و6 GB من الذاكرة، و25 GB من مساحة القرص.

    الطرفية
    docker --version
    node --version
    pnpm --version
  2. احصل على الشيفرة

    استنسخ المستودع وثبّت الحزم التي يحتاجها.

    الطرفية
    git clone https://github.com/CodeWithJuber/Hamnivo.git
    cd Hamnivo
    pnpm install
  3. أنشئ المفاتيح السرية

    يكتب هذا الأمر الملف .env.local بكلمات مرور ومفاتيح مولَّدة. أبقِ الملف سريًّا واحتفظ بنسخة احتياطية منه.

    الطرفية
    bash scripts/setup/env.sh
  4. شغّل الخدمات

    شغّل قاعدة البيانات وChatwoot والواجهة البرمجية. ثم شغّل pnpm worker في طرفية ثانية.

    الطرفية
    pnpm services:up
    pnpm db:migrate
    pnpm chatwoot:up
    pnpm api

اقرأ دليل الاستضافة الذاتية كاملًا

إعداد للإنتاج مع HTTPS تلقائي قادم قريبًا.