Logo

Kakao Chingu APIをブランドメッセージAPIに移行する

大事な
  • 2025年12月31日をもちまして、Chingu Talk(FriendTalk)のサービスを終了いたします。サービスの中断を避けるために、この日付より前に移行を完了する必要があります。
  • 2026年1月1日、カカオブランドメッセージがチングトークを完全に置き換える。すべてのメッセージングでは、ブランド メッセージ API を使用する必要があります。

Kakao Chingu APIからBrand Message APIに移行するには、このページを使用します。本番環境に移行する前に実装する必要がある主な技術的な違い、検証ルール、および必要な変更について説明します。

このページは、すでにカカオ チング メッセージングを使用しているユーザーを対象としています。 初めてのカカオ オンボーディングには対応していません。

重要: 移行を本番環境に移行する前に、ブランドメッセージAPIの徹底的なエンドツーエンドテストを実施してください。

詳細な使用法、制約、最新のアップデートについては、 カカオブランドメッセージAPIのドキュメント (opens in a new tab)を参照してください。

カカオ・チングのメッセージ・タイプ

Kakao Chinguは、主に2つのメッセージタイプをサポートしています。

  1. 標準の Chingu メッセージ: ターゲット設定オプションのない基本的なメッセージ形式。
  2. ブランド メッセージの自由形式メッセージ: 明示的なターゲティングを必要とし、追加機能をサポートする強化された動的なメッセージ。

ターゲット

ターゲティングは、メッセージの受信者の適格性を定義します。ブランドメッセージの自由形式メッセージを送信する場合は、カカオがメッセージを配信できるユーザーを宣言する必要があります。

カカオは、次の2つのユーザーグループを区別します。

  1. チャネルフレンド
  2. チャネル登録者

ターゲティングは、メッセージが到達できるユーザー グループを指定します。カカオは配信時にターゲティングを強制し、指定されたターゲティングに一致しないユーザーへのメッセージ配信をブロックします。

例： ターゲティングがチャンネルの友達に設定されている場合、購読者のみのユーザーにはメッセージが届きません。ターゲティングが見つからない場合、メッセージは拒否されます。

ブランド メッセージの自由形式ターゲティング

ブランドメッセージの自由形式メッセージでは、次のいずれかの値でターゲティングする必要があります。

  • ALL_CONSENT
  • TARGETED_FRIENDS、または特定のコード (M、N、I、)。
備考

すべてのブランド メッセージの自由形式メッセージには、ターゲティング情報を含める必要があります。標準の Chingu メッセージは、ターゲティングをまったくサポートしていません。

カカオ チングとブランド メッセージ ボタンの種類と検証

標準の Chingu メッセージ では、次の 4 種類のボタンがサポートされています。

  1. URL
  2. APP_LINK
  3. BOT_KEYWORD
  4. MESSAGE_DELIVERY

ブランド メッセージ メッセージ は、標準の Chingu メッセージ ボタン タイプと 2 つの追加のボタン タイプをサポートしています。

  1. BUSINESS_FORM(事前登録が必要)
  2. ADD_CHANNEL(チャンネル登録用)

クーポン

クーポンは、すべてのブランドメッセージの自由形式メッセージタイプでサポートされていますが、タイプ固有の制限があります。

文字数制限とコンテンツ構造

以下の表は、カカオ Chingu の標準 Chingu とブランド メッセージの自由形式メッセージ タイプの文字数制限とコンテンツ構造を比較したものです。

メッセージの種類本文制限必須のターゲティングクーポンのサポートボタン数制限ボタンの文字数制限コンテンツの順序ルール
TEXT (標準)1,000サポートされていませんオプション(標準クーポン)最大 5 台14 文字以内制限なし
TEXT_FREE_FORM1,300必須オプション(標準クーポン)最大5名まで(クーポン利用で4名)14 文字以内ADD_CHANNELボタンとBUSINESS_FORMボタンの両方が含まれている場合は、ADD_CHANNELが最初になければなりません。それ以外の場合は、BUSINESS_FORMが最初でなければなりません。
IMAGE (標準)1,000随意オプション(標準クーポン)最大 5 台14 文字以内制限なし
IMAGE_FREE_FORM1,300必須オプション(標準クーポン)最大5名まで(クーポン利用で4名)14 文字以内BUSINESS_FORMが最初でなければなりません。それ以外の場合、ADD_CHANNELがリストされている場合は、ADD_CHANNELが最初になければなりません。
IMAGE_WIDE (標準)1,000随意オプション(標準クーポン)最大 5 台14 文字以内制限なし
IMAGE_WIDE_FREE_FORM76必須省略可能 (ImageWideFreeFormCoupon、18 文字制限)2つまで8 文字BUSINESS_FORMは最後になければなりません。それ以外の場合、ADD_CHANNELがリストされている場合は、ADD_CHANNELを最後にする必要があります。
ITEM_LIST (標準)該当なし (ヘッダー + アイテム)随意オプション(標準クーポン)2つまで14 文字以内制限なし
ITEM_LIST_FREE_FORM該当なし (ヘッダー最大 20 + アイテム)必須省略可能 (ItemListFreeFormCoupon、18 文字制限)2つまで8 文字BUSINESS_FORMは最後になければなりません。それ以外の場合、ADD_CHANNELがリストされている場合は、ADD_CHANNELを最後にする必要があります。

メッセージ・コンテンツ・モデルの違い

このセクションでは、標準のカカオ チング メッセージからブランド メッセージの自由形式メッセージに移行する際のコンテンツ タイプごとにの違いと検証の変更点について説明します。

メッセージタイプ別のコンテンツモデルの変更(標準→自由形式)

メッセージの種類カテゴリの変更スタンダード・チングブランドメッセージ自由形式移行への影響
回転木馬エレメント容量最大10個の要素最大 6 つの要素エレメント数の削減
ヘッドエレメントサポートされていませんオプションのヘッドをサポートペイロード構造の更新
テキストフィールド名'テキスト''メッセージ'[名前の変更] フィールド
ボタンモデルテキストボタンリッチ コンテンツ ボタン置換ボタンの種類
ADD_CHANNELの使用法複数許可カルーセルを横切って1つだけクロスエレメント検証の強制
商業タイトル要件随意必須タイトルが常に存在することを確認する
最低割引額最小 1最小0検証ロジックの調整
クーポンの説明制限なし最大 12 文字クーポンの内容を短縮する
ボタンの順序付け強制されない厳格に実施注文検証を適用する
カルーセルコマースエレメント容量最大10個の要素最大 6 つの要素エレメント数の削減
ボタンモデルテキストボタンリッチ コンテンツ ボタン置換ボタンの種類
ADD_CHANNELの使用法複数許可すべての要素で 1 つだけグローバル制約の適用
プレミアムビデオテキストフィールド名'テキスト''コンテンツ'[名前の変更] フィールド
ビデオモデル「ビデオ」「フリーフォームビデオ」ビデオペイロードの更新
ボタン構造リスト (サイズ = 1)単一ボタンオブジェクト構造をリファクタリングする
クーポンの説明制限なし最大 18 文字クーポンの内容を短縮する
ボタン (グローバル)ボタンモデル'テキストボタン'RichContentFreeFormButtonボタンクラスの置換
ボタンの種類4種類6種類新しいボタンをサポート
新しいボタン利用不可BUSINESS_FORM、ADD_CHANNELサポートの追加
順序強制されない厳密な検証が適用されます順序付けルールの適用
クーポン(グローバル)説明の制限制限なしタイプ固有の制限メッセージの種類による検証
コマースクーポン無制限の最大 12 文字コンテンツの調整
プレミアムビデオクーポン無制限の最大 18 文字コンテンツの調整

ブランドメッセージのエンドツーエンドの移行検証

ブランドメッセージの自由形式メッセージを本番環境に移行する前に、移行をエンドツーエンドで検証して互換性を確保し、メッセージの拒否や配信の問題を回避します。

ステップ検証エリア確認する内容合格基準
1ターゲットすべての自由形式のメッセージにはターゲティングが含まれていますALL_CONSENT、TARGETED_FRIENDS、または M/N/I/F プレゼント
2必須フィールドメッセージタイプごとに含まれる必須フィールドIMAGE_FREE_FORM / IMAGE_WIDE_FREE_FORM は画像を含む
3文字数制限文字の長さが制限内IMAGE_WIDE_FREE_FORM≤76文字
4ボタンの制限ボタン数とラベルの長さが強制されるタイプごとに有効なボタン数とラベルの長さ
5ボタンの順序付け適用された順序付けルールBUSINESS_FORM / ADD_CHANNEL が正しく順序付けられました
6クーポンの検証クーポンの種類と長さが有効クーポンはメッセージの種類と長さの制限に一致します
7カルーセルの制約要素とADD_CHANNELの制限が適用されます最大6つの要素、単一のADD_CHANNEL
8プレミアムビデオの制約構造とボタンのルールの適用ボタン 1 つ、正しいフィールドを使用
9配送テストカカオトークでメッセージが正しくレンダリングされるテキスト、画像、ボタン、クーポンが正しく表示される
10本番環境の準備レガシー使用法は残らない2025 年 12 月 31 日より前に使用された自由形式 API のみ

移行の主なポイント

  • ターゲティングは、すべてのブランドメッセージの自由形式メッセージに必須です。
  • 文字数制限はさまざまで、特にIMAGE_WIDE_FREE_FORM(76 文字のみ許可)の場合です。
  • 画像フィールドは、ブランドメッセージの自由形式のIMAGEおよびIMAGE_WIDEメッセージでは必須です。
  • ボタンの種類は BUSINESS_FORM と ADD_CHANNEL で拡張されますが、ボタン名の長さが短くなる場合があります。
  • ブランドメッセージの自由形式メッセージでは、ボタンの順序付けルールに厳密に従う必要があります。
  • クーポンの種類と説明の制限は異なるため、クーポンの内容を調整する必要があります。
  • 一部のブランド メッセージの自由形式メッセージ タイプでは、ボタン数の制限が厳しくなります(たとえば、IMAGE_WIDE_FREE_FORMではボタンが 2 つしか許可されません)。

信頼できるスキーマ定義、検証ルール、および最新情報については、 カカオブランドメッセージAPIのドキュメント (opens in a new tab)を参照してください。

Logo

ご不明点は

サポートまでお問い合わせ

ください

© NTT DOCOMO BUSINESS X,Inc.