2026年にZendeskメッセージングカルーセルテンプレートを作成する方法

顧客はプレーンテキストの応答以上のものを期待しています。製品オプションをスワイプしたり、ボタンをタップして会話をナビゲートしたり、サポートエクスペリエンスを視覚的に操作したりすることを望んでいます。Zendeskのメッセージングカルーセルテンプレートはまさにそれを提供しますが、それらをセットアップするには、散在するドキュメントをナビゲートし、どの実装方法がチームの技術リソースに適合するかを理解する必要があります。

このガイドでは、カルーセルテンプレートの作成を段階的に説明します。JSON構造、API呼び出し、ベストプラクティス、さらに技術的なセットアップをスキップしたい場合にeesel AIがリッチメッセージングを自動的に処理する方法について学びます。

Zendeskメッセージングカルーセルテンプレートとは何ですか？

Zendeskメッセージングカルーセルテンプレートは、会話の中で水平方向にスクロール可能なカードを表示するインタラクティブなメッセージタイプです。各カードには、画像、タイトル、説明、および最大3つのアクションボタンを含めることができます。製品の説明やサービスオプションを入力する代わりに、視覚的に表示し、顧客がタップして詳細を確認したり、選択したり、外部ページに移動したりできるようにします。

カルーセルは以下に適しています。

• 製品ショーケース - 画像と価格で複数のアイテムを表示します
• 予約 - 利用可能な時間枠またはサービスを表示します
• FAQナビゲーション - 関連するヘルプ記事に顧客を誘導します
• 複数オプションの表示 - 会話を圧倒することなく選択肢を提示します

最初に理解しておくべき重要な制限事項：すべてのメッセージングチャネルがカルーセルを同じようにサポートしているわけではありません。チャネルがそれらをサポートしていない場合、カルーセルは画像やインタラクティブボタンなしで生のテキストにフォールバックします。後でチャネル互換性マトリックスについて説明するので、それに応じて計画できます。

開始するために必要なもの

最初のカルーセルを構築する前に、以下があることを確認してください。

必要条件	詳細
Zendeskアカウント	Chatのエンタープライズまたはプレミアムプラン。APIメソッドのSunshine Conversationsアクセス
APIアクセス	Chat Conversations API（チャットカンバセーションAPI）の資格情報またはSunshine Conversations APIキー
チャネルサポート	Web Widget（ウェブウィジェット）、Facebook Messenger、LINE、Telegram、Viber、またはモバイルSDK
画像アセット	カルーセルカード画像のURL（CDNまたはZendeskでホスト）
基本的なJSONの知識	API呼び出しのためのJSON構造の理解

画像アセットの場合、Zendeskはカルーセル画像をホストしません。パブリックにアクセス可能なURLを提供する必要があります。推奨される画像仕様：1.91：1のアスペクト比（Facebook Messenger標準）、8MB未満、理想的にはJPGまたはPNG形式。

ステップ1：Zendeskメッセージングカルーセルテンプレートの実装方法を選択する

Zendeskは、カルーセルテンプレートを実装するための4つの方法を提供しています。選択は、技術リソースと必要な制御の量によって異なります。

方法	技術レベル	最適
Sunshine Conversations API	開発者	完全な制御、カスタム統合
AIエージェント - 高度な機能	ローコード	ZendeskのAIエージェントビルダーを使用するチーム
テンプレートショートカット	エージェントレベル	エージェントが送信する再利用可能なメッセージ
サードパーティアプリ	ノーコード	Interactive Messaging Templates（インタラクティブメッセージングテンプレート）のようなマーケットプレイスソリューション

Sunshine Conversations APIは、最も柔軟性を提供します。JSONペイロードを構築し、API呼び出しを行い、応答をプログラムで処理します。これは、eコマースプラットフォームからの製品推奨を表示するなど、外部イベントに基づいてカルーセルをトリガーする場合に最適です。

AIエージェント - 高度な機能を使用すると、ZendeskのUIを介してテンプレートを作成し、それらを会話フローに挿入できます。JSONを直接記述することはありません。インターフェイスがJSONを構築します。これは、自動化された会話のためにZendeskのAIエージェント機能をすでに使用しているチームに適しています。

テンプレートショートカットは、最も簡単なオプションです。再利用可能なテンプレートを一度作成すると、エージェントはコンポーザーで省略形構文を使用してそれらを送信します。最初のテンプレート設定後に追加の開発作業は必要ありません。

ステップ2：Zendeskメッセージングカルーセルテンプレートを作成する

カルーセルのJSON構造は、すべての実装方法で一貫したパターンに従います。以下は、適応できる動作例です。

{
  "type": "carousel",
  "items": [
    {
      "title": "プレミアムサポートプラン",
      "description": "1時間の応答時間で24時間年中無休の優先サポート",
      "mediaUrl": "https://yoursite.com/images/premium-plan.jpg",
      "actions": [
        {
          "type": "link",
          "text": "詳細はこちら",
          "uri": "https://yoursite.com/premium"
        },
        {
          "type": "reply",
          "text": "サインアップ",
          "payload": "sign_up_premium"
        }
      ]
    },
    {
      "title": "スタンダードプラン",
      "description": "4時間の応答時間で営業時間中のサポート",
      "mediaUrl": "https://yoursite.com/images/standard-plan.jpg",
      "actions": [
        {
          "type": "link",
          "text": "詳細を見る",
          "uri": "https://yoursite.com/standard"
        }
      ]
    }
  ]
}

主要な構造要素：

• type（タイプ）: "carousel"に設定する必要があります
• items（アイテム）: カードオブジェクトの配列（最大10枚のカード）
• title（タイトル）: カードの見出し（Sunshineの場合は128文字、Chatの場合は150文字）
• description（説明）: カードの本文テキスト（Sunshineの場合は128文字、Chatの場合は150文字）
• mediaUrl（メディアURL）: パブリックにアクセス可能な画像URL
• actions（アクション）: カードごとに1〜3個のボタンの配列

**文字数制限が重要です。**それを超えると、メッセージの送信に失敗します。以下は完全なリファレンスです。

プラットフォーム	最大カード数	タイトル	説明	ボタンテキスト
Sunshine Conversations	10	128文字	128文字	35文字
Zendesk Chat	10	150文字	150文字	20文字

利用可能なアクションタイプ：

• link（リンク）: 新しいタブでURLを開きます
• reply（返信）: 事前に定義されたメッセージを会話に返送します
• webview（ウェブビュー）: Conversations Extension（カンバセーションエクステンション）オーバーレイを開きます

ステップ3：Sunshine Conversations APIを介してカルーセルを送信する

プログラムでカルーセルを送信するには、Post Message（ポストメッセージ）エンドポイントを使用します。以下は完全なcurlコマンドです。

curl https://{subdomain}.zendesk.com/sc/v2/apps/{app_id}/conversations/{conversation_id}/messages \
     -X POST \
     --user '{key_id}:{secret}' \
     -H 'content-type: application/json' \
     -d '{
        "author": {
          "type": "business"
        },
        "content": {
          "type": "carousel",
          "items": [
            {
              "title": "カードのタイトル",
              "description": "カードの説明はこちら",
              "mediaUrl": "https://yoursite.com/image.jpg",
              "actions": [
                {
                  "type": "link",
                  "text": "ここをクリック",
                  "uri": "https://yoursite.com/page"
                }
              ]
            }
          ]
        }
      }'

認証の内訳：

• {subdomain}をZendeskサブドメインに置き換えます
• {app_id}をSunshine ConversationsアプリIDに置き換えます
• {conversation_id}をアクティブな会話IDに置き換えます
• Sunshine Conversations APIの資格情報から{key_id}:{secret}を使用します

注意すべき応答コード：

• 201 Created（作成済み）: メッセージが正常に送信されました
• 400 Bad Request（不正なリクエスト）: JSON構造と文字数制限を確認してください
• 401 Unauthorized（認証されていません）: APIの資格情報を確認してください
• 404 Not Found（見つかりません）: 会話IDまたはアプリIDが存在しません

最初に開発環境でテストします。APIは、イメージURLが実行時までアクセス可能かどうかを検証しないため、壊れたイメージはビジュアルのないカルーセルカードになります。

ステップ4：再利用可能なカルーセルのテンプレートショートカットを使用する

エージェントが同じカルーセルを繰り返し送信する場合は、テンプレートを一度作成し、省略形構文で参照します。

APIを介してテンプレートを作成する：

curl https://{subdomain}.zendesk.com/sc/v1.1/apps/{app_id}/templates \
     -X POST \
     --user '{key_id}:{secret}' \
     -H 'content-type: application/json' \
     -d '{
       "name": "pricing_plans_carousel",
       "message": {
         "role": "appMaker",
         "type": "carousel",
         "items": [
           {
             "title": "プレミアムプラン",
             "description": "24時間年中無休のサポート",
             "mediaUrl": "https://yoursite.com/premium.jpg",
             "actions": [{"type": "link", "text": "表示", "uri": "https://yoursite.com/premium"}]
           }
         ]
       }
     }'

テンプレートを送信する：

エージェントはコンポーザーにこれを入力します：

%((template:pricing_plans_carousel))%

Zendeskは、省略形を完全なカルーセルに自動的に置き換えます。

代替構文（テンプレートの競合がある場合）：

%{{template:pricing_plans_carousel}}%

テスト用のサンプルテンプレート：

Zendeskは、すぐに使用できる事前構築済みのテンプレートを提供しています。

テンプレート構文	送信する内容
%((template:smooch_tmpl_things_to_do))%	アクティビティカード付きのサンプルカルーセル
%((template:smooch_tmpl_family_basket))%	複数の要素を持つ複合メッセージ
%((template:smooch_tmpl_lead_capture))%	連絡先情報を収集するためのフォーム
%((template:smooch_tmpl_rate_conversation))%	評価のためのクイック返信
%((template:smooch_tmpl_nps_survey))%	NPS（ネットプロモータースコア）調査テンプレート

Zendeskメッセージングカルーセルテンプレートのチャネルサポートとフォールバック動作

すべてのメッセージングチャネルがカルーセルを同じようにレンダリングするわけではありません。これらの互換性レベルを中心に実装を計画してください。

チャネル	カルーセルサポート	フォールバック動作
Web Messenger	フル	ネイティブカルーセルレンダリング
Facebook Messenger	フル	ネイティブカルーセルレンダリング
LINE	フル	ネイティブカルーセルレンダリング
Telegram	フル	ネイティブカルーセルレンダリング
Viber	フル	ネイティブカルーセルレンダリング
Android SDK	フル	ネイティブカルーセルレンダリング
iOS SDK	フル	ネイティブカルーセルレンダリング
Chat Android SDK v2	なし	サポートされていません
Chat iOS SDK v2	なし	サポートされていません
SMS	なし	生のテキストフォールバック
Email	なし	生のテキストフォールバック

フォールバックで何が起こりますか？

チャネルがカルーセルをサポートしていない場合、Zendeskは代わりにカルーセルメッセージからtextプロパティを送信します。フォールバックテキストを指定しなかった場合、顧客は何も表示されないか、壊れたメッセージを受け取ります。常にtextフィールドを含めてください。

{
  "type": "carousel",
  "text": "料金プランをご覧ください：プレミアム（24時間年中無休のサポート）またはスタンダード（営業時間）。詳細については、PREMIUMまたはSTANDARDと返信してください。",
  "items": [...]
}

テストの推奨事項：

ライブになる前に、サポートするすべてのチャネルでカルーセルをテストします。同じJSONペイロードはプラットフォーム間で異なるレンダリングを行い、ボタンのスタイルはWeb MessengerとモバイルSDKの間で大きく異なります。

Zendeskメッセージングカルーセルテンプレートを作成する際の一般的な間違い

数十の実装に取り組んだ後、最も頻繁に発生する問題は次のとおりです。

画像が表示されない

これは通常、イメージURLがパブリックにアクセスできないか、形式がサポートされていないことを意味します。イメージがシークレットブラウザウィンドウでロードされることを確認してください。Zendeskはイメージをプロキシまたはキャッシュしません。クライアントのデバイスが直接フェッチします。

文字数制限違反

APIは制限を超えると400エラーを返しますが、エラーメッセージはどのフィールドが長すぎるかを指定しません。開発中に文字カウンターを使用し、URLエンコードを考慮してマージン（制限の20％未満を目指します）を組み込みます。

ボタンアクションが機能しない

返信アクションでは、ボットまたは統合がポストバックペイロードをリッスンする必要があります。返信ボタン付きのカルーセルを送信したが、ペイロードのハンドラーがない場合、顧客がタップしても何も起こりません。リンクアクション（どこでも機能します）を使用するか、バックエンドがポストバックを処理することを確認してください。

チャネルの非互換性の驚き

チームは多くの場合、Web Messengerでテストしてから、カルーセルがサイレントに失敗する他のチャネルにデプロイします。チャネル検出をロジックに組み込み、会話のチャネルに基づいて適切なメッセージタイプを送信します。

テンプレート構文エラー

%((template:name))%の1つの欠落している括弧は、置換を中断します。省略形は、顧客にプレーンテキストとして表示されます。メモリから入力するのではなく、動作する例からコピーアンドペーストします。

認証の失敗

Sunshine Conversations APIは、メインのZendeskアカウントとは異なる資格情報を使用します。通常のZendesk APIトークンではなく、Sunshine Conversations管理パネルで作成された個別のキーIDとシークレットが必要です。

より良いZendeskメッセージングカルーセルテンプレートのための高度なヒント

基本的なカルーセルが機能したら、これらのプラクティスでそれらを最適化します。

画像の最適化

ホストする前に画像を圧縮します。大きな画像は、特にモバイルでカルーセルのレンダリングを遅くします。許容できる品質を維持しながら、画像ごとに100KB未満を目指します。より高速なグローバル配信のために、エッジキャッシュを備えたCDNを使用します。

制限内のボタンコピー

ボタンテキストには20〜35文字しかないので、すべての単語が重要です。「プランを見る」は「ここをクリック」よりも優れています。視聴者が理解できる省略形をテストします。「よくある質問」の代わりに「FAQ」を使用します。

A/Bテストレイアウト

カルーセルの順序が重要です。最も人気のあるオプションがスクロールの最初または最後にパフォーマンスが向上するかどうかをテストします。一部のチームは、推奨オプションが最初のカードではなく2番目のカードとして表示される場合に、より高いエンゲージメントを確認しています。

eコマース固有のヒント

製品カルーセルの場合は、説明フィールドに価格を含めます。文字数制限は厳しいですが、「月額49ドル」は収まり、顧客にタップして価格を見つけてもらうよりも多くの資格のあるクリックを促進します。

パフォーマンスに関する考慮事項

各カルーセルAPI呼び出しは、レート制限に対してカウントされます。大量のシナリオでは、単純なクイック返信（使用するリソースが少ない）で同じ結果を達成できるかどうかを検討してください。

eesel AIでリッチメッセージングを簡素化する

カルーセルテンプレートの構築と維持には、継続的な努力が必要です。すべての製品アップデートには、テンプレートアップデートが必要です。すべての新しいチャネルには、互換性テストが必要です。技術的なオーバーヘッドなしでリッチメッセージングを必要とするチームのために、別の方法を提供しています。

eesel AIを使用すると、テンプレートを手動で構築する必要はありません。Zendeskに接続すると、既存のヘルプセンターの記事、過去のチケット、およびマクロから製品を学習します。顧客が製品について質問すると、必要なものに基づいて適切なカルーセル、ボタン、およびクイック返信を自動的に生成します。

違いはワークフローにあります。Zendeskのネイティブアプローチでは、次のようになります。

1. すべての製品バリエーションのJSONテンプレートを作成します
2. オファリングが変更されたときにテンプレートを更新します
3. チャネル間で手動でテストします
4. レンダリングの問題を監視します

eesel AIを使用すると、次のようになります。

1. ナレッジソースを一度接続します
2. 製品と価格を自動的に学習します
3. 各会話に適切なリッチな応答を生成します
4. JSONではなく、プレーンな英語で確認および改善します

AIエージェントは、リッチメッセージングを含む最前線のサポートを自律的に処理します。レビュー用の下書きから始めて、品質を確認したら範囲を拡大します。Zendesk統合にeesel AIを使用しているチームは、通常、成熟したデプロイメントで最大81％の自律的な解決を達成します。

当社の価格は、チームプランで月額299ドルから始まり、シートごとの料金はかかりません。エージェントを追加するよりも予測可能な方法でスケールするAIインタラクションに対して支払いを行います。