メニュー

Expand
Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Marketplace の商品

Marketplace で販売される主力製品は、アドオンです。

アドオンは、開発者による Twilio API の使い方を広げる、組み込み済みのパートナーテクノロジーです。アドオンを使用すると、Twilio とサードパーティーの能力を結集して、短期間で豊富な機能を備えたコミュニケーションエクスペリエンスを構築できます。開発者は、ニーズに合わせて適切なテクノロジーを選択するだけでよく、さまざまなプラットフォームを学習、テスト、および管理する必要はありません。

アドオンは Twilio Marketplace から入手できます。開発者は、検証済みのアドオンのリストから目的のものを選択し、ワンクリックでインストールできます。アドオンをインストールすることで、電話番号のスパムスコアが返されたり、メッセージのセンチメント分析が提供されたりするなど、パートナーの機能が有効になり、Twilio API を拡張できます。

関数レベルで見ると、アドオンはパートナー API をパッケージ化します。また、Twilio が提供するコンテンツに、パートナーのデータソースまたはコンテンツ分析テクノロジを使用して、注釈を付けます。例として、電話番号による該当する層とマーケティングデータのクエリ、番号詐欺/スパムブラックリスト、録音トランスクリプション、メッセージセンチメント分析などがあります。

現在、アドオンパートナーは、Twilio の電話番号、着信メッセージの本文、および通話の録音の各コンテンツを利用できます。

アドオンのタイプ 統合ポイント パートナーが利用可能なデータ 利用モード
電話番号アドオン ルックアップ、着信 SMS、着信音声通話 電話番号(単一、発信元、発信先) 同期
メッセージ分析アドオン 着信SMS 電話番号、メッセージ本文 同期
録音分析アドオン 録音 音声ファイル(単一チャンネル) 非同期

開発者は、アドオンを選択して、自分のアカウントに合わせて設定することによって、使用できるようにします。その後は、サポート用 Twilio API を使用したときにアドオンが呼び出されるように、指定することができます。

Add-onのフロー

画像の alt テキスト

料金と課金

Marketplaceでは、パートナーが希望する料金をもとに設定するTwilio課金システムにおいて、従量課金を実行させることができます。 Twilioはパートナーアドオンの使用量を測定して、開発者のアカウントから料金を引き落とします。 課金額から取引手数料を差し引いた額が、定期的に請求書を通じてパートナーに支払われます。

Marketplace でサポートしているアドオン課金モデルを次に示します。

  • 使用回数型

  • 成功報酬型(未使用):レスポンスの特定の JSON 要素が存在しないことと HTTP ステータスコードに応じた条件付き課金

  • 使用時間型:トランスクリプション/録音アドオン向け

パートナーサービスのパッケージ化によるアドオンの作成

Twilioは、パートナーが希望する1つまたは複数のアドオンをMarketplaceで提供できます。 1つのアドオンに1つのサービス / APIをパッケージ化するか、または1つのサービス / APIを使用目的別に異なる料金を設定した複数のアドオンとして提供するかを選択できます。 後者の例として、データセットが異なる場合(企業情報または消費者情報)やトランスクリプションの言語が異なる場合があります。

パートナーアカウント

現在、Twilio はパートナーの商品ごとに 1 つのマスターアカウントをサポートします。API リクエストはすべて、このアカウントを使用して実行されます。

たとえば、電話番号を受け取り、それを使って綴ることができる英語の語呂合わせを返すウェブサービスを提供するとします。Twilio の利用者は誰でも Twilio ルックアップ API でこのサービスを使用して、語呂合わせの候補を表示できます。1 回ルックアップするごとに 0.0001 ドルを課金します。

これが次の API で提供されるとします(クレデンシャルについてはとりあえず無視します)。

https://www.example.com/twilio_phone_number_example  -d "e164=+18778894546"

この結果、次のレスポンスが得られます。

{
"anagrams": ["+18778TWILIO", ...]
}

このサービスは、Marketplace のアドオンとして「Anagram」という名前で提供します。このアドオンには、すべてのマーキングと付随するドキュメント、Twilio の電話番号ルックアップサービスの仕様に従ったウェブサービスの URL が指定されている設定が含まれています。Twilio 開発者は、このサービスを見つけると、自分のアカウントにインストールします。これにより、電話番号の購入/プロビジョニング、着信する通話またはメッセージの受信、または発信する通話またはメッセージの発信の際に、適切であれば、ルックアップ API で Anagram アドオンを使用できるようになります。

curl -X GET https://lookups.twilio.com/v1/PhoneNumbers/18778894546\
-d "AddOns=partner_anagrams" -u "{TwilioAccountSid}:{TwilioAuthToken}"

これは、次のボディーを含む 200 OK レスポンスを返します。

{
    "country_code": "US",
    "phone_number": "+18778894546",
    "national_format": "1 (877) 889-4546",
    "url": "https://lookups.twilio.com/v1/PhoneNumber/+551155256325",    
    "add_ons": {  
           "status": "successful",
           "message": null,
           "code": null,
           "results": {      
                    "partner_anagrams": {
                           "request_sid": "XRc1479687aadf64c62e6ab2b6e0077a1a",
                           "status": "successful",
                           "message": null,
                           "code": null,
                           "result": {
                                   "anagrams": ["+18778TWILIO"]
                           }                           
                    }
            }
    }
}

呼び出されると、Twilio が開発者の HTTP サービスを呼び出して、リクエストされた電話番号を POST します。結果を受け取ると、その中の JSON ボディーを取り出して、リクエストされた他のタイプとともに、レスポンスのペイロードに格納します。

Rate this page:

ヘルプが必要ですか?

誰しもが一度は考える「コーディングって難しい」。そんな時は、お問い合わせフォームから質問してください。 または、Stack Overflow でTwilioタグのついた情報から欲しいものを探してみましょう。