ここから始める
KatoCall は課金エンジンを内蔵した電話交換機です。顧客はこれを通して発信し、残高を確認し、最も安いルートを選び、通話を計測して課金します——すべて自動です。
キャリアから分を一つの価格で仕入れ、顧客にはより高く売ります。KatoCall は両方を保存し、通話ごとに差額を確保します。
ヒント: KatoCall は通貨を換算しません。設定で通貨を一つ選び(既定は米ドル)、仕入れと販売の両方に使えば、どのマージンも単純な引き算になります。
パート 1
これは真新しいサーバーで一度だけ行います。技術者がサーバーを用意してくれるなら、このパートを渡してください。
| サーバー | Debian 12 (Bookworm)、64 ビット——まっさらなもの。まともな VPS なら何でも可(OVH、Hetzner、DigitalOcean、Vultr)。 |
|---|---|
| スペック | CPU 2 コア、メモリ 4 GB、ディスク 20 GB。メモリは 2 GB が下限。 |
| 公開 IP アドレス | サーバーにはインターネット上の自前アドレスが必要です——プロバイダーが提供します。 |
| サーバーへのログイン | root のパスワード、または sudo を使えるユーザー。 |
| キャリアから | SIP トランク(そのホストと、許可 IP もしくはユーザー名/パスワード)、加えてお持ちの番号(DID)。 |
| ドメイン名(任意) | https の鍵マークが欲しい場合のみ。なしで始めて、後から追加できます。 |
katocall-1.0.0.tar.gz をサーバーにコピーし、これらのコマンドを一つずつ実行します。各コマンドは何をしているか表示し、足りないものがあれば明確なメッセージで止まります。
最初のコマンドは何も変更しません——サーバーが準備できているか確認し、足りないものがあれば知らせます。
# unpack the package tar -xzf katocall-1.0.0.tar.gz cd katocall-1.0.0 # サーバーを確認(安全——何も変更しない) sudo bash install/00-preflight.sh
一つずつ実行します。01 番は電話エンジンをビルドし 10〜20 分かかります。残りはすぐ終わります。
sudo bash install/01-install-asterisk.sh # 電話エンジン(10〜20 分) sudo bash install/02-install-base-stack.sh sudo bash install/03-setup-admin-panel.sh sudo bash install/04-configure-ami.sh sudo bash install/05-production-hardening.sh sudo bash install/06-configure-did-forwarding.sh sudo bash install/07-configure-fail2ban.sh sudo bash install/08-configure-nat.sh sudo bash install/09-configure-outbound.sh sudo bash install/11-configure-backups.sh sudo bash install/12-configure-dialer.sh # ダイヤラーが必要な場合のみ
01 から 09 は必須です。ステップ 12 はダイヤラー専用——省いても他はすべて動きます。
約 65 項目を検査します——各サービス、ファイアウォール、バックアップ、セキュリティ——失敗したものには何を直すか示します。
sudo bash install/verify.sh PASS 66 WARN 1 FAIL 0
ブラウザでサーバーのアドレスを開いてサインインします。すぐに新しいパスワードを求められます——設定するまで何も使えません。
http://your-server-address/adminKatocall実通話の前に:HTTPS を有効化。 それまではパネルは平文 http で動き、ログインは保護されずインターネットを流れます。ドメインがサーバーを指したら、実行:
sudo bash install/10-configure-tls.sh panel.yourcompany.com you@yourcompany.com
パート 2
これでパネルに入りました。この 6 つをこの順番で作ります——それぞれ前のものを使います。すべてサイドメニューにあります。
サプライヤー(Supplier)は分を仕入れるキャリアです。すべてがここを参照するので、ここから始めます。Suppliers → New Supplier を開いて名前を付けます。
レートカード(Rate Card)は価格表で、宛先ごとに 1 行(米国の 1、英国の 44 のようなプレフィックス)。2 種類作ります:
何百ものプレフィックスを打ち込まないでください:カードを開いて Import CSV をクリックし、キャリアの価格ファイルを一度に読み込みます。
ヒント: 料金は小数点以下 4 桁で保存されます。5 桁の価格表はインポート時に丸められます。
トランク(Trunk)はサプライヤーとのライブ接続です。Trunks → New Trunk を開きます。重要なのは 2 点:
保存後、Test Call で発信できることを確認してから顧客を向けます。
トランク名に空白は使えません——IDT GOLD ではなく IDT-GOLD を使ってください。
ルーティンググループはこう言います:この種類の番号なら、この順でこれらのトランクを試せ。ダイヤルは 2 つ:
最初のトランクが話中や失敗なら、KatoCall は次に移ります。Preview で番号を入力し、どのトランクを使うか確認できます。
アカウント(Account)は 1 人の顧客です。Accounts → New Account を開きます。重要な選択:
ヒント: 発信するすべてのアカウントには、あなたが販売するプレフィックスをカバーする顧客用 Rate Card が必要です——ないと、それらの通話は拒否されます(ゼロで課金されることは決してありません)。
DID は、あなたの顧客の一人に連絡するために人が電話する番号です。アカウントを開き、DIDs → Add DID へ進み、番号と転送先を入力します。(先にアカウントを保存。)
パネルの各項目の横には小さな ? があり、その用途を 10 言語すべてで説明します。Settings → Network は大きな変更の後に設定を電話エンジンへ送ります。
パート 3
ダイヤラーは番号のリストに発信し、録音メッセージを再生し、人がキーを押して接続・折り返し依頼・配信停止できるようにします。先にインストールのステップ 12 が必要です。
これが何かを理解する: これはパワーダイヤラー(power dialer)であり、予測式ではありません。留守番電話検出なし(ボイスメールは応答とみなされます)、自動ペーシングなし——同時通話数を固定で設定します。一度に 1 台のサーバーで動作します。
Dialer Campaigns → New Campaign を開きます。課金先アカウントを選び、名前を付け、ペースを設定:Max Concurrent Calls、Max Attempts、Retry gap。
応答時に再生される Prerecorded Message をアップロードします。次に IVR Menu を作成——各キーの動作:
キャンペーンの Contacts セクションで Upload CSV をクリック——電話番号だけの簡単なファイルです。
Start を押すと数秒で発信を開始します。Pause も同じくらい速く止まります。完了すると Download Results が、各番号に何が起きたかを示すファイルを出します。
パート 4
4 つのコマンドで、サーバー上でやることのほぼすべてをカバーします。
sudo bash install/verify.sh # すべて健全か? sudo /usr/local/sbin/katocall-backup # 今すぐバックアップ sudo bash install/upgrade.sh # 新しいバージョンを適用 sudo bash install/uninstall.sh # 削除(データは残す)
バックアップは、それが守るのと同じディスク上にあります。 定期的に別の場所へコピーしてください。さもないとディスク障害でデータと唯一のバックアップが一緒に失われます。
収益レポートを信頼する前に、帳簿が 1 円単位で合うことを証明できます:
sudo -u softswitch admin/backend/venv/bin/python admin/backend/manage.py verify_ledger
パート 5
どんな問題でも、まず実行すべきは sudo bash install/verify.sh です。約 65 項目を確認し、再実行すべきスクリプトを示します。