KakaoTalkのセットアップ
この記事では、ユーザーのセットアップ、ユーザーIDの照合、KakaoTalkテストユーザーの作成など、BrazeでKakaoTalkメッセージングチャネルをセットアップする方法について説明します。
前提条件
| 要件 | 説明 |
|---|---|
| サポートされている KakaoTalk パートナーのアカウント | KakaoTalk メッセージングチャネルを使用するには、サポートされている KakaoTalk パートナー (CJ OliveNetworks または Infobip) のアカウントが必要です。 |
| KakaoTalk ビジネスチャネル | Braze を通じて KakaoTalk メッセージを送信するには、KakaoTalk アカウントが KakaoTalk ビジネスチャネルである必要があります。アカウントを作成すると、デフォルトのステータスはベーシックです。アカウントをビジネスチャネルにするには、ビジネスの認証を行い、関連するドキュメントを提出する必要があります。 |
| KakaoTalk 送信者キー | 有効な KakaoTalk 送信者キー。 |
| 連絡先電話番号 | KakaoTalk チャネル管理者の連絡先電話番号。 |
| Braze クラスター IP の許可リスト登録 | すべての顧客に IP 許可リストの登録が必要です。KakaoTalk を Braze に連携する前に、お使いのクラスターの Braze IP アドレスを登録してください。 |
Braze IP アドレスの登録
お使いのクラスターの Braze IP アドレスを Comm.One ダッシュボードに登録します。
- Comm.One ダッシュボードで、Account Management (계정 관리) に移動し、メニューアイコンを選択してから View Details (자세히보기) を選択します。
- Center & Upload IP Allowlist (센터&업로드 IP 화이트리스트) を選択します。
- Braze クラスターの IP アドレスを追加します。クラスター別の IP の完全なリストについては、IP 許可リストを参照してください。
KakaoTalk アカウントの種類
| アカウントの種類 | 説明 |
|---|---|
| ベーシックチャネル | あらゆる組織が設定できる標準的な KakaoTalk チャネルです。KakaoTalk を通じたブロードキャストメッセージングと 1:1 チャットが可能です。 |
| ビジネスチャネル | アップグレードされた、ビジネス認証済みの KakaoTalk チャネルで、申請と認証プロセスが必要です。以下のような拡張機能を提供します。
|
ビジネスチャネルの申請
申請を開始する前に、以下のビジネスドキュメントを準備してください。
- 韓国事業者登録証明書
- 事業代表者の身分証明書
- 在職証明書
- 業種別ライセンス
KakaoTalk チャネルの情報（チャネル名、プロフィール画像など）は、提出した公式ドキュメントの情報と正確に一致する必要があります。
ドキュメントを準備したら、以下のステップに従います。
- KakaoTalk Channel Admin Center にログインします。
- アップグレードしたい既存の KakaoTalk チャネルを選択します。
- Management (관리) セクションで、Business Channel Application (비즈니스 채널 신청) のオプションを選択します。
- Apply または Request button (신청) を選択してプロセスを開始します。
- 必要な情報を入力します。
- 審査結果の通知をお待ちください。
KakaoTalkを連携する
KakaoTalkチャネルをBrazeに接続する
- パートナー連携 > テクノロジーパートナーに移動し、KakaoTalkプロバイダーを選択します。
- プロバイダーに必要な認証情報を収集し（次のセクションを参照）、テクノロジーパートナーページに入力して保存します。
- 新しく保存した認証情報を使用して送信します。
CJ OliveNetworks
Comm.Oneダッシュボードにアクセスし、以下の情報を収集します。
| フィールド | 場所 |
|---|---|
| Comm.One Login ID (로그인 아이디) | プロフィールを選択します。 |
| Sender Key (발신프로필 키) | Template Management (템플릿 관리) > Sender Profile Management (발신프로필 관리)に移動します。 |
| Channel name (카카오톡 채널 프로필명) | Comm.Oneダッシュボードで、Template Management (템플릿 관리) > Sender Profile Management (발신프로필 관리)に移動します。 |
| Sender number (연락처) |
|
| Credential (ID) & Password (비밀번호) | Sender number (사업자 등록번호)と同じ場所に移動し、API > Brand Message (브랜드 메시지)に移動します。 |
KakaoTalkのSender Keyは、一度に1つのワークスペースにのみ連携できます。同じSender Keyを別のワークスペースで使用するには、まず元のワークスペースでKakaoTalk購読グループをアーカイブしてから、Brazeサポートに連絡して連携を解除してもらう必要があります。Brazeが連携を解除した後、新しいワークスペースで連携を設定できます。
単一の共通IDにマッピングされたチャネルのみ登録できます。
Infobip
InfobipダッシュボードとKakaoTalk Channel Admin Centerにアクセスし、以下の情報を収集します。
| フィールド | 場所 |
|---|---|
| API Base URL | Infobipポータルで、Developer Tools > API Keysに移動します。 |
| API キー | Infobipポータルで、Developer Tools > API Keysに移動します。 |
| Sender name / Sender key | Infobipポータルで、Channels and Numbers > Channelsに移動し、Sendersタブを選択します。 |
| Sender profile UUID | KakaoTalk Channel Admin Centerで、Channelsに移動し、チャネル情報ウィンドウでSearch IDを見つけます。 |
| Channel name | KakaoTalk Channel Admin Centerで、同じチャネル情報ウィンドウでチャネル名を見つけます。 |
APIキーとベースURL
- Infobipポータルで、Developer Tools > API Keysを選択します。
- API keysページで、API base URLをコピーします。
- CREATE API KEYを選択します。
- Nameを入力し、Expiration dateを選択してから、KakaoTalkに必要なAPIスコープを選択します。これらのスコープは、キーが実行できるInfobip APIアクションを制御します。
- CREATEを選択してキーを生成します。
- 生成されたキーをコピーします。このページに戻って、名前、有効期限、またはAPIスコープを更新できます。
Sender profile UUIDとチャネル名
- KakaoTalk Channel Admin Centerで、Channelsを選択します。
- Channel Informationウィンドウで、Channel nameとSearch id（sender UUID）を見つけます。
- Customer center contact informationを入力します。これは広告メッセージを送信する際に必要です。
- 別のチャネルを表示するには、メニュー上部のチャネルアイコンを選択します。
- My channelリストで、表示したいチャネルを選択し、前のステップを繰り返します。
ユーザープロファイルの設定
ユーザープロファイルには、KakaoTalkを通じてメッセージを送信するためにE.164形式の電話番号が必要です。電話番号はユーザープロファイルに表示されます。KakaoTalkでは、電話番号がE.164形式（例: +821025749774）である必要があります。これは、複数の形式の電話番号を受け入れる他のメッセージングチャネルとは異なります。
電話番号のインポート
CSVをアップロードするかAPIを使用して、ユーザーを作成することで電話番号をインポートします。インポートする前に、電話番号がE.164形式であることを確認してください。