Introdução às mensagens acionáveis no Office 365

Importante

As Mensagens Acionáveis usam autenticação de token baseada no Microsoft Entra ID. A transição da autenticação herdada (EAT) foi concluída em 8 de junho de 2026. A autenticação herdada não é mais suportada.

As integrações que não foram atualizadas para usar tokens do Microsoft Entra ID não funcionam mais. Os parceiros devem usar a autenticação de token baseada em ID do Entra para todas as integrações do Actionable Messages. Para obter mais informações, consulte Habilitar o token do Microsoft Entra ID para Mensagens Acionáveis.

Importante

O portal do provedor de Mensagens Acionáveis foi movido para um novo local. Visite o novo portal.

Cenários com suporte

Você pode enviar mensagens acionáveis por email nos cenários a seguir.

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

Observação

Os administradores do Office 365 podem desabilitar mensagens acionáveis usando o cmdlet Set-OrganizationConfig. Se as mensagens acionáveis não forem renderizadas, Marque com o administrador se o recurso está habilitado em sua organização.

Criar um cartão de mensagem acionável

Vamos começar com algo simples - um card básico com uma Action.Http ação e uma Action.OpenUrl ação. Use o Actionable Message Designer para criar o card.

Importante

A marcação de cartão de exemplo neste tópico omite a propriedade originator. Essa omissão funciona em um cenário de teste, em que o destinatário é o mesmo que o remetente. Ao enviar mensagens acionáveis para qualquer outra pessoa, defina a originator propriedade como uma ID de provedor válida gerada pelo Painel do desenvolvedor do Actionable Email. Se você deixar esta propriedade vazia ao enviar para outras pessoas, o card será removido.

Acesse o Actionable Message Designer e cole o 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. Para obter detalhes sobre os campos disponíveis, consulte a referência do card adaptável. Quando você tiver um card com o qual estiver satisfeito, poderá enviá-lo.

Enviar mensagens acionáveis por email

Importante

Para projetar e testar mensagens acionáveis, use o Actionable Message Designer. Ele envia mensagens acionáveis para você. Você também pode usar o servidor SMTP do Office 365 para enviar mensagens acionáveis para si mesmo. Você não pode enviar mensagens acionáveis para outros usuários até se registrar por meio da dashboard de desenvolvedor de mensagens acionáveis.

Para incorporar um action message card em uma mensagem de email, envolva o card em uma <script> tag. Insira a <script> tag no <head> corpo HTML do email.

Observação

Como você deve encapsular o JSON do card em uma <script> marca, o corpo do email da mensagem acionável deve ser HTML. Não há suporte para mensagens de texto sem formatação.

  1. Adicione o atributo hideOriginalBody para controlar o que acontece com o corpo do email. Defina o atributo para true 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"
    }
  ]
}

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

    Observação

    Se você estiver usando o formato de card de mensagem herdado em vez do formato de Cartão Adaptável, o tipo de <script> marca deverá 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>

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

  4. Envie uma mensagem por SMTP com o HTML como corpo.

Envio da mensagem

Para ver exemplos de envio de mensagens, consulte os seguintes recursos:

Executar ações

Para obter exemplos de execução de ações, consulte os seguintes recursos:

  • Olá Mensagens Acionáveis: Um projeto de exemplo com implantação do Azure com um clique. Este exemplo é uma solução simples de mensagens acionáveis de ponta a ponta que você pode configurar e começar a usar em 10 minutos. Ele serve como uma referência para a criação de 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 os desenvolvedores usam para inspecionar a carga do card em suas mensagens acionáveis e identificar por que o card não está renderizando.
  • Last updated on