TM Forum オープン API をはじめる
学習の目的
この単元を完了すると、次のことができるようになります。
- TM Forum のオープン API について説明する。
- 通信サービスプロバイダー (CSP) にとって TM Forum のオープン API が重要である理由を説明する。
- Salesforce Communications Cloud が TM Forum のオープン API に準拠するしくみを確認する。
- Communications Cloud の TM Forum 準拠 API の使用を開始するための手順を挙げる。
Communications Cloud には統合プラットフォームソリューションと管理パッケージが含まれます。どちらも TM Forum のオープン API をサポートしています。
サポートされている Communications Cloud TM Forum API を確認するには、「Communications Cloud TM Forum API Release Notes (Communications Cloud TM Forum API リリースノート)」を参照してください。
始める前に
このモジュールを始める前に、次の推奨コンテンツを完了することを検討してください。
TM Forum について
TM Forum (TeleManagement Forum の略語) は、通信サービスプロバイダー (CSP) がオペレーションの標準化、情報交換方法の改善、複数システム間の相互運用性の維持を推進するのをサポートしています。ビジネスプロセス、サービス管理、IT インテグレーションを効率化するためのフレームワークと API を作成しており、その標準は幅広く採用されています。TM Forum のオープン API は、CSP がシステムやパートナーとの統合をより簡単に費用対効果の高い方法で行えるようにする標準化された REST ベースの API です。
この API によって、異なるシステムやアプリケーション間でデータを交換するための共通の言語と構造が提供されます。たとえば、5 つの異なるパートナーそれぞれに、異なるインテグレーションを構築するとします。各インテグレーションはカスタム構築され、それぞれ安定性に欠けてしまいます。
標準がなければ、こうした現実に多くの CSP が直面することになります。TM Forum のオープン API は、すべてのシステムに共通の言語を提供することでこの問題を解決します。この API に準拠している Salesforce Communications Cloud を使用すれば、より速く接続し、リスクや再作業を減らすことができます。
通信サービスプロバイダー (CSP) は、電気通信会社、または単に通信会社と呼ばれることもあります。
これだけではありません。TM Forum のオープン API には次の利点もあります。
- インテグレーションを加速化し、市場投入までの時間を短縮する。
- カスタマイズと総所有コストを減らす。
- 業務効率と俊敏性を高める。
- ビジネスプロセスが将来変更された場合も対応できるようになる。
- ベンダーの固定化を防ぐのに役立つ。
CSP は、TM Forum のオープン API に準拠することで、不要な再開発にかかる時間を減らし、新しいサービスの提供にかける時間を増やすことができます。Communications Cloud を使用すれば、すべての要求と応答で同じ言語が使用されるため、変換に頭を悩ます必要がなくなります。
Communications Cloud が TM Forum と連携するしくみ
では、Communications Cloud が外部システムと通信するときに、どのように TM Forum のオープン API に準拠するかを確認しましょう。
外部システムは、クライアント (カスタマーポータル、パートナーのカスタムアプリケーション、モバイルアプリケーションなど) やテストソフトウェア (スクリプト、Postman など) です。そしてもちろん、そのクライアントとの会話を待っている Communications Cloud というシステムがあります。2 者間での会話が効率的かつ効果的に進行するのは同一言語が話されている場合のみであるのと同じように、クライアントとサーバー間のそれぞれの会話も同一言語で行われる必要があります。つまり、クライアントからの要求とサーバーからの応答の両方が TM Forum オープン API に適合している必要があります。
TM Forum オープン API は 2 つのカテゴリ (モード) に分けられます。インとアウトは視点の違い、 具体的には、サーバーの視点から見た向きです。
-
着信 API は、外部クライアントシステムによってコールされます。着信 API は、外部システムが Salesforce のデータモデルとやり取りできるように Communications Cloud 上で公開されています。たとえば、カスタマーサービス担当者が CSP のポータルから顧客情報を要求するときに使用されます。
-
発信 API は、下流システムと通信するために Communications Cloud によって使用されます (住所やロケーションに基づいてサービス対象資格を確認する場合など)。
TM Forum と Communications Cloud を使用したジャーニー
Communications Cloud の TM Forum 準拠 API は簡単に使用を開始できます。一連のシンプルなステップを積み重ねていくようなものです。モデルを理解することから始まり、作成、参照、更新、削除 (CRUD) 操作で終わります。
各ステップはすぐ前のステップに基づいており、最初のアクセスから、安全な標準ベースの API コールの実行へと続いています。
-
理解する: TM Forum オープン API コミュニケーションモデルを理解します。
-
アクセスする: Communications Cloud 組織にアクセスして試してみます。
-
使用する: ドキュメントを使用して、適切なエンドポイントと URL 形式を見つけます。
-
認証する: 安全な要求を確保するために認証します。
-
アクセスして操作する: TM Forum オープン API を使用してデータにアクセスし、操作します。たとえば、次のような操作が可能です。
-
GET: Communications Cloud データを取得する (参照)
-
POST: Communications Cloud データを投稿する (作成/更新)
-
DELETE: Communications Cloud データを削除する (削除)
-
GET: Communications Cloud データを取得する (参照)
上記のステップについて理解したら、さまざまな CRUD 操作を顧客レコード、カタログデータ、またはその他のサポートされている TM Forum オープン API に適用できます。
基本事項の確認が終わり、先へ進むのに必要な知識が備わりました。Communications Cloud 組織で API をサポートするための追加設定が必要になる場合があります。エンドポイントの可用性と URL 形式はリリースによって異なる場合があるため、リリースノートとドキュメントで最新の情報を確認してください。