Hamnivo GitHub

اوپن سورس · MIT لائسنس · سیلف ہوسٹڈ

کسٹمر چیٹ، جہاں لوگ اور اے آئی مل کر کام کرتے ہیں

Hamnivo ایک اوپن سورس کسٹمر گفتگو پلیٹ فارم ہے۔ اسے ایک اسکرپٹ سے اپنی ویب سائٹ پر لگائیں، یا اس کے API پر اپنا انٹرفیس بنائیں۔ گاہک، آپ کا عملہ اور اے آئی ایجنٹ ایک ہی گفتگو میں شریک ہوتے ہیں، آپ کے اپنے سرورز پر۔

Hamnivo پر ابھی تیزی سے کام جاری ہے۔ جو فیچرز ابھی تیار نہیں، ان پر «جلد آ رہا ہے» لکھا ہے۔ دیکھیں کہ آج کیا کام کرتا ہے

کسٹمر کارڈ اور Hamnivo نشان کے درمیان ایک چیٹ ونڈو، جنہیں گہرے اور مرجانی رنگ کا بہتا ہوا ربن جوڑتا ہے۔

ٹیم ورک

لوگ اور اے آئی، ایک ہی گفتگو میں

گاہک، آپ کا عملہ اور اے آئی ایجنٹ ایک ہی گفتگو میں بات کرتے ہیں۔ اے آئی پہلے جواب دے سکتا ہے، اور آپ کی ٹیم کا کوئی بھی فرد کسی بھی وقت شامل ہو سکتا ہے۔

  • گاہک کسی بھی وقت کسی شخص سے بات کرنے کو کہہ سکتا ہے۔ آپ کی ٹیم کو ایک نجی ہینڈ آف نوٹ ملتا ہے، تاکہ گاہک کو اپنی بات دہرانی نہ پڑے۔
  • عملہ اُس Chatwoot ان باکس سے جواب دیتا ہے جس سے Hamnivo جڑا ہے۔ جب کوئی شخص گفتگو سنبھالتا ہے تو اے آئی رک جاتا ہے، اور جو جواب وہ لکھ رہا تھا وہ نہیں بھیجے جاتے۔
  • ہر پیغام بتاتا ہے کہ اسے کس نے لکھا: اے آئی اسسٹنٹ نے یا سپورٹ ایجنٹ نے۔ اے آئی کبھی انسان ہونے کا دکھاوا نہیں کرتا۔
  • جلد آ رہا ہے اپنی پسند کا اے آئی ماڈل جوڑنا۔ ابھی اے آئی کے جواب ایک بلٹ اِن ٹیسٹ ماڈل سے آتے ہیں۔
  • جلد آ رہا ہے آپ کی ٹیم کے لیے Hamnivo ورک اسپیس، نجی نوٹس اور ماہر اے آئی ایجنٹس کے ساتھ جنہیں آپ بلا سکتے ہیں۔
درمیان میں منظور شدہ جواب کے ساتھ ایک شخص کا کارڈ، جس کے دونوں طرف مشترکہ مرجانی دائرے پر Hamnivo AI کے دو پینل ہیں۔

یادداشت

رضامندی کے ساتھ یادداشت جلد آ رہا ہے

Hamnivo کام کی باتیں یاد رکھے گا، جیسے گاہک کی پسندیدہ زبان، مگر صرف وہیں جہاں آپ اجازت دیں۔ لوگ دیکھ سکیں گے کہ اسے کیا یاد ہے، اسے درست کر سکیں گے اور مٹا سکیں گے۔

  • دائرہ آپ طے کرتے ہیں: ایک گفتگو، ایک گاہک یا ایک ٹیم۔
  • یاد رکھی گئی ہر بات کے ساتھ اس کا ماخذ اور تاریخ رہتی ہے۔ درستی پرانی معلومات کی جگہ لے لیتی ہے۔
  • پچھلی گفتگو سے سیکھنے کے لیے الگ رضامندی درکار ہے۔
دستاویزی کارڈز کی ایک آرکائیو ٹرے جنہیں مرجانی ٹائم لائن جوڑتی ہے؛ ایک کارڈ اپ ڈیٹ ہو رہا ہے اور آخری کارڈ تصدیق شدہ ہے۔

ڈویلپرز

ڈویلپرز کے لیے بنایا گیا

Hamnivo کا مرکز اس کا API ہے۔ چیٹ ویجٹ، SDK اور آپ کا اپنا کوڈ، سب ایک ہی عوامی API استعمال کرتے ہیں۔

  • ایک script ٹیگ آپ کی ویب سائٹ پر چیٹ لگا دیتا ہے۔ چیٹ تبھی لوڈ ہوتی ہے جب وزیٹر اسے کھولتا ہے۔
  • OpenAPI 3.1 میں بیان کیا گیا REST API، اور آپ کے اپنے سرور پر ایک انٹرایکٹو حوالہ۔
  • اپنا چیٹ انٹرفیس بنانے کے لیے JavaScript اور TypeScript SDK۔
  • لائیو اپ ڈیٹس، جو کنکشن ٹوٹنے کے بعد بھی جاری رہتی ہیں۔
  • جلد آ رہا ہے ویب ہُکس، تاکہ آپ کے اپنے سسٹم گفتگو پر ردعمل دے سکیں۔
ایک مرکزی Hamnivo حب جو مرجانی کیبلز کے ذریعے ویب سائٹ، موبائل ایپ، API کوڈ بلاک اور سرور سے جڑا ہے۔

زبانیں

ہر وہ زبان جس میں آپ کے گاہک بات کرتے ہیں

لوگ اسی زبان میں لکھتے ہیں جس میں وہ سوچتے ہیں، اور بہت سے لوگ دو زبانیں ملا کر لکھتے ہیں۔ Hamnivo شروع سے اسی کے لیے بنایا گیا ہے۔

  • چیٹ ویجٹ انگریزی، عربی، ہندی اور اردو میں کام کرتا ہے۔
  • عربی اور اردو دائیں سے بائیں پڑھی جاتی ہیں، جبکہ آرڈر نمبر اور کوڈ اپنی سمت برقرار رکھتے ہیں۔
  • جلد آ رہا ہے ہنگلش اور رومن اردو کو ویسے ہی سمجھنا جیسے لوگ واقعی لکھتے ہیں۔
  • جلد آ رہا ہے ہر اصل پیغام کے ساتھ اس کا ترجمہ، گاہکوں اور عملے دونوں کے لیے۔

ویجٹ کی عربی، ہندی اور اردو عبارت کا جائزہ ابھی اہلِ زبان نے نہیں لیا۔

Hamnivo حب کے گرد چار مکالماتی غبارے — Hello، مرحبا، نمستے اور سلام — جنہیں مرجانی دائرہ جوڑتا ہے۔

کامرس

چیٹ کے اندر ہی چیک آؤٹ جلد آ رہا ہے

گاہک گفتگو چھوڑے بغیر پروڈکٹ چن سکیں گے، کل رقم دیکھ سکیں گے اور ادائیگی کر سکیں گے۔

  • گاہک کی تصدیق کے بغیر کچھ نہیں خریدا جاتا۔
  • استثنائی معاملات کی منظوری عملہ دیتا ہے، جیسے آپ کی پالیسی سے باہر رقم کی واپسی۔
  • قیمتیں اور کل رقم آپ کے اسٹور سے آتی ہیں، اے آئی سے نہیں۔
  • آرڈر تبھی ادا شدہ مانا جاتا ہے جب آپ کا پیمنٹ فراہم کنندہ اس کی تصدیق کرے۔
آرڈر خلاصہ کارڈ، مرجانی 'اگلا' مرحلہ، ایک پیک شدہ پارسل اور منظوری کا نشان دکھاتا فون۔

ڈیمو

اسے کام کرتے دیکھیں

سائٹ کی یہ کاپی کسی لائیو چیٹ سے جڑی نہیں ہے۔ نیچے دیے گئے مراحل سے Hamnivo خود چلائیں، پھر یہ اسکرپٹ کسی بھی ویب صفحے میں شامل کریں۔

اپنی ویجٹ ID اور اپنے چیٹ اور API سرورز کے پتے استعمال کریں۔

ویب صفحے پر چیٹ کیسے لگائیں

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

سیلف ہوسٹنگ

اسے خود ہوسٹ کریں

Hamnivo آپ کے اپنے سرور پر چلتا ہے۔ یہ چار مراحل اسے ڈویلپمنٹ اور ٹیسٹنگ کے لیے ایک مشین پر شروع کرتے ہیں۔

  1. سرور تیار کریں

    Docker، Node.js 24 اور pnpm 10 کے ساتھ Linux استعمال کریں۔ ڈویلپمنٹ کے لیے 2 CPU کور، 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 اور API شروع کریں۔ پھر دوسرے ٹرمینل میں pnpm worker چلائیں۔

    ٹرمینل
    pnpm services:up
    pnpm db:migrate
    pnpm chatwoot:up
    pnpm api

سیلف ہوسٹنگ کی مکمل گائیڈ پڑھیں

خودکار HTTPS کے ساتھ پروڈکشن سیٹ اپ جلد آ رہا ہے۔