SocialHub.AI
リソース · 開発者センター

WhatsApp · LINE · RCS

WhatsApp (メタ クラウド API)、LINE (メッセージング API)、および RCS (Google RBM) を独自のプロバイダー アカウントで接続します。それぞれは電子メール、SMS、プッシュと同じ送信ウォーターフォール内のチャネルであり、接続するまでオフになり、送信時に同意が強制されます。

仕組み

自分のアカウントを持ち込む

各チャネルは、ブランド独自のプロバイダー アカウント (メタ WhatsApp ビジネス アカウント、LINE 公式アカウント、または Google 検証済み RBM エージェント) を使用します。チャンネルは接続するまでオフのままです。それまでは何も送信されません。

一送信滝

個別の「送信 WhatsApp」API はありません。それぞれは、電子メール、SMS、プッシュと同じキャンペーン/自動化エンジン内のチャネルです。共有フリークエンシー キャップが 1 つあり、次のチャネルへの自動フォールバックが行われます (電子メールは常に機能します)。

送信時に強制される同意

マーケティング オプトインは、送信時にチャネルごとにチェックされます (marketing_whatsapp /marketing_line /marketing_rcs)。適切な同意のないメンバーは送信されず、スキップされます。

暗号化されたシークレット

アクセス トークン、チャネル シークレット、およびサービス アカウント キーは保存時に暗号化され、API によって返されることはありません。これらを「設定」→「チャンネル」に一度貼り付けます。

WhatsApp

Meta WhatsApp ビジネス アカウントを接続します。ビジネスによって開始されたメッセージには、メタ承認されたテンプレートが使用されます。

// WhatsApp — Meta WhatsApp Cloud API (Settings → Channels → WhatsApp)
//   • Phone number id      — from your WhatsApp Business Account (WABA)
//   • Access token         — WABA access token (write-only, encrypted at rest)
//   • Templates            — business-initiated messages use Meta-APPROVED templates
//
// Addressed by the member's phone number. Off until enabled; once on, WhatsApp joins
// the send waterfall. Meta business verification happens on Meta's side before delivery.

LINE

LINE 公式アカウントを接続します。メンバーには、LINE userId によってアクセスされます。これは、フォロー Webhook (署名検証済み) またはワンタップポータル Connect LINE 経由で取得されます。ポータル フローが依存するサインインしたコンシューマー セッションについては、「メンバー ポータルの埋め込み」ガイドを参照してください。

// LINE — Messaging API (Settings → Channels → LINE)
//   • Channel access token — long-lived token (write-only, encrypted)
//   • Channel secret       — OPTIONAL, only to receive follow/unfollow events (below)
//   • LINE Login channel   — OPTIONAL, powers one-tap portal "Connect LINE"
//
// LINE is addressed by the member's LINE userId — captured two ways:
//
// 1) Follow webhook. Point your LINE Official Account's webhook at:
//      POST  https://flash.socialhub.ai/api/webhooks/line/{teamId}
//    Flash verifies the x-line-signature header before acting:
//      signature == base64( HMAC-SHA256( rawRequestBody, <channel secret> ) )
//    follow  -> the member's LINE userId is (re)linked
//    unfollow-> Flash stops targeting them on LINE
//    (Always returns 200 so LINE keeps the endpoint enabled.)
//
// 2) One-tap portal Connect LINE (needs the LINE Login channel). The member taps
//    "Connect LINE" on their portal privacy page and authorizes via LINE Login;
//    Flash links their LINE account to their membership automatically.

RCS

Google で検証された RBM エージェントとサービス アカウントを接続します。 Flash は、送信時にサーバー側で OAuth2 トークンのサービス アカウント キーを交換します。

// RCS — Google RCS Business Messaging / RBM (Settings → Channels → RCS)
//   • RBM agent id             — your Google-VERIFIED RBM agent (the sender)
//   • Service-account email    — the SA that calls the RBM API
//   • Service-account key (PEM)— write-only, encrypted; exchanged for an OAuth2 token
//                                server-side at send time
//
// Addressed by E.164 phone (like SMS/WhatsApp). Reaches RCS-capable Android handsets;
// falls back automatically when a recipient can't receive RCS. Google verifies the
// RBM agent on Google's side before delivery is live.

知っておいてよかった

  • 各チャネルはワークスペースごとであり、デフォルトではオフになっています。アカウントが接続されていないワークスペースでは、動作が変わることなくメールファーストのパスが維持されます。
  • チャネルごとの「送信」エンドポイントを呼び出すことはありません。キャンペーンまたはオートメーションを一度作成すると、チャネル プランがメンバーごとに適切なチャネルを選択し、電子メールにフォールバックします。
  • WhatsApp RCSは電話で対応します。 LINE メンバーの LINE userId (Webhookまたはポータル接続をフォロー) LINE).
  • プロバイダーのオンボーディング/検証 (メタ ビジネス検証、LINE OA セットアップ、Google RBM エージェント検証) はプロバイダー側​​で行われます。Flash は資格情報を保持し、同意を強制しますが、プロバイダーの承認を省略することはできません。

メッセージング チャネルに接続していますか?

プロバイダーの認証情報をチャネル設定に貼り付けて有効にすると、チャネルが既存のキャンペーンとジャーニーに自動的に参加します。