メニュー

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?

タスクの作成と予約の受諾: REST APIを使用してタスクを作成する

TaskRouterのタスクライフサイクルを思い出してください。

タスクを作成 → 適格なワーカーが対応可能になる → ワーカーを予約 → 予約を受諾 → タスクをワーカーに割り当てる 。

最初のタスクを作成する前に、ワーカーの Alice が対応不可のアクティビティー状態であることを再度確かめてください。ここでは Bob が対応できないスペイン語のタスクを作成するため、現時点では Bob のアクティビティー状態は問題になりません。

ワークスペースをTaskRouter Webポータルで開いた状態で、「Workers」をクリックした後、「Alice」をクリックして、アクティビティーを「Offline」に設定するように編集します。 ワーカーは以下のようになります。

現実をシミュレーションするために、ウェブポータルではなく、REST API を使ってタスクを作成します。「create-task.php」という名前の PHP ファイルを作成して、以下のコードを追加します。{} を Twilio AccountSid、Twilio AuthToken、WorkspaceSid、WorkflowSid に書き換えてください。

        
        
        
        

        または、コマンドラインユーティリティー curl を使ってタスクを作成することもできます。このユーティリティーは、Mac または Linux のどのワークステーションにもあるはずです。この場合も、{} を各自の対応するクレデンシャルと SID に書き換えてから、ターミナルで以下のコマンドを実行してください。

        curl https://taskrouter.twilio.com/v1/Workspaces/{WorkspaceSid}/Tasks \
        --data-urlencode Attributes='{"selected_language": "es"}' \
        -d WorkflowSid={WorkflowSid} \
        -u {AccountSid}:{AuthToken}
        

        Twilio AccountSidおよびAuthTokenは、TaskRouterの「Getting Started」ページで「show API credentials」をクリックすると、表示されます。

        If you don't have curl, you can run this request using an HTTP test tool like Insomnia or using the Task creation dialog in the TaskRouter web portal: with your Workspace open, click 'Tasks' then 'Create Task'.

        新たに作成したタスクをTaskRouter Webポータルに表示するには、ワークスペースを開いた状態で、メインナビゲーションで「Tasks」をクリックします。 curl リクエストで指定した属性に基づき、「Customer Care Requests - Spanish」タスクキューにタスクが追加されています。 このタスクキューに該当する対応可能なワーカーがいないため、割り当てステータスは「pending」になっています。

        適格なワーカーを対応可能にする

        もう一度TaskRouterのタスクライフサイクルを見てみましょう。

        タスクを作成 → 適格なワーカーが対応可能になる → ワーカーを予約 → 予約を受諾 → タスクをワーカーに割り当てる。

        最初のステージである「タスクを作成」は完了しました。自動的なタスク予約をトリガーするため、次のステップでは適格なワーカー(このケースでは Alice)をオンラインにします。

        ワークスペースをTaskRouterウェブポータル で開いた状態で、「Workers」をクリックした後、「Alice」をクリックして、アクティビティーを「Idle」に設定するように編集します。

        「Save」をクリックすると、Twilio は Alice とタスクの間に予約を作成します。これにより、前のステップでセットアップした割り当てコールバック URL でウェブホックリクエストが送られます。ngrok をお使いの場合は、ウェブブラウザーで http://localhost:4040 を開くと、Twilio がサーバーに発行したリクエストの詳しいログ(予約を受諾するかどうか決定するためにサーバーが使うあらゆるパラメーターなど)が表示されます。

        これで、タスク予約ライフサイクルがワンステップ先に進みました。

        タスクを作成 → 適格なワーカーが対応可能になる → ワーカーを予約 → 予約を受諾 → タスクをワーカーに割り当てる。

        次は、予約を受諾する番です。

        次:REST API を使って予約を受諾する »

        Rate this page:

        ヘルプが必要ですか?

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