Introdução às mensagens acionáveis no Office 365
Importante
A inclusão de novos fornecedores de Mensagens Acionáveis com um Âmbito global é temporariamente colocada em pausa até 30 de junho de 2024 devido a atualizações de serviço. Os fornecedores de âmbito global existentes e a integração de fornecedores de âmbito de Organização e Teste não são afetados. Para obter mais detalhes, consulte Perguntas mais frequentes sobre 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.
Observação
Administradores do Office 365 podem desativar as mensagens acionáveis pelo cmdlet Set-OrganizationConfig. Se as mensagens acionáveis não forem renderizadas, verifique com seu administrador para garantir que o recurso está ativado na sua organização.
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. Vamos utilizar a Designer Mensagem Acionável para estruturar o card.
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.
Aceda à mensagem Acionável 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"
}
]
}
Não hesite em experimentar este exemplo simples no Designer. Pode ver a referência de card 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
Pode estruturar e testar mensagens acionáveis com o Designer Mensagem Acionável, que lhe permite enviar mensagens acionáveis para si próprio. 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
hideOriginalBodypara controlar o que acontece com o corpo do email. Nesse caso, definiremos o atributo comotruepara 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 tipoapplication/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 serapplication/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.