Hearthline · AI フロントデスク · 住宅サービス

住宅サービス業のための AI フロントデスクを、 自分の環境で。

空調、配管、屋根、太陽光のチーム向けのオープンソース AI 受付です。Vapi ですべての着信に応答し、見込み客を見極め、枠を予約し、写真から見積もりを作成して、構造化したリード情報をダッシュボードに書き込みます。セルフホストで、モデルと電話サービスの API キーは保存時に暗号化されます。
ステータス
ベータ
ライセンス
AGPL-3.0 · 商用ライセンスあり
GitHub
★ 8 · ⑂ 6
着信に応答し、見込み客を見極め
24/7
つのチャネル:電話、SMS、WhatsApp、メール、Web
5
の UI 言語(日本語を含む)
10
01

作った理由

AI 受付のプロダクトの多くはクローズドなサービスです。拠点ごとに月額料金がかかり、声はベンダーが選んだもので、通話データはベンダーのデータベースに残ります。

Hearthline はこの 3 つをひっくり返します。受付の名前も声もスクリプトもあなたのものです。AI は自分の API キーで動くので、通話ごとにプロバイダーの料金をそのまま払うだけです。リード、通話、見積もりは自分の PostgreSQL データベースに保存されます。

02

できること

  • あなたの名前と声で応対する受付

    名前、ペルソナ、声、ナレッジベースを事業ごとに設定できます。お客様には、いつ電話してもあなたのお店が応対しているように聞こえます。

  • 自分の AI キー

    Anthropic、OpenAI、Vapi、Twilio のキーは事業ごとに保存され、保存時に暗号化され、ダッシュボードではマスク表示されます。モデルのプロバイダーは設定から切り替えられます。

  • すべてのチャネルを 1 つの受信箱に

    電話、SMS、WhatsApp、メール、Web チャットが、顧客ごとに 1 本のタイムラインにまとまります。

  • リード、見積もり、チケット

    エージェントが構造化したリードをダッシュボードに書き込み、編集・印刷できる見積もりを作成します。受信したメッセージはサポートチケットになり、スレッド形式で返信できます。

  • ダッシュボードは 10 言語対応

    英語、スペイン語、ドイツ語、フランス語、イタリア語、ポルトガル語、オランダ語、中国語、日本語、アラビア語。アラビア語は右から左のレイアウトに対応しています。

  • すぐ使える 9 業種

    空調、配管、窓、屋根、太陽光、省エネ改修、電気工事、ガレージ、害虫駆除。それぞれに変更可能なナレッジベースがあります。

03

仕組み

  1. 01

    お客様から電話がかかる

    Vapi が音声をテキストに、テキストを音声に変換し、会話の各ターンを Hearthline に送ります。

  2. 02

    エージェントが次の行動を決める

    Django のサービスが Claude または OpenAI で受付のループを実行します。見込み客の見極め、空き状況の確認、見積もりの作成、予約、SMS やメールの送信ができます。

  3. 03

    すべてが記録される

    リード、通話、会話、見積もりは PostgreSQL に保存されます。

  4. 04

    チームはダッシュボードで仕事をする

    Next.js のダッシュボードで、概要、リード、通話、見積もり、顧客、サポートチケットを確認できます。テストページを使えば、電話番号がなくても受付と会話できます。

hearthline / live calls
incoming · +1 (555) 0192
A
Anna
AI receptionist · Apex HVAC
“Hi! This is Anna from Apex HVAC — how can I help you today?”
02:14 · transcribing
~/hearthline/leadwriting → postgres
nameSarah K.
serviceHVAC repair · no heat
address1142 Oak St · zone 3
slotThu 2:00 PM
quote$1,248 · drafted from photo
✓Lead qualified
✓Slot booked · Thu 2:00 PM
✓Photo quote drafted
5 channels · phone · sms · whatsapp · email · webbeta
04

自分で動かす

スタック全体は Docker Compose で起動します。デモには API キーが不要です。外部サービスはすべてスタブにフォールバックするので、ダッシュボードはそのまま動きます。

$ git clone https://github.com/codewithmuh/hearthline.git$ cd hearthline$ cp .env.example .env$ docker compose up --build$ docker compose exec backend python manage.py seed_demo --wipe$ docker compose exec backend python manage.py seed_admin
  • ダッシュボード: http://localhost:3000
  • Django 管理画面: http://localhost:8000/admin
  • REST API: http://localhost:8000/api
  • Anthropic か OpenAI のキーを追加すると、テストページが本物の会話になります。
05

技術スタック

フロントエンド
Next.js 15React 19TypeScript
バックエンド
Django 5Django REST Framework
データベース
PostgreSQL 16
音声とメッセージ
VapiTwilio
AI
Claude(エージェントループ)OpenAI(画像認識、プロバイダーとしても選択可)
実行とデプロイ
Docker ComposeVercelCaddy
06

現在の状況

実装済み

  • 事業ごとの AI キーと音声キー(Fernet で暗号化)
  • 7 つのツールを持つ受付エージェントのループ(Anthropic または OpenAI)
  • ダッシュボード:概要、リード、通話、編集・印刷できる見積もり、顧客、設定、テスト用シミュレーター
  • ダッシュボードの 10 言語対応
  • モデルのエンドポイントのレート制限、署名つき Webhook の検証、シークレット未設定時の起動ガード

未実装

  • 見積もり承認時の Stripe による前金
  • 見積もり送付のための SMS と WhatsApp の送信
  • 1 つのデプロイで複数の事業(現在は 1 デプロイにつき 1 事業)
  • iPhone と Android のコンパニオンアプリ
  • ルート計算つきの技術者の配車
07

よくある質問

Hearthline は無料ですか?
コードは AGPL-3.0 のもとで、自分でホストするなら無料です。使った分はモデル、Vapi、Twilio など各プロバイダーに自分で支払います。ホワイトラベルや再販向けには商用ライセンスがあります。
API キーなしで試せますか?
はい。外部サービスはすべてスタブで動き、ダッシュボードのテストページで受付と会話できます。キーを追加すれば本物の会話になります。
どんな事業向けですか?
住宅サービス業のチームです。空調、配管、窓、屋根、太陽光、省エネ改修、電気工事、ガレージ、害虫駆除。
データはどこに保存されますか?
ノート PC やサーバー上の、あなた自身の PostgreSQL データベースです。プロバイダーのキーは保存時に暗号化されます。
本番で使えますか?
現在はベータ版です。今のところ 1 つのデプロイで 1 つの事業に対応しており、前金、メッセージ送信、モバイルアプリはまだ開発中です。
→お仕事のご依頼

Hearthline をチームで動かしたい、あるいは似たものを作りたいとお考えですか?