Vonage Reports APIが一般公開されました。

はじめに

この度 Vonage Reports APIをご紹介いたします。通信データを一元化されたプラットフォームで確認、利用できるAPIです。複数のソースからデータを取得し、それらをつなぎ合わせる代わりに、通信の一貫したビューを提供する単一のAPIを持つようになり、より速く、よりシンプルで、より簡単に作業できるようになりました。

主な特徴

Reports APIを使用すると、配送状況の追跡、請求情報へのアクセス、潜在的な詐欺の検出、さらにはライブデータを独自のダッシュボードにフィードすることができます。つまり、コミュニケーションを監視・管理するための唯一のハブなのです。

セットアップ不要

APIはすべてのVonage顧客のために行く準備ができています。クエリを開始するにはAPIキーとシークレットが必要です。

完全なデータ概要

Reports APIは、すべての通信データを表示および管理するための単一のインターフェイスを提供します。以下のような幅広いVonage製品の利用データを統合します：

• トラフィックコントロールを含むSMS API

• Voice API (In-App Voice、WebSocketコール、Text-to-Speech、ASR、AMD、SIP、PSTN)

• メッセージ API (WhatsApp、RCS、SMS/MMS、Viber、Facebook Messenger、Instagram)

• Verify

• ネットワークAPI（ナンバー・インサイトを含むアイデンティティ・インサイト）

• Video API

柔軟な料金オプション

2つの支払い方法を用意していますので、最適な方法をお選びください：

• ペイ・アズ・ユー・ゴー:小規模なデータセットや臨時のクエリに最適です。検索されたレコードごとに料金をお支払いいただきます。

• 無制限プラン:大容量ユーザー向けの月額定額プラン。月間100万件以上、年間1,200万件以上のレコードを取り込む場合におすすめです。

データを取り出す2つの方法

• 同期クエリは、迅速で小規模なレポート（～10,000レコードまで）に最適です。

• 非同期クエリーは、一度に最大700万レコードまでの大きなレポート用に設計されています。

高度なフィルタリング

日付範囲、イベントID、電話番号、またはサブアカウントでフィルタリングし、必要なものを正確に取得します。

サブアカウント管理

あなたのビジネスに複数のサブアカウントがある場合、それぞれを個別にクエリできます。これにより、大規模なクエリがスピードアップし、データが整理されます。

リアルタイムの可用性

データは、製品によって多少の違いはあるが、ほとんどがリアルタイムで入手できる：

• Voice API：通話が終わるとすぐにデータの準備ができる。

• Verify API：ワークフローが完了すれば、データは準備完了です。チャンネルデータは即座に利用可能

• Video API：処理後30～120分で利用可能。

• 他のほとんどのAPI更新は即座に行われる。

実際の使用例

Reports APIは、多くの一般的な課題を解決するのに役立ちます：

• 利用・請求レポート：通話明細やメッセージログにアクセスして請求書を検索し、コストを監視します。

• 配信ステータスの追跡：データセット全体を取得することなく、メッセージや通話のステータスを即座に確認できます。

• 財務管理：複数の顧客を管理する再販業者に最適なサブアカウント用の請求書を作成します。

• キャンペーン管理：ほぼリアルタイムでパフォーマンスを追跡し、それに応じてキャンペーンを調整します。

• 不正検知：不正のパターンを特定し 不正のパターンを特定し フラウド・ディフェンダー製品です。

• リアルタイム・ダッシュボード：ライブの利用データをBIツールやカスタム・ダッシュボードに取り込み、即座に洞察を得ることができます。

ベストプラクティス

Reports APIを最大限に活用するためのヒントをいくつか紹介します：

• フィルターによるリクエストの最適化：フィルター（日付範囲、ID、電話番号など）を利用して必要なデータのみを取得することで、コスト削減と効率化を実現します。

• メッセージ・ステータス監視のベスト・プラクティスメッセージステータスを監視するベストプラクティス idパラメータを使用してレポートを要求する。

• すべてのサブアカウントでのリクエストの最適化：10以上のサブアカウントを持つマスターアカウントについては、まずサブアカウントAPIを介してサブアカウントリストを取得し、その後、各サブアカウントとマスターアカウント自体について別々にReports APIを呼び出します。

• 価格設定と従量課金を理解する：料金はレポートごとにレコードごとに適用されるため、Analyticsダッシュボードを使用してCDRボリュームを見積もり、不要な重複リクエストを回避してください。

• 制限の処理：フィルタを使ってリクエストをチャンクすることで、非同期レポート・サイズの制限1GBとレート制限（非同期リクエスト5回/秒、同期リクエスト10回/秒）内に収まります。

• 同期方式と非同期方式の選択：小規模でリアルタイムのデータが必要な場合は同期方式を使用し、大規模なデータセットや複数のサブアカウントにまたがるCSVエクスポートには非同期方式を使用します。

• API使用状況を効率的に監視します：社内で使用状況を追跡するか、無料の REPORTS-USAGE 製品を使用して、過去 13 か月間の Reports API アクティビティを分析し、パフォーマンスを最適化します。

それぞれの詳細については ドキュメンテーション.

結論

Vonage Reports APIは現在利用可能で、すべての通信分析を追跡、分析、管理することができます。キャンペーンの最適化、コスト管理、課金と利用追跡の自動化、不正行為の検出など、このレポート用APIは完全な可視性とコントロールを提供します。Reports APIを使い始めるには、次のドキュメントをご覧ください。 Reports API ドキュメントをご覧ください。