SocialHub.AI
리소스 · 개발자 센터

WhatsApp · LINE · RCS

WhatsApp(메타 클라우드 API), LINE(메시징 API) 및 RCS(Google RBM)를 자신의 공급자 계정에 연결하세요. 각각은 이메일, SMS 및 푸시와 동일한 전송 워터폴의 채널입니다. 연결될 때까지는 전송 시 동의가 적용됩니다.

작동 방식

본인 계정으로 접속하세요

각 채널은 브랜드 고유의 공급자 계정(Meta WhatsApp 비즈니스 계정, LINE 공식 계정 또는 Google 인증 RBM 에이전트)을 사용합니다. 채널은 연결하기 전까지 비활성화 상태로 유지되며, 연결 전에는 아무것도 전송되지 않습니다.

폭포 한 번 보내기

별도의 "발송 WhatsApp" API 기능은 없습니다. 각각은 이메일, SMS, 푸시 알림과 같은 캠페인/자동화 엔진의 채널입니다. 동일한 발송 빈도 제한이 적용되며, 다음 채널로 자동 전환됩니다(이메일은 항상 작동합니다).

전송 시 동의가 강제됩니다.

마케팅 수신 동의 여부는 발송 시 채널별로 확인됩니다.marketing_whatsapp / marketing_line / marketing_rcs적절한 동의를 받지 못한 회원은 제외되며, 전송되지 않습니다.

암호화된 비밀

액세스 토큰, 채널 비밀 키 및 서비스 계정 키는 저장 시 암호화되며 API에서 반환되지 않습니다. 이러한 키는 설정 → 채널에서 한 번만 붙여넣으면 됩니다.

WhatsApp

Meta WhatsApp 비즈니스 계정을 연결하세요. 비즈니스에서 시작하는 메시지는 Meta에서 승인한 템플릿을 사용합니다.

// 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 — 팔로우 웹훅(서명 확인됨) 또는 원탭 포털 커넥트를 통해 캡처됨 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 (웹훅 또는 포털 연결을 따라가세요) LINE).
  • 공급자 온보딩/검증(메타 비즈니스 검증, LINE OA 설정, Google RBM 에이전트 검증)은 공급자 측에서 이루어집니다. Flash는 자격 증명을 보유하고 동의를 강제하지만 공급자의 승인 절차를 단축할 수는 없습니다.

메시징 채널 연결?

채널 설정에 공급자 자격 증명을 붙여넣고 활성화하면 채널이 기존 캠페인 및 여정에 자동으로 참여합니다.