Adicionar voz a mensagens com a API do Conector do Bot

  • Artigo

Se estiver a criar um bot para um canal com capacidade para voz, pode construir mensagens que especifiquem o texto a ser falado pelo bot. Também pode tentar influenciar o estado do microfone do cliente ao especificar uma sugestão de entrada para indicar se o bot está a aceitar, esperar ou a ignorar as entradas do utilizador.

Pode configurar o bot para permitir que as aplicações cliente comuniquem com o mesmo através Direct Line canal de Voz.

Especificar texto a ser falado pelo bot

Para especificar o texto a ser falado pelo bot num canal com capacidade para voz, defina a speak propriedade no objeto Atividade que representa a sua mensagem. Pode definir a speak propriedade como uma cadeia de texto simples ou uma cadeia formatada como Speech Synthesis Markup Language (SSML), uma linguagem de markup baseada em XML que lhe permite controlar várias características da voz do bot, como voz, taxa, volume, pronúncia, tom e muito mais. Se o canal não suportar, a mensagem é entregue como texto.

O pedido seguinte envia uma mensagem que especifica o texto a ser apresentado e o texto a ser falado e indica que o bot está à espera de entrada do utilizador. Especifica a propriedade com o speak formato SSML para indicar que a palavra "claro" deve ser falada com uma quantidade moderada de ênfase. Neste pedido de exemplo, Direct Line representa o URI base; o URI base para pedidos de que os problemas do bot podem ser diferentes. Para obter detalhes sobre como definir o URI base, veja Referência da 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"
}

Sugestões de entrada

Quando envia uma mensagem num canal com capacidade para voz, pode expressar o estado pretendido do microfone do cliente, incluindo também uma sugestão de entrada para indicar se o bot está a aceitar, esperar ou a ignorar as entradas do utilizador. Para obter mais informações, consulte Adicionar sugestões de entrada a mensagens.

Recursos adicionais