Compartir a través de

Incorporación de voz a mensajes con Bot Connector API

  • Artículo

Si va a crear un bot para un canal habilitado para voz, puede construir mensajes que especifiquen el texto que va a hablar el bot. Para intentar influir en el estado del micrófono del cliente, puede especificar una sugerencia de entrada para indicar si el bot acepta, espera o ignora la entrada del usuario.

Puede configurar el bot para permitir que las aplicaciones cliente se comuniquen con él mediante el canal Direct Line de Voz.

Especificación del texto que dirá el bot

Para especificar el texto que dirá el bot en un canal habilitado para voz, establezca la propiedad speak dentro del objeto Actividad que representa el mensaje. Puede establecer la propiedad speak en una cadena de texto sin formato o en una cadena con formato de lenguaje de marcado de síntesis de voz (SSML), un lenguaje de marcado basado en XML que le permite controlar diversas características de la voz del bot, como la voz, la velocidad, el volumen, la pronunciación, el tono y mucho más. Si el canal no es compatible, el mensaje se entrega como texto.

La siguiente solicitud envía un mensaje que especifica el texto que se mostrará y el texto que se dirá, e indica que el bot espera la entrad del usuario. Especifica la speak propiedad con formato SSML para indicar que la palabra "sure" debe hablarse con una cantidad moderada de énfasis. En esta solicitud del ejemplo, Direct Line representa el identificador URI de base; el identificador URI de base para las solicitudes que emite el bot puede ser distinto. Para obtener más información sobre cómo establecer el URI base, consulte API Reference (Referencia de la API).

POST https://smba.trafficmanager.net/teams/v3/conversations/abcd1234/activities/5d5cdc723
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
    "type": "message",
    "from": {
        "id": "12345678",
        "name": "sender's name"
    },
    "conversation": {
        "id": "abcd1234",
        "name": "conversation's name"
   },
   "recipient": {
        "id": "1234abcd",
        "name": "recipient's name"
    },
    "text": "Are you sure that you want to cancel this transaction?",
    "speak": "<speak version=\"1.0\" xmlns=\"http://www.w3.org/2001/10/synthesis\" xml:lang=\"en-US\">Are you <emphasis level=\"moderate\">sure</emphasis> that you want to cancel this transaction?</speak>",
    "inputHint": "expectingInput",
    "replyToId": "5d5cdc723"
}

Sugerencias de entrada

Al enviar un mensaje en un canal habilitado para voz, también puede expresar el estado previsto del micrófono del cliente mediante la inclusión de una sugerencia de entrada para indicar si el bot acepta, espera o ignora la entrada del usuario. Para más información, consulte Incorporación de sugerencias de entrada a los mensajes.

Recursos adicionales