Conectar um bot ao canal do Outlook para mensagens acionáveis (visualização)

  • Artigo

APLICA-SE A: SDK v4

As Mensagens Acionáveis permitem que os usuários realizem ações rápidas a partir do Outlook. Quando você conecta um bot ao canal de Mensagens Acionáveis do Outlook, seu bot pode usar Cartões Adaptáveis para criar mensagens acionáveis, aumentando o envolvimento do usuário.

Nota

O canal do Outlook para Mensagens Acionáveis está em visualização pública. Os recursos incluídos na visualização podem não estar completos e podem sofrer alterações antes de ficarem disponíveis na versão pública. Eles são fornecidos apenas para fins de avaliação e exploração.

Aviso

É uma violação do Código de Conduta do Bot Framework criar "spambots", incluindo bots que enviam e-mails em massa indesejados ou não solicitados.

Pré-requisitos

Nota

  • Não use suas próprias contas de e-mail pessoais para bots, pois todas as mensagens enviadas para essa conta de e-mail serão encaminhadas para o bot. Isso pode fazer com que o bot envie inadequadamente uma resposta para um remetente. Por esse motivo, os bots só devem usar contas de e-mail dedicadas do O365.
  • Se você usar o Microsoft Exchange Server, habilite a Descoberta Automática antes de configurar o canal de email.

Projetar as mensagens

O canal do Outlook para Mensagens Acionáveis envia e recebe Cartões Adaptáveis por email.

Você pode usar o Designer de Mensagens Acionáveis para criar e testar cartões de mensagens acionáveis.

Importante

O modelo de ação universal do Bot é introduzido no esquema Adaptive Cards versão 1.4. Para usar esses novos recursos, a propriedade version do seu Adaptive Card deve ser definida como 1.4 ou posterior. Consulte Action.Execute no Adaptive Cards Schema Explorer.

Implementar e implantar o bot

O fluxo geral é para o bot enviar uma mensagem acionável para um usuário e, em seguida, lidar com a ação do usuário.

  1. Quando o usuário responde ao cartão por email, o Outlook envia uma atividade de chamada para o bot. A propriedade da value atividade contém um objeto de ação com type, verbe data propriedades. Por exemplo, a atividade incluiria as seguintes informações, onde o verbo e os dados correspondem às informações no cartão que o bot enviou inicialmente.

    "type": "invoke",
"name": "adaptiveCard/action",
"value": {
  "action": {
    "type": "Action.Execute",
    "verb": "<DEVELOPER_DEFINED_VERB>",
    "data": {
      // DEVELOPER_DEFINED_PROPERTIES
    }
  },
}

    Consulte Action.Execute no Adaptive Cards Schema Explorer para obter o esquema de objeto completo.

  2. O bot lida com a atividade de chamada de entrada e retorna um resultado que inclui um novo Adaptive Card que substituirá o Adaptive Card original. A resposta de invocação pode ter a seguinte aparência:

    {
  "statusCode": 200,
  "type": "application/vnd.microsoft.card.adaptive",
  "value": <UPDATED_ADAPTIVE_CARD>
}

Pedir acesso

  1. Abra seu recurso de bot no portal do Azure.
  2. Abra o painel Canais .
  3. Selecione o canal do Outlook .
  4. Na página Configurar o Outlook, selecione Registre-se aqui.
  5. Preencha o formulário de inscrição para solicitar o acesso. Consulte Registrar seu serviço com o painel acionável do desenvolvedor de e-mail para obter mais informações.

Próximos passos