メニュー

Expand
ページを評価:

Twilio アドオン

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 3rd-party capabilities, giving you the ability to choose the right technology for your needs without having to learn, test, and manage different platforms.

Add-ons are available through the Twilio Marketplace; you can choose from a list of verified Add-ons and install them in a single click. Once installed, they enhance Twilio APIs to deliver the capabilities of the installed Add-on. Examples of Add-ons include Phone number based queries for demographic & marketing data, Number fraud/spam blocking, Recordings Transcription, Message sentiment analysis, etc.

サポート対象製品

Add-ons are currently available for Programmable SMS, Calls and Recordings for Programmable Voice, and Lookups.

These Add-ons process the content that Twilio provides by tapping into the Add-on Provider’s data sources or using their technology to analyze it, and provide their results back to you as a JSON dictionary, added to the existing Twilio APIs that you use today.

Twilio の電話番号、着信メッセージの本文、および通話の録音の各コンテンツをアドオンで拡張できます。

項目 Supported Add-on Type When is the Add-on invoked アドオンが使用可能なデータ 利用モード
ルックアップ 電話番号アドオン For every Lookup that specifics Add-on parameter 電話番号 同期
Programmable SMS 電話番号アドオン For every Incoming SMS. Outbound SMS is not supported. 電話番号 同期
Programmable SMS メッセージ分析アドオン For every Incoming SMS. Outbound SMS is not supported. 電話番号、メッセージ本文 同期
Programmable Voice 電話番号アドオン For every Incoming Call. Outbound Calls are not supported. 電話番号 同期
Programmable Voice 録音分析アドオン For every Incoming Call that is recorded. オーディオファイル(シングルまたはデュアルチャネル) 非同期

サービス利用規約とデータ保存

アドオンは、TwilioによってTwilio Marketplaceで提供およびサポートされます。 アドオンのインストールプロセスの一環として、アドオンプロバイダーのサービス利用規約に合意する必要があります。 アドオンは、パートナーのサービス利用規約とプライバシーポリシーの下でライセンス提供されることに注意してください。

設定と識別子

アドオンをインストールすると、そのインスタンスが作成されて、アカウントに関連付けられます。アドオンインスタンスには、アドオンの運用に必要な設定情報が保持されます。その一部を次に示します。

設定情報
(コンソールでアクセス可能)
内容 ユーザーが設定可能 ?
有効な Twilio 製品 このアドオンがサポートし、有効になっている Twilio 製品のリスト。 はい
設定パラメーター アドオン固有の設定パラメーター。 はい
アドオンのユニークな名前 Human readable unique identifier used to invoke specific Add-ons and consume their results in the Twilio APIs.

Example: twilio_caller_identity
はい(サフィックスのみ)
アドオンインストール SID Unique Identifier for this Add-on Instance. Used for debugging and billing queries, and required for support requests when you are communicating with the Add-on provider.

Example: MC000003333333333345678901234566
いいえ

設定パラメーターをサポートするアドオンの場合、インスタンスを追加して、各インスタンスに固有の有効な Twilio 製品と設定パラメーターを設定することができます。これにより、英語テキスト分析用と仏語テキスト分析用のように、1つのアドオンに対して複数の設定を作成して呼び出すことができます。Twilio 製品および各製品でサポートされている設定パラメーターについては、個々のアドオンのドキュメントをご覧ください。

Add-ons are currently installed and enabled at an Account level. In other words, when you enable an Add-on for a specific product such as Incoming SMS, it will be invoked for every incoming SMS. Some Twilio products (such as Lookups) may require that you specify the Add-on’s unique name to invoke that Add-on, in addition to enabling them for that product via the Console.

Add-Onデータの使用

Add-onの使用を参照してください。

料金と課金

Marketplaceでは、パートナーが希望する料金をもとに設定するTwilio課金システムにおいて、従量課金を実行させることができます。 Twilio はアドオンの使用量を測定して、開発者のアカウントから料金を引き落とします。

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

  • 使用回数型
  • 使用時間型:録音分析アドオン向け
  • 購読型(近々提供予定)
  • インストール型(近々提供予定)

アドオンの料金は Marketplace カタログで、アドオンの使用量はコンソールの「Usage」ページで、それぞれ確認できます。

アドオンのサポート

アドオンは、TwilioによってTwilio Marketplaceで提供およびサポートされます。 アドオンパートナーのサポート情報(電話番号、サポートメール、予想される解決時間とプロセス)は、アドオンごとに異なり、アドオン詳細ページに記載されています。

次の表に、アドオン関連の問題について、Twilio に連絡する必要がある場合とアドオンパートナーに連絡する必要がある場合をまとめます。

Issue サポート担当
コールバックに AddOns パラメーターがない Twilio
Error Codes 61000, 61003, 61006, 61009 Twilio
Error Codes 61001, 61002, 61004, 61005, 61007, 61008, アドオンパートナー
上記以外のエラーコード Twilio
アドオンの結果が正確ではないか、またはアドオンドキュメントの記述どおりになっていない アドオンパートナー

Twilio またはアドオンパートナーに連絡して、アドオンのサポートをリクエストする場合、問題の特定と解決に役立つ次の情報を提供する必要があります。

Identifier 内容 確認方法
アドオンのユニークな名前 Human readable unique identifier used to invoke specific Add-ons and consume their results in the Twilio APIs.

Example: twilio_caller_identity
コンソールの「Installed Add-ons」セクションを参照します。
リクエスト Sid The unique identifier of a particular Add-on request. Used for billing and debugging.

Example: XR000009775bb6d43d1cabc4955723fae1
Twilio から受信する API レスポンスまたはコールバックに含まれるアドオンの結果を参照します。
アドオンインストール SID A unique identifier for a developers install of an Add-on.

Example: MC000003333333333345678901234566
コンソールの「Installed Add-ons」セクションを参照します。

Examples of Add-on Usage

There are a variety of ways to leverage Add-ons and consume the data they return. In this section, we have an example utilizing the Prove TCPA Compliance Add-on, along with an example of a modified SMS Webhook having a new POST parameter containing data returned from the Add-on. For more information on how to install and begin working with Add-ons, visit Add-ons Quickstart.

Add-ons are only supported by the most recent major version of the Twilio Helper Libraries.

        
        
        
              
              
              
              With add-ons enabled, SMS webhooks will receive a new POST parameter, a JSON-encoded string called "AddOns" - this is an example of formatted JSON you'd receive in that webhook request.

              Webhook JSON of Add-on Enabled Incoming SMS

              With add-ons enabled, SMS webhooks will receive a new POST parameter, a JSON-encoded string called "AddOns" - this is an example of formatted JSON you'd receive in that webhook request.
              ページを評価:
                    
                    
                    

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

                    Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

                    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