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

Artigo
10/09/2024

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

Conhecimento de Cartões Adaptativos e do Modelo de Ação Universal.
Familiaridade com mensagens acionáveis no Outlook e nos Grupos do Office 365.
Um bot pronto para canal implantado no Azure.
Um endereço de e-mail dedicado que seu bot usará para enviar e receber mensagens.

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.

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.
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

Abra seu recurso de bot no portal do Azure.
Abra o painel Canais .
Selecione o canal do Outlook .
Na página Configurar o Outlook, selecione Registre-se aqui.
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

Saiba mais sobre Mensagens acionáveis no Outlook e nos Grupos do Office 365.
Saiba mais sobre Cartões adaptáveis para desenvolvedores de mensagens acionáveis do Outlook

Partilhar via