How to initiate an inbound call to Smart Speech Interaction-Voice Service(VS)-阿里云帮助中心

This topic describes how to initiate a Smart Speech Interaction inbound call in the Voice Service console.

Prerequisites

Register an Alibaba Cloud account and complete enterprise entity verification.
Activate Voice Service.
Add enterprise qualification and have it approved.
Request a real number: Request a real number in the Voice Service console. For more information, see Request a real number.
You have enabled the Smart Speech Interaction product feature on the General Settings > Service Activation tab in the Voice Service console.

Background

You must use the Smart Speech Interaction inbound API with the Smart Speech Interaction outbound call callback HTTP API. The voice platform uses the HTTP protocol to push real-time speech-to-text transcriptions. The platform sends status updates, including exception statuses, even if the user does not respond. In your response to these messages, you can instruct the platform on the next action, such as playing a voice message, stopping the current playback, transferring the call to a live agent, or hanging up.

Workflow

The following diagram shows the workflow for a Smart Speech Interaction inbound call:

Step 1: Add an inbound call configuration

Log on to the Voice Service console. In the left-side navigation pane, choose General Settings.
On the Call Settings tab, click Add Inbound Call Configuration.
For Configuration Type, select Smart Speech Interaction Inbound Call. Configure the remaining parameters as needed.

For detailed instructions, see Add an inbound call configuration for a specific number.

Step 2: Configure the callback URL

In the left-side navigation pane, choose General Settings.
On the Callback URL tab, turn on the Smart Speech Interaction Callback URL switch.
Follow the on-screen instructions to configure the response information and receiving address.
Note
The voice platform sends real-time speech-to-text results to this address. Your application must then respond with the next action to be performed.

For detailed instructions, see Configure callback interfaces.

Step 3: Initiate a call

When a user calls the specified number, the system automatically invokes the Smart Speech Interaction inbound call callback HTTP API, sending the real-time speech-to-text transcription of the user's audio to your application. Your application then responds to the voice platform, specifying the next action. This completes the automated interaction between the bot and the user.

Step 4: Query call details

You can query call details using either of the following methods:

Query details in the console: In the console, choose Business Statistics > Voice Record Query. Filter by voice service type, time, calling number, called number, and other criteria to find and view task details.
Query using an API: Call the QueryCallDetailByCallId API to query the details of a specific call.

Next steps

To receive receipt messages from Voice Service, use a Message Service (MNS) message queue or enable batched pushes over HTTP. For more information, see Receipt message overview and configuration workflow.