メニュー

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?

留守番電話検出

Public Beta: Answering Machine Detection

Answering Machine Detection, often called AMD, enables you to determine if a human, answering machine or fax machine has picked up an outbound voice API call and tailor your call flow accordingly. Twilio's Public Beta Answering Machine Detection system is powered by an algorithm trained on thousands of call samples. We have tuned the system defaults to balance recognition speed and accuracy, but also provide a way for you to tune the performance of the engine based on your use case, via optional API parameters. AMD is priced at $.0075 per call.

Please see the following API parameters for configuring AMD on your outbound call.

留守番電話検出を使用して通話を発信する

REST APIパラメーター

必須パラメーター
MachineDetection

Values : Enable or DetectMessageEnd
Default : none

Use Enable if you would like Twilio to return an AnsweredBy value as soon as it identifies the called party. This is useful if you would like to take a specific action (e.g. connect to an agent, play a message) for a human but hang up on a machine.

If you would like to leave a voicemail on an answering machine, specify DetectMessageEnd. In that case, Twilio will return AnsweredBy immediately when a human is detected but for an answering machine, AnsweredBy is returned only once the end of the greeting is reached. If both SendDigits and MachineDetection parameters are provided, then MachineDetection will be ignored.
オプションパラメーター
MachineDetectionTimeout

Values: 3-120
Default: 30

The number of seconds that Twilio should attempt to perform answering machine detection before timing out and returning AnsweredBy as unknown.
MachineDetectionSpeechThreshold

Values: 1000-6000
Default: 2400

The number of milliseconds that is used as the measuring stick for the length of the speech activity, where durations lower than this value will be interpreted as a human and longer than this value as a machine.
MachineDetectionSpeechEndThreshold

Values: 500-5000
Default: 1200

The number of milliseconds of silence after speech activity at which point the speech activity is considered complete.
MachineDetectionSilenceTimeout

Values: 2000-10000
Default: 5000

The number of milliseconds of initial silence after which an unknown AnsweredBy result will be returned.
        
        
        
        
        Create a call with AMD

        Webhookパラメーター

        AMD results are returned in the AnsweredBy parameter of the webhook issued to the URL you provide in the outbound call request.

        パラメーター 概要
        AnsweredBy The result of answering machine detection.

        If Enable was specified, results can be:
        machine_start, human, fax, unknown.

        If DetectMessageEnd was specified, results can be: machine_end_beep, machine_end_silence, machine_end_other, human, fax, unknown

        料金設定

        Answering Machine Detection will be charged at $.0075 per call where enabled and the called party picks up. Busy or Failed calls may engage our AMD system but will not be charged.

        AMDのベストプラクティス

        留守番電話検出機能を使用する通話のライフサイクルは以下のとおりです。 留守番電話検出機能を使用した通話の着信側のユーザーエクスペリエンスは、ユーザーが受話器を取ってから最初の音声パケットが聴こえてくるまでの遅延に影響されます。 Twilioは素早く通話を分別すべく最適化されており、そのためお客様のアプリケーション側でもTwiMLリクエストにすばやく応答することが重要になります。

        Twilio AMDの通話プログレス

        TwiMLレスポンスを最適化する

        遅延を最小化するには、TwilioからのWebhookを迅速に処理し、これに応答していることを確認するよう心がけてください。 EC2上で動作しているテストアプリケーションにおいて、弊社ではこの時間が150ミリ秒を下回っており、TwiML BinからのTwiMLの出力は100ミリ秒以内に収まっています。

        静的なTwiMLおよびPlay動詞用のメディアをキャッシュする

        Play動詞を使用する場合は、メディアをUS East 1のAWS S3にホストすることを推奨しています。 メディアをホストする場所にかかわらず、適切なキャッシュ制御ヘッダーを設定していることを確認してください。 TwilioはWebhookのパイプラインにキャッシングプロクシーを使用し、キャッシュヘッダーを持ったメディアファイルをキャッシュします。 Twilioのキャッシュからのメディア配信は10ミリ秒未満を要しますが、非常に多くのキャッシングプロクシーを実行しているため、ユーザーのファイルのコピーがこれらすべてのプロクシーのキャッシュに浸透するまで10回ほどのリクエストを要することがある点に留意してください。

        リクエストインスペクターで応答時間を計測する

        ユーザーのサーバーからTwilioへの応答時間の計測に役立てるため、リクエストインスペクターでリクエストごとのリクエスト時間をミリ秒単位で公開しています。 Console内の通話の詳細ページでクリックすることでこれを表示できます。

        リクエストインスペクターで時間を取得する

        後方互換性

        Our Public Beta Answering Machine Detection solution is not backwards compatible with our legacy solution, IfMachine. It accepts different POST parameters and AnsweredBy returns different values. IfMachine is considered deprecated and will be removed from the documentation.

        Rate this page:

        ヘルプが必要ですか?

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