Twilio を接続する
Twilio は、SMS・音声・ビデオ・認証のための API を提供するクラウドコミュニケーションプラットフォームです。Twilio 連携を使用すると、日次の利用状況とコストデータを Cloud Intelligence に取り込み、Cloud Analytics(クラウド分析)で Twilio の支出を分析できます。
前提条件
-
Administrator または Developer ロールを持つ Twilio アカウント
-
Billing Profiles Admin 権限を持つ DoiT アカウント
必要な認証情報
| 項目 | 説明 | 入手場所 |
|---|---|---|
| Account SID | Twilio アカウントの ID(AC で始まります) | Twilio console > Account Dashboard > Account Info |
| Account Name | レポート内で使用するこのアカウントの表示名 | 任意で設定(推奨: Twilio アカウント名を使用) |
| API Credentials | api_key_sid:api_secret 形式の API key SID と secret | Twilio console > Admin > Account management > API keys & tokens で作成 |
Standard API キーを作成する
-
Twilio console にサインインします。
-
Admin > Account management > API keys & tokens に移動します。
-
Create API key を選択します。
-
Key type で Standard を選択します。
-
わかりやすい名前(例:
doit-integration)を入力します。 -
Create を選択します。
-
SID と Secret をコピーし、
api_key_sid:api_secretの形式に結合します。注意Secret は一度しか表示されません。ページを閉じる前に必ずコピーしてください。
Twilio アカウントを接続する
-
Cloud Intelligence にサインインし、上部ナビゲーションのメガメニューから Data ingestion and integrations > Integrations を選択します。
-
インテグレーションカタログで Twilio を検索します。
-
インテグレーションカードで Connect + を選択します。
-
Account SID、Account Name、API Credentials(
api_key_sid:api_secret形式)を入力します。 -
Test connection を選択して、DoiT が Twilio データにアクセスできることを確認します。
-
テストが成功したら、Save を選択して設定を完了します。
テストに失敗した場合や、追加のサポートが必要な場合は、エキスパートへ問い合わせしてください。
初回接続時に、DoiT は過去の利用データを取り込みます。インポート処理には数時間かかる場合があります。データが Cloud Analytics で利用可能になると、メールでお知らせします。
データ更新
DoiT は Twilio データを 毎日 更新します。通常、データは Twilio によって生成されてから 48 時間以内に利用可能になります。
レポートディメンション
接続が完了すると、Twilio データは次の標準 Cloud Analytics ディメンションにマッピングされます。
| Cloud Analytics ディメンション | Twilio の値 | 例 |
|---|---|---|
| Provider | Twilio | Twilio |
| Billing Account | Account SID | ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
| Project/Account ID | Account SID | ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
| Service | 利用カテゴリ | sms、calls、phonenumbers |
| SKU | 利用内容の説明 | SMS - Outbound、Calls - Inbound |
標準ディメンションに加えて、次の Twilio 固有ラベルを利用できます。
| ラベル | 説明 |
|---|---|
| Category | Twilio 利用カテゴリ(例: sms、calls、recordings) |
| Billing Account | このアカウントに対して指定した表示名 |
| Service | 上位の利用グループ(Messaging、Voice、Phone Numbers など) |
Twilio 接続を削除する
-
Cloud Intelligence にサインインし、上部ナビゲーションのメガメニューから Data ingestion and integrations > Integrations を選択します。
-
インテグレーションカタログで Twilio を検索します。
-
インテグレーションカードで Manage を選択します。
-
削除したいアカウントの右端にあるケバブメニュー(⋮)を選択し、Delete を選択します。
-
確認のため再度 Delete を選択します。