Zendesk Sunshine Conversations API の概要：2026 年の開発者向けガイド

顧客メッセージングソリューションを構築する場合、WhatsApp（ワッツアップ）, Facebook Messenger（フェイスブックメッセンジャー）, SMS（ショートメッセージサービス）, およびアプリ内チャットの個別の統合を管理するという悪夢に直面したことがあるかもしれません。各チャネルには、独自の API（アプリケーションプログラミングインターフェース）, ドキュメント, および癖があります。チャネルを追加するたびに、メンテナンスの負担が増加します。

Zendesk Sunshine Conversations は、14 以上のメッセージングチャネルを統合する単一の REST API を提供することで、これを解決します。元々 Zendesk が買収する前の Smooch.io（スムーチ）として開発された Sunshine Conversations（サンシャインカンバセーションズ）を使用すると、開発者は一度構築して、すべての主要なメッセージングプラットフォームに展開できます。

このガイドでは、Sunshine Conversations API が提供するものを正確に分析し、その仕組み、および開始するために知っておくべきことを説明します。また、カスタム統合を構築せずに AI（人工知能）を活用したメッセージングを必要とするチームのために、eesel AI がどのように代替手段を提供するかについても説明します。

Zendesk Sunshine Conversations とは何ですか？

Sunshine Conversations（サンシャインカンバセーションズ）は、Zendesk（ゼンデスク）の顧客体験エコシステムの中心にあるマルチチャネルメッセージングプラットフォームです。アプリケーションと多数のメッセージングチャネル間の翻訳レイヤーとして機能し、各プラットフォームの癖を整合性のある API（アプリケーションプログラミングインターフェース）に正規化します。

このプラットフォームは、主に 2 つの対象者にサービスを提供します。

開発者向け には、メッセージングチャネルごとに個別の統合を構築する必要がなくなります。WhatsApp Business API（ワッツアップビジネスAPI）の特異性、Facebook Messenger（フェイスブックメッセンジャー）の webhook（ウェブフック）形式、および SMS（ショートメッセージサービス）プロバイダーの癖を学ぶ代わりに、Sunshine Conversations（サンシャインカンバセーションズ）と一度統合すると、プラットフォームが残りを処理します。

企業向け には、ヘルプデスク、CRM（顧客関係管理）, およびボットプラットフォームなどの既存のツールを、多くの場合コードを記述せずに、顧客が好むメッセージングチャネルを介して顧客に接続できます。

Smooch.io（スムーチ）のレガシー

Sunshine Conversations（サンシャインカンバセーションズ）は、Zendesk（ゼンデスク）が買収したスタンドアロンのメッセージングプラットフォームである Smooch.io として始まりました。レガシードキュメントおよび一部の SDK（ソフトウェア開発キット）リポジトリには、Smooch（スムーチ）の参照がまだあります。コアプラットフォームは Zendesk（ゼンデスク）の Suite（スイート）に完全に統合されていますが、API（アプリケーションプログラミングインターフェース）アーキテクチャと多くのエンドポイントは Smooch（スムーチ）の DNA（デオキシリボ核酸）を保持しています。

ライセンスされた Zendesk（ゼンデスク）のお客様の場合、ベース URL（ユーアールエル）は https://{subdomain}.zendesk.com/sc です。レガシー Sunshine Conversations（サンシャインカンバセーションズ）アカウントは、引き続き https://api.smooch.io を使用します。

コア API（アプリケーションプログラミングインターフェース）の機能とアーキテクチャ

Sunshine Conversations API（サンシャインカンバセーションズAPI）は、JSON（ジェイソン）リクエストとレスポンスボディを備えた REST（レスト）原則に従います。現在のバージョンは v2 ですが、既存の統合では v1.1 が引き続きサポートされています。

主要なエンドポイントとリソース

API（アプリケーションプログラミングインターフェース）は、いくつかのコアリソースを中心に展開します。

リソース	主な操作	ユースケース
メッセージ	メッセージの送信、受信、リスト	コアメッセージング機能
会話	会話スレッドの作成、読み取り、更新、削除	会話管理
ユーザー	プロファイル管理、認証、マージ	顧客ID
Webhook（ウェブフック）	イベントのサブスクライブ、エンドポイントの管理	リアルタイム通知
添付ファイル	メディアファイルのアップロード、取得	リッチメッセージングのサポート

すべてのエンドポイントは、標準の HTTP（エイチティーティーピー）メソッドを使用します。取得には GET（ゲット）, 作成には POST（ポスト）, 更新には PATCH（パッチ）, 削除には DELETE（デリート）を使用します。API（アプリケーションプログラミングインターフェース）は、HTTP（エイチティーティーピー）ステータスコードと説明的なエラーオブジェクトを含む一貫したエラー形式を返します。

ページネーションと制限

Sunshine Conversations（サンシャインカンバセーションズ）は、オフセットページネーションではなく、カーソルベースのページネーションを使用します。このアプローチは、ページ番号ではなく特定のアイテムへのポインタを返すことにより、大規模なデータセットでのパフォーマンスの問題を回避します。

page[after] または page[before] クエリパラメータを使用して、結果を前後に移動できます。オプションの page[size] パラメータは、リクエストごとに返されるレコード数を制御します。

次のハード制限に注意してください。

制限	値	影響
会話ごとのメッセージ数	30,000	古い会話はアーカイブする必要があります
JSON（ジェイソン）リクエストサイズ	100KB（キロバイト）	大きなペイロードは拒否されます
ファイルアップロードサイズ	50MB（メガバイト）	メディア添付ファイルにはサイズ制限があります
レート制限	可変	超過すると 429 ステータスコード

レート制限に達すると、API（アプリケーションプログラミングインターフェース）は 429 Too Many Requests（リクエストが多すぎます）ステータスを返します。固定再試行間隔ではなく、ジッター付きの指数バックオフを実装します。使用量の急増は予想され、制限は通常の操作に対して寛大になるように設計されています。

認証とセキュリティ

Sunshine Conversations（サンシャインカンバセーションズ）は、ユースケースに合わせて 2 つの認証方法をサポートしています。

基本認証

サーバー間 API（アプリケーションプログラミングインターフェース）呼び出しの場合、基本認証が最も簡単なアプローチです。API（アプリケーションプログラミングインターフェース）キー ID（アイディー）をユーザー名として、シークレットを標準の HTTP（エイチティーティーピー）基本認証形式のパスワードとして使用します。

この方法は、サーバーから Sunshine Conversations API（サンシャインカンバセーションズAPI）に呼び出しを行うバックエンド統合に適しています。実装とデバッグが簡単です。

JWT（ジェイソンウェブトークン）認証

JSON Web Token（ジェイソンウェブトークン）は、特にアクセス範囲を狭くする必要がある場合や、安全性の低いチャネルを介して資格情報を渡す場合に、より柔軟な認証オプションを提供します。

JWT（ジェイソンウェブトークン）を生成するには、次のものが必要です。

• アルゴリズム（HS256）とキー ID（アイディー）を含むヘッダー
• スコープクレーム（アカウント、アプリ、または統合）を含むペイロード
• API（アプリケーションプログラミングインターフェース）シークレットを使用した署名

JWT（ジェイソンウェブトークン）は、Bearer（ベアラー）プレフィックス付きの Authorization（オーソリゼーション）ヘッダーで送信されます：Authorization: Bearer your-jwt-token。

認証スコープ

API（アプリケーションプログラミングインターフェース）は、許可される操作を決定する 3 つの主要な認証スコープを使用します。

スコープ	アクセスレベル	最適
アカウント	アカウントプロビジョニングを含むすべてのメソッド	マルチテナント SaaS（サービスとしてのソフトウェア）アプリケーション
アプリ	すべてのコア API（アプリケーションプログラミングインターフェース）メソッド	単一アプリケーション統合
統合	ユーザー、会話、添付ファイル、Webhook（ウェブフック）	制限されたサードパーティ統合

API（アプリケーションプログラミングインターフェース）キーは、そのスコープを示す命名規則に従います。アカウントキーは act_ で始まり、サービスアカウントキーは svc_ で始まり、アプリキーは app_ で始まります。

サポートされているメッセージングチャネル

Sunshine Conversations（サンシャインカンバセーションズ）は、業界で最も包括的なメッセージングチャネルをサポートしています。すべてのチャネルは同じ API（アプリケーションプログラミングインターフェース）を介してアクセスでき、プラットフォームはチャネル固有の形式と統合 API（アプリケーションプログラミングインターフェース）間の変換を処理します。

サードパーティのメッセージングアプリ

• WhatsApp Business API（ワッツアップビジネスAPI） - ビジネスメッセージング、テンプレート、およびリッチメディアのフルサポート
• Facebook Messenger（フェイスブックメッセンジャー） - ボタン、クイックリプライ、およびウェブビューとの完全な統合
• Instagram Direct（インスタグラムダイレクト） - Instagram（インスタグラム）ビジネスアカウントを介したメッセージング
• Apple Messages for Business（アップルメッセージフォービジネス） - Apple（アップル）のビジネスメッセージングプラットフォームとの統合
• LINE（ライン）, Telegram（テレグラム）, Viber（バイバー） - 主要なアジアおよびヨーロッパのメッセージングプラットフォームのフルサポート
• Twitter DM（ツイッターディーエム） - Twitter（ツイッター）を介したダイレクトメッセージング
• WeChat（ウィーチャット） - 中国の主要なメッセージングプラットフォームのサポート

SMS（ショートメッセージサービス）および音声プロバイダー

• Twilio（トゥイリオ） - Twilio（トゥイリオ）のインフラストラクチャを介した SMS（ショートメッセージサービス）統合
• MessageBird（メッセージバード） - 代替 SMS（ショートメッセージサービス）プロバイダーの統合

Zendesk（ゼンデスク）構築の SDK（ソフトウェア開発キット）

• Web Messenger（ウェブメッセンジャー） - ウェブサイト用の埋め込み可能なチャットウィジェット
• Android SDK（アンドロイドSDK） - ネイティブ Android（アンドロイド）アプリ内メッセージング
• iOS SDK（アイオーエスSDK） - ネイティブ iOS（アイオーエス）アプリ内メッセージング
• Unity SDK（ユニティSDK） - ゲームおよび 3D（3次元）アプリケーション統合

このプラットフォームは、構造化メッセージ、クイックリプライ、カルーセル、ファイル共有など、利用可能なチャネル全体でリッチメッセージング機能をサポートしています。チャネルが新しい機能を追加すると、Sunshine Conversations（サンシャインカンバセーションズ）は通常、最小限のコード変更でそれらをサポートするように更新されます。

開発者ツールと SDK（ソフトウェア開発キット）

HTTP（エイチティーティーピー）を介して Sunshine Conversations API（サンシャインカンバセーションズAPI）と直接対話できますが、Zendesk（ゼンデスク）は API（アプリケーションプログラミングインターフェース）をラップし、認証、エラー処理、およびリクエスト形式を処理する公式 SDK（ソフトウェア開発キット）を提供します。

公式 SDK（ソフトウェア開発キット）

言語	パッケージ/リポジトリ	状態
Java（ジャバ）	sunshine-conversations-java	積極的にメンテナンスされています
Ruby（ルビー）	sunshine-conversations-ruby	OpenAPI（オープンエーピーアイ）から自動生成
Python（パイソン）	sunshine-conversations-client	PyPI（パイピーアイ）パッケージ、自動生成
JavaScript（ジャバスクリプト）	sunshine-conversations-javascript	コミュニティによってメンテナンスされています

Java SDK（ジャバSDK）は、Zendesk（ゼンデスク）から最も活発なメンテナンスを受けています。Ruby（ルビー）および Python SDK（パイソンSDK）は、OpenAPI（オープンエーピーアイ）仕様から自動生成されており、API（アプリケーションプログラミングインターフェース）の変更に常に最新の状態を維持していますが、手作りのエルゴノミクスが欠けている可能性があります。

開発ツール

テストと調査のために、Zendesk（ゼンデスク）は、すべてのエンドポイントとリクエストの例を含む Postman（ポストマン）コレクション を提供します。OpenAPI（オープンエーピーアイ）仕様 は、カスタムクライアントまたはドキュメントを生成するために公開されています。

Webhook（ウェブフック）統合

リアルタイムイベント処理は、Webhook（ウェブフック）を介して行われます。サーバーは、受信メッセージ、配信確認、または会話状態の変更などのイベントが発生したときに POST（ポスト）リクエストを受信するエンドポイントを公開します。

一般的な Webhook（ウェブフック）トリガーには、次のものがあります。

トリガー	いつ発火するか
conversation:message（会話：メッセージ）	顧客またはエージェントがメッセージを送信します
postback（ポストバック）	ユーザーがボタンまたはクイックリプライをクリックします
conversation:created（会話：作成）	新しい会話が開始されます
conversation:typing（会話：入力中）	ユーザーが入力インジケーターを入力しています

Webhook（ウェブフック）統合を作成するときに提供される共有シークレットを使用して Webhook（ウェブフック）署名を確認し、イベントが Sunshine Conversations（サンシャインカンバセーションズ）からのものであることを確認する必要があります。

Zendesk（ゼンデスク）エコシステムとの統合

Sunshine Conversations（サンシャインカンバセーションズ）は単独で存在するわけではありません。これは、より広範な Zendesk（ゼンデスク）プラットフォームに深く統合されており、ユースケースに応じて開発を加速したり、代替アプローチを提供したりできます。

Web Widget（ウェブウィジェット）

Web Widget（ウェブウィジェット） は、ウェブサイトまたはヘルプセンターに埋め込まれる顧客向けのチャットインターフェースを提供します。これは内部で Sunshine Conversations（サンシャインカンバセーションズ）を使用するため、ウィジェットを介して開始された会話は、他のチャネルで使用するのと同じ API（アプリケーションプログラミングインターフェース）を介して流れます。

Agent Workspace（エージェントワークスペース）

会話に人間の介入が必要な場合、会話は Zendesk（ゼンデスク）の Agent Workspace（エージェントワークスペース）にチケットとして表示されます。エージェントは直接応答でき、メッセージは Sunshine Conversations（サンシャインカンバセーションズ）を介して元のチャネルの顧客に返送されます。これにより、顧客が多数のメッセージングプラットフォームに分散している場合でも、統合されたエージェントインターフェースが提供されます。

Switchboard（スイッチボード）

Switchboard（スイッチボード）は、ボット、AI（人工知能）システム、および人間のエージェント間の会話ルーティングを制御します。会話のコンテキストを維持しながら、システム間でプログラムで制御を渡すことができます。これにより、人間へのシームレスなエスカレーションによるボットファーストトリアージなどの高度なワークフローが可能になります。

eesel AI では、これらの統合ポイントを活用して、Zendesk（ゼンデスク）内でネイティブに動作する AI（人工知能）を活用した顧客サービス を提供します。AI（人工知能）エージェント は、Sunshine Conversations（サンシャインカンバセーションズ）を介して会話を処理し、必要に応じて人間のエージェントにエスカレーションし、インタラクション全体で完全なコンテキストを維持できます。

Zendesk（ゼンデスク） Suite（スイート）の価格とアクセス

Sunshine Conversations API（サンシャインカンバセーションズAPI）へのアクセスには、特定の Zendesk（ゼンデスク） Suite（スイート）プランが必要です。すべての階層にプラットフォームのすべての機能が含まれているわけではありません。

プラン	年間価格	Sunshine Conversations（サンシャインカンバセーションズ）アクセス	含まれる MAU（月間アクティブユーザー）
Suite Team（スイートチーム）	月額 1 エージェントあたり 55 ドル	基本的なメッセージングのみ	N/A（対象外）
Suite Growth（スイートグロース）	月額 1 エージェントあたり 89 ドル	基本的なメッセージングのみ	N/A（対象外）
Suite Professional（スイートプロフェッショナル）	月額 1 エージェントあたり 115 ドル	フル API（アプリケーションプログラミングインターフェース）アクセス	1,000
Suite Enterprise（スイートエンタープライズ）	月額 1 エージェントあたり 169 ドル	フル API（アプリケーションプログラミングインターフェース）アクセス	1,000

重要な区別： Suite Team（スイートチーム）および Growth（グロース）には、Web Widget（ウェブウィジェット）を介したメッセージングが含まれていますが、カスタム統合のためのフル API（アプリケーションプログラミングインターフェース）アクセスは提供されていません。Sunshine Conversations API（サンシャインカンバセーションズAPI）を使用して独自の統合を構築するには、Suite Professional（スイートプロフェッショナル）または Enterprise（エンタープライズ）が必要です。

月間アクティブユーザー（MAU）は、30 日以内にメッセージを送受信するユニークユーザーを表します。含まれている MAU（月間アクティブユーザー）を超えた場合、追加のパックは 2,500 MAU（月間アクティブユーザー）あたり約 50 ドルで利用できます。

ソース： Zendesk（ゼンデスク）の価格

Sunshine Conversations（サンシャインカンバセーションズ）の開発を開始する

Sunshine Conversations（サンシャインカンバセーションズ）で構築する準備ができている場合は、開始するために必要なものは次のとおりです。

前提条件

1. Zendesk（ゼンデスク） Suite Professional（スイートプロフェッショナル）または Enterprise（エンタープライズ） - フル API（アプリケーションプログラミングインターフェース）アクセスに必要
2. Admin Center（管理センター）アクセス - API（アプリケーションプログラミングインターフェース）キーを生成し、チャネルを構成するため
3. 開発環境 - Webhook（ウェブフック）を受信するサーバーまたはクラウド関数
4. REST API（レストAPI）の基本的な理解 - API（アプリケーションプログラミングインターフェース）呼び出しを行い、応答を処理するため

クイックスタートの手順

1. API（アプリケーションプログラミングインターフェース）キーの生成 - Admin Center（管理センター）で、アプリと統合 > API（アプリケーションプログラミングインターフェース） > Conversations API（会話API）に移動します。新しいキーを作成し、アプリ ID（アイディー）、キー ID（アイディー）、およびシークレットを安全に保管します。

2. Webhook（ウェブフック）エンドポイントの設定 - POST（ポスト）リクエストを受信できる公開アクセス可能な HTTPS（エイチティーティーピーエス）エンドポイントを作成します。ローカル開発の場合、ngrok（エヌグロック）などのツールを使用して、マシンへのトンネルを作成できます。

3. 最初のチャネルの構成 - Admin Center（管理センター）で、メッセージングチャネルを有効にし（Web Widget（ウェブウィジェット）が最も簡単に開始できます）、それを Sunshine Conversations（サンシャインカンバセーションズ）アプリに接続します。

4. 統合のテスト - 選択したチャネルを介してメッセージを送信し、Webhook（ウェブフック）エンドポイントに到達することを確認します。次に、API（アプリケーションプログラミングインターフェース）を介して応答を送信してみてください。

詳細なチュートリアルについては、完全な開始ガイド を参照してください。

eesel AI：カスタム開発なしで AI（人工知能）を活用したメッセージング

Sunshine Conversations（サンシャインカンバセーションズ）を使用してカスタム統合を構築するには、かなりの開発リソースが必要です。目標がカスタムメッセージングプラットフォームを構築するのではなく、AI（人工知能）を活用した顧客サービスである場合は、そもそも構築する必要があるかどうかを検討してください。

eesel AI では、Zendesk（ゼンデスク）と直接統合する AI（人工知能）エージェント を提供し、カスタム開発を必要とせずに、Sunshine Conversations（サンシャインカンバセーションズ）、Switchboard（スイッチボード）オーケストレーション、およびマルチチャネルメッセージングの複雑さを処理します。AI（人工知能）を活用した顧客サービス は、すべてのメッセージングチャネルで機能し、人間のエスカレーションと完全な Zendesk（ゼンデスク）統合を備えており、コードを記述する必要はありません。

既存のヘルプデスクに AI（人工知能）チャット機能を追加したいチームのために、AI（人工知能）チャットボット は、Sunshine Conversations（サンシャインカンバセーションズ）と同じ統合アプローチでメッセージングチャネル全体で動作しますが、開発オーバーヘッドはありません。チケットボリュームの管理に役立つ場合は、AI（人工知能）トリアージ は、エージェントに到達する前に、チケットを自動的にルーティング、タグ付け、および優先順位付けします。