Level up your Twilio API skills in TwilioQuest, an educational game for Mac, Windows, and Linux. Download Now

メニュー

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?

Twilio アドオン

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

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

サポート対象製品

現在、アドオンは、プログラマブル SMS、プログラマブル Voice - 通話 & 録音、およびルックアップで使用可能です。

アドオンは、Twilio がこれらの製品を通じて提供するコンテンツを、アドオンプロバイダーのデータソースまたはコンテンツ分析テクノロジーを使用して処理し、結果を JSON ディクショナリーとして、現在お客様が使用している既存の Twilio API に追加する形で呼び出し元に返します。

アドオンの例として、電話番号による該当する層とマーケティングデータのクエリ、番号詐欺/スパムブラックリスト、録音トランスクリプション、メッセージセンチメント分析などがあります。

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

| Product | Supported Add-on Type | When is the Add-on invoked | Data available to Add-on | Consumption Mode |---|---|---|--- | Lookups | Phone Number Add-on | For every Lookup that specifics Add-on parameter | Phone Numbers | Synchronous | Programmable SMS | Phone Number Add-on | For every Incoming SMS. Outbound SMS is not supported. | Phone Numbers | Synchronous | Programmable SMS | Message Analysis Add-on | For every Incoming SMS. Outbound SMS is not supported.| Phone Numbers, Message Body | Synchronous | Programmable Voice | Phone Number Add-on | For every Incoming Call. Outbound Calls are not supported. | Phone Numbers | Synchronous | Programmable Voice | Recording Analysis Add-on | For every Incoming Call that is recorded. | Audio File (single & dual channel)| Asynchronous

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

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

設定と識別子

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

設定情報
(コンソールでアクセス可能)
内容 ユーザーが設定可能 ?
有効な Twilio 製品 このアドオンがサポートし、有効になっている Twilio 製品のリスト。 はい
設定パラメーター アドオン固有の設定パラメーター。 はい
アドオンのユニークな名前 人間が読みやすいユニークな識別子。Twilio API で特定のアドオンを呼び出して、その結果を利用するために使用します。

例:twilio_caller_identity
はい(サフィックスのみ)
アドオンインストール SID このアドオンインスタンスのユニークな識別子です。デバッグおよび課金クエリに使用します。また、アドオンプロバイダーとやりとりする際に、サポートリクエストで指定する必要があります。

例:MC000003333333333345678901234566
いいえ

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

注意 :現在、アドオンは、アカウントレベルでインストールして、有効になります。言い換えると、着信 SMS などの特定の製品でアドオンを有効にした場合、SMS が着信するたびにそのアドオンが呼び出されます。 一部の Twilio 製品(ルックアップなど)は、コンソールでその製品に対してアドオンを有効にした上で、アドオンを呼び出すためにそのユニークな名前を指定する必要があります。

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 内容 確認方法
アドオンのユニークな名前 人間が読みやすいユニークな識別子。Twilio API で特定のアドオンを呼び出して、その結果を利用するために使用します。

例:twilio_caller_identity
コンソールの「Installed Add-ons」セクションを参照します。
リクエスト Sid 特定のアドオンリクエストのユニークな識別子です。課金とデバッグに使用します。

例:XR000009775bb6d43d1cabc4955723fae1
Twilio から受信する API レスポンスまたはコールバックに含まれるアドオンの結果を参照します。
アドオンインストール SID アドオンの開発者インストールのユニークな識別子。

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

サンプル

Note that Add-ons are supported in the Next gen Twilio helper libraries only.

        
        
        
        
              
              
              
              
              Use cURL to make a Lookup API request with a specific add-on to use specified in the query string.

              Lookup with provider_caller_identity Add-on

              Use cURL to make a Lookup API request with a specific add-on to use specified in the query string.
                    
                    
                    
                    
                    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.

                    Incoming SMS with Add-ons enabled (Webhook JSON format)

                    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.
                    Rate this page: