メニュー

Expand
ページを評価:

Run Function

Run function widget

説明:

Run Functionを使用すると、Twilio Function(クラウド上で実行される軽量でサーバーレスなコード)を実行できます。 このWidgetを使用してStudioのWidgetと協調動作するビジネスロジックを記述してアプリケーションを仕上げます。

Functionを呼び出す際の変数の使用にあたっては、下記の2つの選択肢があります: (!) Flowの変数をパラメーターとしてFunctionに渡す(例: flow.data.foo)ことができます。 そして (2) Functionから返されるデータ(TwiMLまたはJSONを返すことができます)をFlow変数に設定できます。

Note: For unique use cases, the Run Function widget can return custom TwiML to enhance your Studio Flow.

必須の構成

Function Widgetで唯一必須の構成は、呼び出したいFunctionのURLのみです。 ドロップダウンから選択するか、Functionを名前で検索できます。

Functions are organized by the service they were created in. For Functions created via the Console UI, select the "Default" service. For Functions created via the Serverless API, select the service and environment where the Function was deployed.

Run Function can only invoke Public or Protected Functions. Learn more about Function Visibility.

名前

概要

初期値

Function URL

The URL of the Function you’d like to invoke. The Function must be either Public or Protected.

Hello SMS

なし

オプションの構成

Function Widgetにはオプションの構成がいくつかあります:

名前

概要

初期値

Function Parameters

key/valueの組みとして表現される、Functionに渡される0個以上の追加パラメーターです。 文字列定数と変数がサポートされます。

なし

Using a Function:

The example below is of a Function that uses data sent from Twilio Studio's Run Function Widget and responds with JSON.

Transitions:

このWidgetにはTransitionをトリガーする2つのイベントがあります。

名前

概要

success

Functionの返りに成功した場合 (HTTP 20X)

Fail

FUnctionの返りに失敗した場合 (またはエラーがありました)

レスポンス:

The HTTP response from the Function must return a 2xx status code within 10 seconds, and the response body must not exceed 64kB.

レスポンス Recommendation 注釈
Status Code 200 or 204 3xx redirection is supported. 4xx or 5xx status code will transition to failed in the widget.
ContentType application/json Content-Type header is not required if Status Code is 204 No Content. Other content types are supported, such as plain text or XML. But only application/json objects (e.g. {"foo":"bar"}) will be automatically parsed into Studio variables.
Body valid JSON Body content must match the Content-Type header.
Response Time 10 seconds or less Since Twilio Functions support up to a 10 second execution limit, Studio will timeout the request at 10 seconds and transition to failed in the widget.
Response Size Maximum 64kb Studio can only process responses up to 64kB.


変数:

TwiML

If your function returns Twiml, the twiml will be returned to the calling client.

Json

If your function returns valid JSON, you will be able to access it via widgets.MY_WIDGET_NAME.parsed.

For example, if you return: { "message": "Hi", "person": { "name": "Bob", "age": 40 } }, you can reference that data in subsequent widgets as:

widgets.MY_WIDGET_NAME.parsed.message

widgets.MY_WIDGET_NAME.parsed.person.name

widgets.MY_WIDGET_NAME.parsed.person.age

For all return types, you will have access to the following variables:

widgets.MY_WIDGET_NAME.body

widgets.MY_WIDGET_NAME.status_code

widgets.MY_WIDGET_NAME.content_type

ページを評価:

ヘルプが必要ですか?

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. How could this documentation serve you better?

        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