Conectar um bot ao canal do Outlook para Mensagens Acionáveis (Preview)

Artigo
12/29/2023

APLICA-SE A: SDK v4

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

Observação

O canal do Outlook para Mensagens Acionáveis está em visualização pública. Os recursos incluídos na preview podem não estar completos e podem sofrer alterações antes de serem disponibilizados 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 email em massa não solicitados ou indesejados.

Pré-requisitos

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

Observação

Você não deve usar suas contas de email pessoais para bots, pois todas as mensagens enviadas para essa conta de email serão encaminhadas para o bot. Isso pode resultar no bot enviando inadequadamente uma resposta para um remetente. Por esse motivo, os bots só devem usar contas de email do O365 dedicadas.
Se você está usando o Microsoft Exchange Server, habilite a Descoberta automática antes de configurar o canal de email.

Criar 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 de Bot universal é introduzido no esquema de Cartões Adaptáveis versão 1.4. Para usar essas novas capacidades, a propriedade versão do seu cartão adaptável deve ser definida como 1.4 ou posterior. Confira Action.Execute no Explorer de esquemas de Cartões Adaptáveis.

Implementar e implantar o bot

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

Quando o usuário responde ao cartão por email, o Outlook envia uma atividade de invocação para o bot. A propriedade value da atividade contém um objeto de ação com as propriedades type, verb e data. Por exemplo, a atividade incluiria as seguintes informações, em que o verbo e os dados correspondem às informações do 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
    }
  },
}
```
Confira Action.Execute no Explorer de esquemas de Cartões Adaptáveis para obter o esquema completo de objetos.
O bot manipula a atividade de invocação recebida e retorna um resultado que inclui um novo cartão adaptável que substituirá o cartão adaptável original. A resposta à invocação pode ser parecida com:
```
{
  "statusCode": 200,
  "type": "application/vnd.microsoft.card.adaptive",
  "value": <UPDATED_ADAPTIVE_CARD>
}
```

Solicitar acesso

Abra o 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 registro para solicitar acesso. Confira Registrar seu serviço com o dashboard do desenvolvedor de emails acionáveis para obter mais informações.

Próximas etapas

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

Compartilhar via