Conexão um bot para o canal Outlook para mensagens ativas (versão prévia)

aplica-se a: SDK v4

Mensagens ativas permitem que os usuários tomem ações rápidas de dentro Outlook. Quando você conecta um bot ao canal Outlook mensagens ativas, seu bot pode usar Cartões Adaptáveis para criar mensagens ativas, aprimorando o envolvimento do usuário.

Observação

O Outlook para Mensagens Ativas está em versão prévia pública. Os recursos incluídos na versão prévia podem não estar completos e podem passar por 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 Bot Framework código de conduta para criar "spambots", incluindo bots que enviam emails em massa indesejados ou não solicitados.

Pré-requisitos

Observação

  • Não use suas próprias contas de email pessoais para bots, pois cada mensagem enviada para essa conta de email será encaminhada 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ê usar Microsoft Exchange Server, habilita a Descoberta Automática antes de configurar o canal de email.

Criar as mensagens

O Outlook de mensagens ativas envia e recebe Cartões Adaptáveis email.

Você pode usar o Designer de Mensagens A actionable para projetar e testar cartões de mensagem a ação.

Importante

O modelo de ação de Bot universal é introduzido no esquema de Cartões Adaptáveis versão 1.4. Para usar esses novos recursos, a propriedade de versão do seu Cartão Adaptável deve ser definida como 1.4 ou posterior. Consulte Action.Execute no Cartões Adaptáveis Schema Explorer.

Implementar e implantar o bot

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

  1. Quando o usuário responde ao cartão por email, Outlook envia uma atividade de invocação para o bot. A propriedade da atividade value contém um objeto de ação com as propriedades , e type verb data . Por exemplo, a atividade incluiria as informações a seguir, em que 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 Cartões Adaptáveis Schema Explorer para ver o esquema de objeto completo.

  2. O bot trata a atividade de invocação de entrada e retorna um resultado que inclui um novo Cartão Adaptável que assumirá o lugar do Cartão Adaptável original. A resposta de invocação pode ser assim:

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

Solicitar acesso

  1. Abra o recurso de bot no portal do Azure.
  2. Abra o painel Canais.
  3. Selecione o Outlook canal.
  4. Na página Configurar Outlook, selecione registre-se aqui.
  5. Preencha o formulário de registro para solicitar acesso. Confira Registrar seu serviço com o painel do desenvolvedor de email a actionable para obter mais informações.

Próximas etapas