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

KakaoTalkチャネルでのプッシュ配信

最終更新 2026/09/03

このドキュメントでは、AEでInfobipに接続し、KakaoTalk Brand Messageチャンネルを作成して、テスト送信、本番プッシュ、結果の調査を行う方法を説明します。

警告

送信時間帯：KakaoTalkのメッセージは、北京時間07:00（含む）～19:00（含まない）にのみ送信されます。これは韓国時間08:00（含む）～20:00（含まない）に相当します。タスクのトリガー時間は、この時間帯内に設定してください。

1. 機能の概要​

KakaoTalkチャネルでは、Infobipを介して、マーケティング同意の条件を満たす韓国のユーザーにBrand Messageを送信します。全体の流れは、Infobip認証の設定、チャンネルの作成と有効化、対象オーディエンスの選択、メッセージの編集とテスト、本番プッシュ、到達結果とクリック結果の確認です。

チャンネルは、メッセージプレビュー、テスト送信、システムのリーチファネルに対応しています。リーチファネルをオンにすると、「配信予定」「実際プッシュ数」「プッシュ成功」「実際到達」「プッシュクリック」の5つのステップがシステムによって自動的に記録されるため、リーチイベントを手動で作成する必要はありません。

2. 接続前の準備​

設定を開始する前に、Infobip側とAEのユーザーデータの準備が完了していることを確認し、現在のアカウントにエンゲージチャンネルの表示・編集権限があることを確認してください。

準備項目要件
InfobipアカウントアカウントでKakaoTalk Brand Message機能が有効になっており、送信権限があること。
接続情報有効なHTTPSのAPI Base URLとAPI Keyを用意します。API Keyは機密性の高い認証情報のため、「アプリケーションのライセンス」ダイアログでのみ入力します。
KakaoTalk SenderSenderがInfobipで設定済みで、Brand Messageに使用できること。チャンネルの作成時にこのSenderを入力する必要があります。
携帯電話番号プロパティ

韓国の携帯電話番号を保存するユーザープロパティがAEに存在し、プロパティのタイプが文字列または数値であること。

実際の送信番号は、+82に10桁の番号を付けた形式である必要があります（例：+821012345678）。

マーケティング同意受信者が業務上必要なマーケティング同意の条件を満たしており、チャネル友だち、チャネル友だち以外、またはマーケティングに同意したすべてのユーザーから選択できること。
注記

KakaoとInfobip側の確認：Brand Messageの送信に使用するKakaoTalkアカウントは、Business Channel認証を完了している必要があります。チャネル名やプロフィール画像などの情報は提出した企業情報と一致させ、KakaoTalk Channel Managerでカスタマーセンターの連絡先を登録してください。また、InfobipにそのチャネルとSenderが関連付けられていること、API Keyに必要なKakaoTalk APIの権限が含まれ、有効期限が切れていないことも確認してください。実際の設定は、KakaoTalkとInfobipのコンソールの表示に従ってください。

Infobipのダッシュボードに移動し、次の情報を収集します。

API keysとbase URL

  • Infobipポータルで、「Developer Tools」>「API Keys」を選択します。
  • API keysページで、API base URLをコピーします。
  • 「Create API key」を選択します。
  • 名前を入力し、有効期限を選択してから、KakaoTalkに必要なAPI権限スコープを選択します。これらの権限スコープによって、キーで実行できるInfobip APIの操作が制御されます。
  • channelでKakaoTalkを選択し、「Request Sender」をクリックします

3. Infobipのアプリ認証の設定​

  • エンゲージ > エンゲージ設定 > チャンネル設定 > サードパーティに移動します。
  • KakaoTalk - Brand Messageを展開し、「アプリケーションのライセンス」エリアでアプリを追加をクリックします。
  • 認証名、API Base URL、API Keyを入力します。
  • 接続して保存をクリックします。接続に成功すると、この認証をKakaoTalkチャンネルの作成に使用できます。
  • 次の図のように、「アプリケーションのライセンス」ダイアログでInfobipの接続情報を設定します。
図1 Infobipのアプリ認証の設定
フィールド入力説明
認証名チームで識別しやすい名前を入力します。業務や環境の情報を含めることを推奨します。
ProviderInfobipに固定されており、変更は不要です。
API Base URLInfobip PortalのDeveloper Tools > API KeysページでAPI Base URLをコピーし、完全なHTTPSのサービスURLを入力します。
API KeyInfobip PortalのDeveloper Tools > API Keysページでキーを作成またはコピーします。作成時には、識別しやすい名前と適切な有効期限を設定し、KakaoTalkに必要なAPI権限を付与します。既存の認証を編集する際、キーを変更しない場合は元のキーをそのまま使用できます。
  • 保存時に、システムがInfobipに接続して認証情報を検証します。
  • API Keyは暗号化して保存され、以降のページには表示されません。既存の認証を編集する際は、空欄のままにすると元のキーが引き続き使用されます。
  • 認証名は、現在のプロジェクト内で重複できません。
  • 接続に失敗した場合は、Base URLが有効なHTTPSアドレスであるか、API Keyが正しく有効期限内であるか、アカウントにKakaoTalkの権限があるか、現在のネットワークからInfobipにアクセスできるかを順に確認してください。チャンネルから参照されている認証は直接削除できないため、先に関連するチャンネルを処理してください。

4. KakaoTalkチャンネルの作成と有効化​

  • KakaoTalk - Brand Messageエリアで新規チャンネルをクリックします。
  • チャンネル名を入力し、正常に接続された承認済みのアプリを選択して、KakaoTalk Senderを入力し、携帯電話番号プロパティを選択します。
  • 必要に応じてリーチファネル設定をオンにし、チャネルを作成をクリックします。
  • チャンネル一覧に戻り、そのチャンネルを有効化します。有効化の際、システムは認証、Sender、携帯電話番号プロパティを再度検証します。

次の図のように、チャンネルの新規作成時には以下の設定を行う必要があります。

図2 KakaoTalkチャンネルの作成
フィールド入力説明
チャンネル名プロジェクト内でこのチャンネルを識別するための名前。
認証アプリの選択ステータスが正常で、接続に成功したInfobip認証のみを選択します。
KakaoTalk SenderInfobip PortalのChannels and Numbers > Channels > Sendersで、有効なSenderを確認して入力します。同じプロジェクト内では、同じ認証で同じSenderを重複して使用し、複数のチャンネルを作成することはできません。
携帯電話番号プロパティ韓国の携帯電話番号を保存している文字列型または数値型のユーザープロパティを選択します。
リーチファネル設定

オンにすると、システムが5つの固定リーチステップを自動的に記録します。システムステップは変更できません。

有効化されているチャンネルの設定は直接変更できません。認証、Sender、携帯電話番号プロパティ、リーチファネルを調整する必要がある場合は、まずチャンネルを無効化し、変更を完了してから再度有効化してください。

5. メッセージの編集とテスト送信​

  1. チャンネル一覧の操作列でテスト送信をクリックします。
  2. テスト用の携帯電話番号を入力し、対象オーディエンスとして、チャネル友だち、チャネル友だち以外、マーケティングに同意したすべてのユーザーのいずれかを選択します。
  3. メッセージタイプを1つ選択し、本文、画像、ボタン、商品、クーポン、動画など、ページで求められる内容を入力します。
  4. 右側のメッセージプレビューで表示を確認し、問題がなければ確認して送信をクリックします。

次の図のように、テスト送信ページには、オーディエンス範囲、8種類のメッセージタイプ、コンテンツ編集エリア、クライアントプレビューがまとめて表示されます。

図3 メッセージの編集とテスト送信

対象オーディエンスの説明

対象オーディエンスは必須項目で、Kakaoがリーチを許可するユーザーの種類を宣言するためのものです。AEでのターゲットグループの絞り込みに代わるものではありません。受信者は、タスクのターゲットグループの条件とKakaoのオーディエンス同意条件の両方を満たす必要があります。

対象オーディエンスリーチ可能なユーザー選択の目安
チャネル友だち現在のKakaoTalkチャネルを友だち追加しており、Kakaoの該当する同意条件を満たしているユーザー。デフォルト値。チャネルをフォロー済みのユーザーのみに送信する場合に適しています。この範囲では「チャネルを追加」ボタンは使用できません。
チャネル友だち以外現在のチャネルを友だち追加していないが、Kakaoを通じてマーケティングメッセージの受信を購読または同意しているユーザー。まだチャネルをフォローしていない、規約に準拠したオーディエンスへのリーチに適しています。「チャネルを追加」ボタンでフォローを促すことができます。
マーケティングに同意したすべてのユーザー条件を満たすチャネル友だちとチャネル友だち以外の両方が対象で、該当するマーケティング同意を持つ最大のリーチ可能範囲です。コンプライアンスを前提に、カバー範囲を優先する場合に適しています。「チャネルを追加」ボタンを使用できます。

Kakaoは配信時に、受信者が選択した範囲に該当するかを検証します。条件を満たさないユーザーにはメッセージが届きません。そのため、テスト送信と本番送信では、実際のマーケティング同意と一致する範囲を選択してください。

メッセージタイプコード主な内容の制限ボタンと補足ルール
テキスト型FT本文は必須。最大1300文字、改行99回まで。ボタンは最大5個。クーポン使用時は最大4個。ボタン名は最大14文字。
画像型FI画像と本文は必須。本文は最大1300文字、改行99回まで。ボタンとクーポンの制限はテキスト型と同じ。画像リンクはHTTP/HTTPSアドレスであること。
ワイド画像型FW画像と本文は必須。本文は最大76文字、改行5回まで。ボタンは最大2個、ボタン名は最大8文字。「チャネルを追加」ボタンは最後に配置。
項目リスト型FLタイトルは最大20文字で改行不可。3～4個の項目を含む。ボタンは最大2個、ボタン名は最大8文字。「チャネルを追加」ボタンは最後に配置。
カルーセルフィード型FC2～6枚のコンテンツカードを含む。各カードに画像とテキストの設定が必要。各カードにボタン1～2個。全体でクーポンは最大1枚、「チャネルを追加」ボタンは最大1個。
コマース型FM商品と画像は必須。商品タイトルは最大30文字、価格は0～99999999の整数。ボタンは1～2個、ボタン名は最大8文字。「チャネルを追加」ボタンは最後に配置。
コマースカルーセル型FA商品カードは最大6枚。ヘッダーカードなしの場合は2枚以上、ヘッダーカードありの場合は1枚以上。各カードにボタン1～2個。全体でクーポンは最大1枚、「チャネルを追加」ボタンは最大1個。
高度な動画型FP動画は必須で、tv.kakao.comのアドレスのみ対応。本文は最大76文字、改行5回まで。ボタンは最大1個、ボタン名は最大8文字。

共通ルール：現在、ボタンはURLと「チャネルを追加」の2種類のみ対応しています。URLボタンにはモバイルリンクの入力が必須で、PCリンクは任意です。画像とリンクには、アクセス可能なHTTP/HTTPSアドレスを使用する必要があります。

「チャネルを追加」ボタンは「チャネル友だち」オーディエンスでは使用できず、メッセージタイプによって配置位置の要件が異なります。各メッセージタイプの必須項目と文字数制限の詳細は、ページのリアルタイム検証に従ってください。本番タスクではユーザープロパティを挿入して、受信者ごとに内容を動的に置き換えることができます。

画像素材の推奨事項：JPEGまたはPNGを優先的に使用してください。幅は500 px以上を推奨し、鮮明さを損なわない範囲でファイルサイズを抑えてください。一般的にサポートされている比率は2:1、16:10、3:2、4:3、1:1、3:4です。

公開前に、URLが公開アクセス可能で、ログイン不要かつ期限切れにならないことを確認し、テスト送信で最終的なトリミングと表示を確認してください。

テスト用の携帯電話番号はページの形式に従って入力してください。現在、次の3つの形式で入力できます：

01012345678

010 1234 5678

010-1234-5678

送信時に、システムが韓国のE.164形式（例：+821012345678）に自動的に変換します。

システムは、Infobipから最終的な配信結果が返された後にのみ、テスト成功を表示します。リクエストが受け付けられたものの30秒以内に配信結果が得られない場合は、引き続き待つか、後で調査するよう案内が表示されます。

6. 本番プッシュと結果の調査​

エンゲージタスクまたはフローを作成する際に、有効化済みのKakaoTalkチャンネルを選択し、ターゲットグループ、対象オーディエンス、メッセージ内容を設定して、送信可能な時間帯内に公開します。システムはユーザープロパティに基づいて動的コンテンツを置き換えるため、同じタスク内でもユーザーによって最終的な文面が異なる場合があります。

結果の定義：Infobipがリクエストを受け付けたことは、メッセージがサービス事業者の処理に入ったことを意味するだけで、ユーザーが受信したことを意味するものではありません。

リーチファネルをオンにすると、「配信予定」「実際プッシュ数」「プッシュ成功」「実際到達」「プッシュクリック」ごとに結果を確認できます。このうち「実際到達」はInfobipから返される最終的な配信結果に、「プッシュクリック」はクリックのコールバックに基づきます。

現象調査方法
認証を選択できない、または接続に失敗するBase URLが完全なHTTPSアドレスか、API Keyが有効か、アカウントにKakaoTalkの権限があるか、現在のネットワークからInfobipにアクセスできるかを確認します。403は通常権限不足を、401は通常キーが無効であることを示します。
チャンネルを有効化できない認証の接続が正常であること、Senderが有効で、同じ認証で重複使用されていないこと、携帯電話番号プロパティが文字列型または数値型であることを確認します。
携帯電話番号の形式エラー最終的な番号が+82に10桁の数字を付けた形式（例：+821012345678）であることを確認します。スペース、ハイフン、その他の記号を取り除き、国番号の後の最初の桁は0にできません。
メッセージが予定時刻に送信されないトリガー時間が北京時間07:00（含む）～19:00（含まない）の範囲内であることを確認します。システムは送信の実行前に再度チェックし、時間帯外の場合はInfobipにリクエストを送信しません。
コンテンツの検証に失敗した、または拒否されたページの案内に従って、必須項目、文字数、画像またはカードの数、ボタンの順序、リンクを確認します。現在、ボタンはURLと「チャネルを追加」の2種類のみ対応しています。URLボタンにはモバイルリンクの入力が必須です。
リクエストは受け付けられたがテストが成功しないテスト送信は、最終的な配信結果を受け取った場合にのみ成功となります。システムは最大30秒待機します。まだ処理中の場合は、Infobipで番号のステータス、コンテンツ審査、アカウントの利用枠、サービスのステータスを確認してください。
配信失敗と表示されるInfobipから返された拒否、配信不能、期限切れの理由を確認し、特に対象オーディエンス、マーケティング同意、Sender、番号のステータス、メッセージ内容を確認します。
サービスのレート制限または一時的な異常しばらくしてから再送信します。システムはInfobipへの送信リクエストを自動的に再試行しません。失敗が続く場合は、返された情報をもとにプラットフォーム管理者またはInfobipサポートに連絡してください。

公開前のチェック：チャンネルが有効化されていること、ターゲットグループがマーケティング同意の条件を満たしていること、携帯電話番号プロパティが使用可能であること、メッセージプレビューが正しいこと、リンクにアクセスできることを確認し、トリガー時間を送信可能な時間帯内に設定してください。

このページは役に立ちましたか？
このページの内容