Conversion API

Conversion APIを使用すると、Vonageに以下の信頼性を伝えることができます。 2FA 通信。変換データをVonageに送り返すことで、より迅速で信頼性の高いメッセージ配信が可能になります。

Vonageは、この変換データを、以下のデータとともに使用します。 配達受領書（DLR） Adaptive Routing™（アダプティブ・ルーティングアダプティブ・ルーティング・アルゴリズムは、特定の瞬間に SMS や音声通話を配信するための最適なキャリア・ルートを自動的に決定します。ほとんどの場合、DLR は、メッセージが受信者に配信されたことを確 認するものです。しかし、すべてのキャリアのDLRが信頼できるわけではなく、まったく提供しないキャリアもあります。そのため、変換データは、ルート品質の最良の指標となります。

コンバージョンデータを送信する前に

Conversion APIへのアクセスは、Vonageアカウント作成時のデフォルトでは有効になっていません。Conversion APIをご利用になるには、まず以下の宛先に電子メールを送信してアクセスをリクエストする必要があります。 サポート.

コンバージョンデータを当社に送信する場合、お客様は以下を区別する必要があります。 2FA メッセージやその他のコミュニケーション。例えば イベントベースのアラート またはマーケティング・メッセージ。そのためには APIキー を2FA用のConversion APIへのリクエストの認証に使用し、それ以外には別のAPIキーを使用する。

コンバージョンデータの報告

次の図は、Conversion APIのワークフローを示している：

変換データをVonageに送信します：

1. 以下の方法で2FAワークフローを開始する。 2FAリクエストの送信

2. Vonageはユーザーにテキストまたは音声メッセージを送信します。

3. ユーザーがあなたのメッセージまたは確認リクエストに返信します。

4. Conversion APIを即座に送信する。 リクエスト で識別されるメッセージに関する情報を持つ。 message-id:

   widgets.copy

   //You use the information you received in response from a request to SMS API or Call API.
   
   var https = require('https');
   
   var data = JSON.stringify({
    api_key: 'API_KEY',
    api_secret: 'API_SECRET',
    message-id: message-id,
    timestamp: yyyy-MM-dd HH:mm:ss,
    delivered: true_or_false
   });
   
   var options = {
    host: 'api.nexmo.com',
    path: '/conversions/sms',
    port: 443,
    method: 'POST'
   };
   
   var req = https.request(options);
   
   req.write(data);
   req.end();
   
   var responseData = '';
   req.on('response', function(res){
    res.on('data', function(chunk){
      responseData += chunk;
    });
   
   });
   

   重要:これらのリクエストは、ユーザーが2FA招待に返信した後、常にできるだけ早く送信すべきで、まとめて送信するのを待つべきではありません。アダプティブルーティングは、最適なルーティング決定を行うために、タイムリーなコンバージョンデータに依存します。