メニュー

Expand
ページを評価:

Marketplace の商品

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

Add-ons are pre-integrated partner technologies that let developers do more with the Twilio API. They make it possible to quickly build rich communications experiences by combining Twilio and third-party capabilities by giving you the ability to choose the right technology for your needs without having to learn, test, and manage different platforms.

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

At a functional level, Add-ons package Partner APIs and annotate the content that Twilio provides by tapping into the Partner’s data sources or by using Partner’s technology to analyze the content. Examples include Phone number based queries for demographic & marketing data, Number fraud/spam block list checking, Recordings Transcription processing, Message sentiment analysis, etc.

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

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

Developers select an Add-on and configure it for their account which makes it available for use. They can then specify that they want it invoked when using a supported Twilio API.

Add-onのフロー

画像の alt テキスト

料金と課金

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

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

  • 使用回数型

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

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

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

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

パートナーアカウント

Currently, Twilio supports one master account per Partner offering, and will use that to make all API requests.

Let’s say you have a web service that takes a phone number and returns all the english mnemonics you can spell with it. You’d like to let any Twilio customer access your service via the Twilio Lookup API to see potential results and you want to charge $0.0001 per lookup.

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

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

This call results in the following JSON response :

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

You would deliver this service as a marketplace Add-on called ‘Anagram’ which contains all the marketing and documentation collateral. The Add-on would also provide configuration pointing at the URL for a web service that confirms to Twilio's specification for Phone Number lookup services. A Twilio developer finds and installs this service on their account. They would now have the ability to use the Anagram Add-on in the Lookup API when buying/provisioning phone numbers, receiving incoming calls or messages, or making outgoing calls or messages, if appropriate.

A call to the Twilio Lookup API with the Anagram Add-on would look like this:

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

The call would result in a 200 OK response with the following response body:

{
    "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"]
                           }                           
                    }
            }
    }
}

When invoked, Twilio will call out to your HTTP service and post the requested phone number. Upon receiving the results, it will take the JSON body of those results and include them in the response payload along with the other information requested.

ページを評価:

ヘルプが必要ですか?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Community Forums or browsing the Twilio tag on Stack Overflow.

        
        
        

        フィードバックくださりありがとうございます!

        We are always striving to improve our documentation quality, and your feedback is valuable to us. Please select the reason(s) for your feedback or provide additional information about how we can improve:

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        ステップ1

        Get link

        Get a free personal referral link here

        ステップ2:

        Give $10

        Your user signs up and upgrade using link

        ステップ3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more