Yuva

Yuvaは、複数のプロダクトを運営するチーム向けのオープンソースの顧客メッセージングツールです。すべてのプロダクトからのサポートメール、ライブチャット、アプリ内メッセージ、フィードバックが、ひとつの共有受信箱に届きます。同じ場所から配信・公開するニュースレター、ヘルプセンター、ステータスページ、分析情報もまとめて管理できます。

セルフホストで利用できます。必要なのは、ひとつのDockerイメージとPostgresだけです。

警告

ベータ版です。 APIは1.0より前に変更される可能性があるため、 アップグレードの前にリリースノートを確認してください。サーバーの起動時にデータベースのマイグレーションが実行されるため、事前にバックアップしてください。 このコードは、独立したセキュリティ監査を受けていません。

機能

会話	製品ごとに、独自のブランド、言語、営業時間、チームを設定した受信トレイを用意できます。メール、ライブチャット、アプリ内メッセージ、アプリへのフィードバックを1つのスレッドにまとめ、メモ、ラベル、メンション、メンバーが確認するボットの下書きも利用できます。
チームメール	sales@などの共有アドレスと、各自のメールボックスを同じ受信トレイで利用でき、下書き、送信予約、フィルター、検索演算子にも対応しています。個人のメールボックスは非公開で、委任できます。Yuvaはメールボックスであり、メールアプリ用のIMAPサーバーではありません。
リーチ	同意記録とインポートに対応したメーリングリスト、テンプレートから作成するメールデザイン、承認とレポートに対応した一斉配信、配信到達性チェックを利用できます。
公開	ヘルプセンター、ドキュメントページ、独自ドメインで公開できるステータスページ、ロードマップボード、新着情報を利用できます。
インサイト	会話の開始数と終了数、応答時間、SLA、評価に関するレポート、ウェブサイトとアプリ向けのCookieを使わない分析、会話の発生数に基づいてページを順位付けするサポートレポートを利用できます。
移行	Gmail、Microsoft 365、Yandex、iCloud、Zoho、任意のIMAPサーバー、Zendesk、Help Scout、Frontから、履歴と現在のメールを移行できます。移行元のメールボックスは読み取り専用です。
拡張	スコープ付きキーを使うREST API、署名付きWebhook、IDトークン、ヘッドレスモード、Claude、Cursor、VS Codeなどのアシスタント向けOAuthに対応したMCPサーバーを利用できます。

Go、Postgres、Reactパネルで構築され、1つのDockerイメージとして提供されます。

クイックスタート

1. インストールガイドを参考に、compose.yamlと.envを作成します。

2. 起動します。

   docker compose up -d
   

3. 最初のオーナーを作成します。

   docker compose exec yuva /yuva bootstrap --email [email protected] --workspace "Example"
   

4. HTTPSの背後に配置し、メールで届くコードを使ってサインインします。

Kubernetesでは、Helmチャートoci://ghcr.io/productdevbook/charts/yuvaをインストールします。詳しくは KubernetesとHelmをご覧ください。

SDK とクライアント

対象	インストール	ガイド
Web：<yuva-chat>、ヘッドレスクライアント	npm install useyuva	Web ウィジェット、ヘッドレス
React と shadcn/ui	npx shadcn@latest add https://useyuva.com/r/yuva-discussions.json	shadcn レジストリ
iOS と macOS	Swift パッケージ https://github.com/productdevbook/yuva.git、プロダクト YuvaKit	モバイル SDK
Android	implementation("com.github.productdevbook:yuva:v0.3.1")	モバイル SDK
Go	go get github.com/productdevbook/yuva/sdk/go	Go SDK
AI アシスタント	サーバー上の /mcp、またはリリースの yuva.mcpb	MCP

動作するプロジェクトはサンプルにあります。

プライバシーとセキュリティ

• 自分でホストできます。会話、連絡先、ファイルはサーバー上にとどまります。
• アナリティクスでは Cookie を設定せず、サイトをまたいで追跡する識別子も保持しません。アナリティクスのプライバシーをご覧ください。
• すべての購読について、同意した人、日時、場所を記録し、エクスポートの一覧にもその記録を含めます。
• アシスタント向けには、顧客のテキストを信頼できないデータとしてマークし、送信を許可しない限り、返信は下書きとして扱います。
• 脆弱性はSECURITY.mdの説明に従って、非公開で報告してください。

ドキュメント

ガイド、API リファレンス、サンプルはuseyuva.com/docsと docs/（トルコ語とドイツ語もあります）にあります。構築方法： アーキテクチャ。今後の予定：ロードマップ。変更内容： GitHub Releases。

コミュニティと貢献

まずCONTRIBUTING.mdをお読みください。貢献はCLAに基づいて行われます。 Postgres と、送信されたすべてのメールを受け取る Mailpit を備えたローカルサーバーを起動するには、 docker compose -f deploy/compose.yaml up -dを実行してください。 質問やバグの報告はissuesで行い、最新情報は @useyuvaをフォローしてください。

ライセンス

サーバーとパネルはAGPL-3.0です。SDK（sdk/）と API コントラクト（openapi/）は MITのため、クローズドソースのアプリにも組み込んで配布できます。詳細は LICENSING.mdをご覧ください。名称とロゴについてはTRADEMARK.mdをご覧ください。