メインコンテンツまでスキップ

メッセージングプロバイダー

設定 → コミュニケーション → メッセージングプロバイダーでは、LeadHubを双方向メッセージングチャネルに接続します。設定後、リードの詳細ビューから直接リードに連絡でき、それらのチャネルからの受信メッセージが会話に届きます。

サポートされているチャネル：

チャネル方向プロバイダー
WhatsApp送受信Meta Cloud API（WhatsApp Business）
SMS送受信Twilio Programmable Messaging
Telegram送受信Telegram Bot API
Viber送受信Viber Business Messages
音声（クリックトゥコール）アウトバウンド + 録音Twilio Programmable Voice

WhatsApp Business（Meta Cloud API）​

前提条件​

  • business.facebook.comでのMetaビジネスアカウント
  • 承認済み電話番号を持つWhatsApp Businessアカウント
  • 番号がWhatsApp Cloud APIに登録されていること（通常のWhatsAppアプリではない）

ステップ1 — Metaアプリの作成​

  1. developers.facebook.com → マイアプリ → アプリを作成に移動します。
  2. アプリタイプとしてビジネスを選択します。
  3. 名前（例：LeadHub Integration）を付けてアプリを作成をクリックします。
  4. 製品を追加でWhatsAppを見つけて設定をクリックします。

ステップ2 — 認証情報の取得​

  1. WhatsApp製品ダッシュボードでAPI設定に移動します。
  2. 以下をメモします：
    • 電話番号ID（数値、例：106540352242922）
    • WhatsApp Businessアカウント ID
  3. システムユーザー（ビジネス設定内）→ システムユーザーを作成 → whatsapp_business_messaging権限を持つ永続アクセストークンを生成します。

ステップ3 — LeadHubで設定​

  1. 設定 → コミュニケーション → メッセージングプロバイダーに移動します。

  2. WhatsApp Businessセクションを展開して入力します：

    フィールド値
    有効オンに切り替え
    永続アクセストークンステップ2から
    電話番号IDステップ2から
    表示電話番号WhatsApp番号（例：+1-415-555-0199）

  3. 設定を保存をクリックします。

  4. 保存後に受信Webhook URLが表示されます： https://yourdomain.com/api/messaging/whatsapp/webhook/TENANT_ID/TOKEN

ステップ4 — MetaでWebhookを登録​

  1. MetaアプリダッシュボードでWhatsApp → 設定 → Webhooksに移動します。
  2. コールバックURLをステップ3の受信Webhook URLに設定します。
  3. 検証トークンを任意の文字列（例：leadhub_verify）に設定します。
  4. messagesWebhookフィールドをサブスクライブします。

テスト： 電話からWhatsApp番号にメッセージを送信してください。LeadHubに新しい会話として表示されるはずです。

SMS（Twilio Programmable Messaging）​

ステップ1 — Twilio認証情報の取得​

  1. console.twilio.comにログインします。
  2. ダッシュボードからアカウントSIDと認証トークンをコピーします。
  3. 電話番号 → 管理 → アクティブな番号でTwilio番号をメモします。

ステップ2 — LeadHubで設定​

  1. 設定 → コミュニケーション → メッセージングプロバイダーに移動します。

  2. **SMS（Twilio）**を展開して入力します：

    フィールド値
    有効オンに切り替え
    アカウントSIDTwilioダッシュボードのAC...
    認証トークンTwilioダッシュボードから
    送信者番号E.164形式のTwilio番号（例：+14155550199）

  3. 設定を保存をクリックします。

  4. 保存後に表示された受信Webhook URLをコピーします。

ステップ3 — TwilioでWebhookを登録​

  1. Twilioで電話番号 → 管理 → アクティブな番号に移動 → 番号をクリックします。
  2. メッセージング → メッセージが届いたときで、Webhook URLをLeadHub受信Webhook URLに設定します。
  3. メソッドをHTTP POSTに設定して保存します。

Telegram​

ステップ1 — Telegramボットの作成​

  1. Telegramを開いて**@BotFather**にメッセージを送ります。
  2. /newbotを送信してプロンプトに従います（名前とユーザー名）。
  3. BotFatherがボットトークンを提供します（形式：123456:ABCdef...）。
  4. ボットユーザー名もメモします（例：@your_leadhub_bot）。

ステップ2 — LeadHubで設定​

  1. 設定 → コミュニケーション → メッセージングプロバイダーに移動します。

  2. Telegramを展開して入力します：

    フィールド値
    有効オンに切り替え
    ボットトークンBotFatherから
    ボットユーザー名例：@your_leadhub_bot

  3. 設定を保存をクリックします。

LeadHubはTelegram Bot APIを使用してWebhookをTelegramに自動登録します — URLをTelegramに手動で貼り付ける必要はありません。

Viber Business Messages​

⚠️ Viber Business Messagesには承認済みViberサービスアカウント（ISV/ビジネスアカウント）が必要です。通常のViber個人アカウントではビジネスメッセージを送信できません。

ステップ1 — Viber認証トークンの取得​

  1. Viberのパートナープログラムに連絡してサービスアカウントを取得します。
  2. Viberパートナーポータルにログインして認証トークンを見つけます。
  3. 送信者名（ブランド名、最大28文字）をメモします。

ステップ2 — LeadHubで設定​

  1. 設定 → コミュニケーション → メッセージングプロバイダーに移動します。

  2. Viberを展開して入力します：

    フィールド値
    有効オンに切り替え
    認証トークンViberパートナーポータルから
    送信者名ブランド名

  3. 設定を保存をクリックします。

  4. 受信Webhook URLをコピーしてViberサービスアカウントダッシュボードに登録します。

音声 / クリックトゥコール（Twilio Voice）​

Twilio Voiceを使用すると、リードの詳細ページから直接ワンクリック通話が可能になります。通話は通話履歴に記録され、録音および自動文字起こしが可能です。

前提条件： SMS（Twilio）を先に設定する必要があります — VoiceはSMSと同じアカウントSIDと認証トークンを再利用します。

ステップ1 — LeadHubで設定​

  1. 設定 → コミュニケーション → メッセージングプロバイダーに移動します。

  2. **音声（Twilio Voice）**を展開して入力します：

    フィールド値
    有効オンに切り替え
    音声発信者ID番号E.164形式のTwilio音声番号（SMS番号と異なる場合あり）
    通話を録音両方の通話を録音するにはオンに切り替え
    自動文字起こし + AI要約テキスト文字起こしと要約を生成するにはオンに切り替え（プラットフォーム設定にOpenAI APIキーが必要）

  3. 設定を保存をクリックします。

  4. 3つのURL（TwiML URL、ステータスURL、録音URL）が表示されます。全てコピーします。

ステップ2 — TwilioでWebhookを登録​

  1. Twilioで音声番号 → 音声セクションに移動します。
  2. 電話がかかってきたとき → Webhook → TwiML URLを貼り付けます。
  3. 通話ステータスが変わったとき → ステータスURLを貼り付けます。
  4. 録音で、Webhookを録音URLに設定します。

トラブルシューティング​

問題解決策
「受信Webhook URLを生成するには設定を保存してください」まだ保存していません — 認証情報を入力してから保存をクリックしてください
WhatsApp Webhookの検証が失敗するMetaのVerify Tokenが設定時に使用したものと一致しているか確認する
Telegramメッセージが届かないLeadHubがWebhookを自動登録 — ボットトークンが正しいか確認する
SMSテストが失敗する認証トークンが正しくTwilio番号がアクティブか確認する
音声通話が接続されないTwiMLとステータスURLの両方がTwilioに登録されているか確認する
トークンがマスクされて表示される（••••••••••••）これは意図的なもの — 既存のシークレットはセキュリティのためマスクされます。保存済みのシークレットを維持するには変更しないでください。