Twilio を接続する
Twilio は、SMS・音声・ビデオ・認証のための API を提供するクラウドコミュニケーションプラットフォームです。Twilio インテグレーションにより、Twilio の日次利用データとコストデータが DoiT Cloud Intelligence に取り込まれ、Cloud Analytics(クラウド分析)で Twilio の支出を分析できます。
前提条件
- Administrator または Developer ロールを持つ Twilio アカウント
- Billing Profiles Admin 権限を持つ DoiT アカウント
必要な認証情報
| フィールド | 説明 | 入手場所 |
|---|---|---|
| Account SID | Twilio アカウントの識別子(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 アカウントを接続する
-
DoiT Cloud Intelligence にサインインし、データ取り込みとインテグレーション → Assets に移動します。
-
左側のメニューから Twilio を選択し、新しいアカウントを接続 を選択します。
-
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 dimension | Twilio の値 | 例 |
|---|---|---|
| Provider | Twilio | Twilio |
| Billing Account | Account SID | ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
| Project/Account ID | Account SID | ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
| Service | Usage category | sms、calls、phonenumbers |
| SKU | Usage description | SMS - Outbound、Calls - Inbound |
標準ディメンションに加えて、次の Twilio 固有のラベルも利用できます。
| ラベル | 説明 |
|---|---|
| Category | Twilio の利用カテゴリ(例:sms、calls、recordings) |
| Billing Account | このアカウントに対して指定した表示名 |
| Service | 高レベルの利用グループ(Messaging、Voice、Phone Numbers など) |
Twilio 接続を削除する
-
DoiT Cloud Intelligence にサインインし、データ取り込みとインテグレーション → Assets に移動します。
-
左側のメニューから Twilio を選択します。
-
削除したいアカウントの一番右端にある三点リーダーメニュー(⋮)を選択し、Delete を選択します。
-
確認のため、Delete を選択します。