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

📡 チャネル概要

PulseHub のチャネルは、1 つの接続されたメッセージングアカウントを表します。同じタイプの複数のチャネルを持つことができます — たとえば、異なる部門用の 2 つの WhatsApp 番号や、営業/サポート/請求用の 3 つのメールボックスなど。

チャネルの仕組み​

プロバイダー（WhatsApp、Twilio など）
           │
           │  HTTP POST（webhook）
           ▼
/webhooks/{type}/{channel_id}
           │
           ▼
WebhookController
  1. 署名を検証
  2. ペイロードを正規化
  3. コンタクトを検索/作成
  4. 会話を検索/作成
  5. メッセージを保存
  6. オートメーションイベントを発火

各チャネルには以下があります：

  • 一意の ID（UUID）— これは webhook URL の {channel_id} です
  • タイプ — サポートされている 8 つのチャネルタイプのいずれか
  • 設定 — そのチャネルタイプに固有の認証情報を含む JSON データ
  • webhook トークン — 作成時に生成される 32 文字の 16 進数ランダムトークン
  • アクティブフラグ — 非アクティブなチャネルは受信 webhook を拒否し、送信メッセージを送りません

チャネルの追加​

  1. サイドバーでチャネルに移動
  2. チャネルを追加をクリック
  3. ドロップダウンからチャネルタイプを選択
  4. タイプ固有の認証情報を入力（各チャネルのガイドを参照）
  5. チャネルを保存をクリック

保存後、チャネルカードに Webhook URL が表示されます。この URL をコピーして、プロバイダーの開発者ダッシュボードに貼り付けてください。

Webhook URL フォーマット​

https://yourdomain.com/webhooks/{type}/{channel_id}

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

チャネル方向署名検証備考
WhatsApp双方向✅ HMAC-SHA256Meta Business アカウントが必要
SMS / Twilio双方向部分的Twilio アカウントが必要
Email双方向N/AIMAP ポーリングで受信
Telegram双方向—Bot API、署名なし
Viber双方向✅ HMAC-SHA256Viber Partners アカウントが必要
Instagram双方向✅ HMAC-SHA256Meta Graph API 経由
Facebook Messenger双方向✅ HMAC-SHA256Meta Graph API 経由
Web チャットウィジェット双方向Token埋め込み JS スニペット