Enviar uma mensagem acionável por email no Office 365

Artigo
04/28/2024

Importante

A integração de novos provedores de Mensagens Acionáveis com um escopo Global está temporariamente pausada até 30 de junho de 2024 devido a atualizações de serviço. Os provedores de escopo global existentes e a integração de provedores de escopo de organização e teste não são afetados. Para obter mais detalhes, confira Perguntas frequentes para Mensagens Acionáveis.

Cenários com suporte

O envio de mensagens acionáveis por email tem suporte nos seguintes cenários.

O destinatário precisa ser um indivíduo, não um grupo.
O destinatário deve estar visível na mensagem. Não coloque o destinatário no campo Cco.
O destinatário deve ter uma caixa de correio no Outlook.com ou no Exchange Online no Office 365.

Criar um cartão de mensagem acionável

Para começar, vamos criar um cartão de mensagem acionável. Começaremos com algo simples, apenas um cartão básico com uma ação Action.Http e uma ação Action.OpenUrl. Usaremos o Designer mensagem acionável para projetar o cartão.

Importante

A marcação de cartão de exemplo neste tópico omite a propriedade originator. Isso funciona em um cenário de teste em que o remetente é igual ao destinatário. Quando enviar mensagens acionáveis para outras pessoas, é necessário definir a propriedade originator com uma ID de provedor válida gerada pelo Painel do desenvolvedor de email acionável. Se deixar essa propriedade vazia quando enviar mensagens para outras pessoas, o cartão será removido.

Acesse o Designer de Mensagem Acionável e cole no seguinte JSON:

{
  "type": "AdaptiveCard",
  "version": "1.0",
  "body": [
    {
      "type": "TextBlock",
      "text": "Visit the Outlook Dev Portal",
      "size": "large"
    },
    {
        "type": "TextBlock",
        "text": "Click **Learn More** to learn more about Actionable Messages!"
    },
    {
      "type": "Input.Text",
      "id": "feedbackText",
      "placeholder": "Let us know what you think about Actionable Messages"
    }
  ],
  "actions": [
    {
      "type": "Action.Http",
      "title": "Send Feedback",
      "method": "POST",
      "url": "https://...",
      "body": "{{feedbackText.value}}"
    },
    {
      "type": "Action.OpenUrl",
      "title": "Learn More",
      "url": "https://learn.microsoft.com/outlook/actionable-messages"
    }
  ]
}

Sinta-se à vontade para experimentar este exemplo simples no Designer. Você pode ver a referência de cartão adaptável para obter detalhes sobre os campos disponíveis. Quando você já tiver um cartão do seu agrado, poderá enviá-lo.

Enviar mensagens acionáveis por email

Importante

Você pode projetar e testar mensagens acionáveis usando o Designer mensagem acionável, que permite enviar mensagens acionáveis para si mesmo. Você também pode enviar mensagens acionáveis para si mesmo usando o servidor SMTP do Office 365. Não será possível enviar mensagens acionáveis para qualquer outro usuário até que você se registre usando o painel do desenvolvedor de mensagens acionáveis.

Para incorporar um cartão de mensagem acionável em uma mensagem de email, precisamos encapsular o cartão em uma marca <script>. Depois, a marca <script> é inserida no <head> do corpo HTML do email.

Observação

Como o cartão JSON deve ser encapsulado em uma marcação <script>, o corpo do email de mensagens acionáveis DEVE estar em HTML. Não há suporte para mensagens de texto sem formatação.

Adicione o atributo hideOriginalBody para controlar o que acontece com o corpo do email. Nesse caso, definiremos o atributo como true para que o corpo não seja mostrado.

{
  "type": "AdaptiveCard",
  "version": "1.0",
  "hideOriginalBody": true,
  "body": [
    {
      "type": "TextBlock",
      "text": "Visit the Outlook Dev Portal",
      "size": "large"
    },
    {
        "type": "TextBlock",
        "text": "Click **Learn More** to learn more about Actionable Messages!"
    },
    {
      "type": "Input.Text",
      "id": "feedbackText",
      "placeholder": "Let us know what you think about Actionable Messages"
    }
  ],
  "actions": [
    {
      "type": "Action.Http",
      "title": "Send Feedback",
      "method": "POST",
      "url": "https://...",
      "body": "{{feedbackText.value}}"
    },
    {
      "type": "Action.OpenUrl",
      "title": "Learn More",
      "url": "https://learn.microsoft.com/outlook/actionable-messages"
    }
  ]
}

Encapsule o JSON resultante em uma marca <script> do tipo application/adaptivecard+json.

Observação

Se você estiver usando o formato de cartão de mensagem herdado em vez de formato Cartão Adaptável, o tipo de marca <script> DEVE ser application/ld+json.

<script type="application/adaptivecard+json">{
  "type": "AdaptiveCard",
  "version": "1.0",
  "hideOriginalBody": true,
  "body": [
    {
      "type": "TextBlock",
      "text": "Visit the Outlook Dev Portal",
      "size": "large"
    },
    {
        "type": "TextBlock",
        "text": "Click **Learn More** to learn more about Actionable Messages!"
    },
    {
      "type": "Input.Text",
      "id": "feedbackText",
      "placeholder": "Let us know what you think about Actionable Messages"
    }
  ],
  "actions": [
    {
      "type": "Action.Http",
      "title": "Send Feedback",
      "method": "POST",
      "url": "https://...",
      "body": "{{feedbackText.value}}"
    },
    {
      "type": "Action.OpenUrl",
      "title": "Learn More",
      "url": "https://learn.microsoft.com/outlook/actionable-messages"
    }
  ]
}
</script>

Gere um documento HTML para representar o corpo do email e inclua a marca <script> no <head>.

<html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  <script type="application/adaptivecard+json">{
    "type": "AdaptiveCard",
    "version": "1.0",
    "hideOriginalBody": true,
    "body": [
      {
        "type": "TextBlock",
        "text": "Visit the Outlook Dev Portal",
        "size": "large"
      },
      {
        "type": "TextBlock",
        "text": "Click **Learn More** to learn more about Actionable Messages!"
      },
      {
        "type": "Input.Text",
        "id": "feedbackText",
        "placeholder": "Let us know what you think about Actionable Messages"
      }
    ],
    "actions": [
      {
        "type": "Action.Http",
        "title": "Send Feedback",
        "method": "POST",
        "url": "https://...",
        "body": "{{feedbackText.value}}"
      },
      {
        "type": "Action.OpenUrl",
        "title": "Learn More",
        "url": "https://learn.microsoft.com/outlook/actionable-messages"
      }
    ]
  }
  </script>
</head>
<body>
Visit the <a href="https://learn.microsoft.com/outlook/actionable-messages">Outlook Dev Portal</a> to learn more about Actionable Messages.
</body>
</html>

Envie uma mensagem via SMTP com o HTML como corpo.

Envio da mensagem

Veja exemplos de envio de mensagens nos links a seguir.

Enviar mensagens acionáveis por meio do Microsoft Graph: um exemplo de aplicativo de console escrito em C# que envia uma mensagem acionável usando o Microsoft Graph.
Enviar Mensagens Acionáveis via SMTP: um exemplo de script em Python que envia uma mensagem acionável usando o servidor SMTP do Office 365. Também inclui uma carga de HTML de exemplo para o corpo do email da mensagem acionável.

Executar ações

Confira os seguintes exemplos de execução de ações.

Mensagens Acionáveis Olá: um projeto de exemplo de implantação do Azure com apenas um clique. Este exemplo é uma solução simples de mensagem acionável de ponta a ponta que pode entrar em funcionamento em 10 minutos e que serve como referência para criar um ponto de extremidade de ação de produção.

Ferramentas de solução de problema

Depurador de Mensagens Acionáveis: um suplemento do Outlook que permite aos desenvolvedores inspecionar o conteúdo da carga em mensagens acionáveis e identificar por que o cartão não está renderizando.

Enviar uma mensagem acionável por email no Office 365

Cenários com suporte

Criar um cartão de mensagem acionável

Enviar mensagens acionáveis por email

Envio da mensagem

Executar ações

Ferramentas de solução de problema

Recursos adicionais