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

このクイックスタートでは、アドオンの主な機能について説明して、皆さんが今日から使い始めることができるようにします。では、はじめましょう !

アドオンのインストール

アドオンは、コンソールから有効にします。インストールされたアドオンは、電話番号のスパムスコアを返したり、メッセージのセンチメント分析を提供したりして、特定の Twilio API を強化します。ここでは、Whitepages Pro という名前の SMS 用アドオンを有効にします。

Marketplace のアドオンカタログ

Inside the new Add-on catalog you can see all of the available API Add-ons.

アドオンの詳細

アドオンの 1 つをクリックすると、そのアドオンの詳細が表示されます。この画面では、次の 2 点に注目します。

  1. What API's this will be enabled on-- listed under Supported Products
  2. Whether or not the Add-on is Installed or not

Let's go ahead and click Install Now.

インストール済みのアドオン

Now by clicking on Add-ons > Installed we can see which Add-ons we've enabled. Be sure to check the box next to "Incoming SMS Message".

よくできました。これで、強化された新しい SMS API を使用できるようになりました。次は、コードを見てみましょう。

Whitepages アドオンの使用

Whitepages Pro アドオンは、現在すべての着信 SMS メッセージに対して有効です。これは、実際にその動作を確認するために、SMS を受信する必要があることを意味します。

Let's update one of your phone numbers to respond with a custom message that includes some of the Whitepages data. To do that go to your Phone Numbers console:

着信 SMS webhook の更新

Now let's update the Messaging webhook to point to: https://shielded-earth-16326.herokuapp.com/

This url generates some TwiML that responds with a Message which includes White Pages Pro information about the From phone number sent with the Twilio Request. This information is identified by the Add-on Unique Name which is visible from the Add-on detail page in your console.

設定を保存して、試してみましょう ! 電話を取り出して、更新した電話番号宛に SMS を送信します。正常なら、自分の電話番号に関する詳細情報を含むレスポンスを受け取ります。

これで、着信 SMS を受信するたびに、Twilio は HTTP リクエストの AddOns パラメーターに情報を追加するようになります。次に、リクエストの例を示します。

{
  "status": "successful",
  "message": null,
  "code": null,
  "results": {
    "whitepages_pro_caller_id": {
      "code": null,
      "message": null,
      "request_sid": "XRb57cab3a3c0cfe0bb50f093d9bd3b0a3",
      "result": {
        "alternate_phones": [
          "8003361327"
        ],
        "associated_people": [],
        "belongs_to": [
          {
            "age_range": null,
            "firstname": null,
            "gender": null,
            "id": "Business.7e29cf66-8bf2-4812-829d-356654b5b3d3.Durable",
            "lastname": null,
            "link_to_phone_start_date": null,
            "middlename": null,
            "name": "Twilio Inc",
            "type": "Business"
          }
        ],
        "carrier": "Twilio",
        "country_calling_code": "1",
        "current_addresses": [
          {
            "city": "San Francisco",
            "country_code": "US",
            "delivery_point": "MultiUnit",
            "id": "Location.88e44955-805c-455a-99da-d7444ca5c484.Durable",
            "is_active": true,
            "lat_long": {
                "latitude": 37.783382,
                "longitude": -122.395714,
                "accuracy": "RoofTop"
            },
            "link_to_person_start_date": null,
            "location_type": "Address",
            "postal_code": "94107",
            "state_code": "CA",
            "street_line_1": "Address",
            "street_line_2": null,
            "zip4": "3624"
          }
        ],
        "error": null,
        "historical_addresses": [],
        "id": "Phone.4d796fef-a2df-4b08-cfe3-bc7128b6f6bb.Durable",
        "is_commercial": true,
        "is_prepaid": false,
        "is_valid": true,
        "line_type": "NonFixedVOIP",
        "phone_number": "5558675309",
        "warnings": []
      },
      "status": "successful"
    }
  }
}

Whitepages Pro は、着信音声通話番号にも有効です。これで、音声通話番号または SMS 番号に対してアドオンを有効にする方法がわかりました。得られた情報は、Twiilo のリクエストの新しい AddOn プロパティにアクセスするだけで、簡単に利用できます。

次に、特定の API 呼び出しに付随するアドオン情報の使い方について見てみましょう。

Payfone Lookups アドオンの使用

Another nifty Add-on comes to us from Payfone, who protects your business from hefty fines for texting the wrong number under TCPA (Telephone Consumer Protection Act) regulations. The Payfone Add-on can quickly tell you if the number you are about to send an SMS to is active and still owned by your customer, with 100% reliability.

To use this Add-on we'll need to install it just like we did with Whitepages Pro. This time in your Add-on catalog we want to install: Lookups > Payfone TCPA Compliance.

Now that we've installed the Payfone Add-on we can make a request using the Twilio Lookups API and ask for the TCPA Compliance information with the rest of the phone number details.

コードは次のようになります。

        
        
        
        

        素晴らしいですね。約 5 分間のうちに、2 つのアドオンを有効にして、顧客に関する新しいデータを調査し、Marketplace の新しいアドオンカタログの使い方について学習できました。

        アドオンの使い方の詳細については、アドオンのリファレンスをご覧ください。

        Rate this page:

        ヘルプが必要ですか?

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