Introducción a los mensajes accionables en Office 365
Importante
La incorporación de nuevos proveedores de mensajes accionables con un ámbito global se pausa temporalmente hasta el 30 de junio de 2024 debido a las actualizaciones del servicio. Los proveedores de ámbito global existentes y la incorporación de proveedores de ámbito de organización y prueba no se ven afectados. Para obtener más información, consulte Preguntas más frecuentes sobre los mensajes accionables.
Escenarios admitidos
El envío por correo electrónico de mensajes que requieren acción se acepta en los siguientes escenarios.
- El destinatario debe ser un usuario individual, no un grupo.
- El destinatario debe estar visible en el mensaje. No ponga el destinatario en el campo CCO.
- El destinatario debe tener un buzón de correo en Outlook.com o Exchange Online en Office 365.
Nota:
Los administradores de Office 365 pueden deshabilitar los mensajes mediante el cmdlet Set-OrganizationConfig. Si los mensajes accionables no se representan, póngase en contacto con el administrador para asegurarse de que la característica está habilitada en su organización.
Crear una tarjeta de mensaje que requiere acción
Comenzaremos creando una tarjeta de mensaje que requiere acción. Comenzaremos con algo sencillo: una tarjeta básica con una acción Action.Http y una acción Action.OpenUrl. Usaremos el Designer de mensajes accionables para diseñar la tarjeta.
Importante
El marcado de tarjeta descrito como ejemplo en este tema omite la propiedad originator. Esto funciona en un escenario de prueba, donde el destinatario es el mismo que el remitente. Al enviar mensajes que requieren acción a mensajes a otras personas, la propiedad originator debe establecerse en un identificador de proveedor válido generado por el panel del desarrollador de correo electrónico que requiere acción. Dejar esta propiedad vacía al enviar a otras personas resultados en la tarjeta que se quitará.
Vaya al Designer De mensajes accionables y pegue el siguiente código 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"
}
]
}
No dude en experimentar con este sencillo ejemplo en el Designer. Puede ver la referencia de tarjeta adaptable para obtener más información sobre los campos disponibles. Una vez que tenga una tarjeta con un resultado que le guste, puede proceder a enviarla.
Enviar por correo electrónico mensajes que requieren acción
Importante
Puede diseñar y probar mensajes accionables mediante el Designer de mensajes accionables, que le permite enviar mensajes accionables a sí mismo. También puede enviarse mensajes que requieren acción con el servidor SMTP de Office 365. No podrá enviar mensajes que requieren acción a ningún otro usuario hasta que se registre con el Panel para desarrolladores de mensajes que requieren acción.
Para incrustar una tarjeta de mensaje que requiere acción en un mensaje de correo electrónico, se debe encapsular la tarjeta en una etiqueta <script>. Luego se inserta la etiqueta <script> en el <head> del cuerpo HTML del correo electrónico.
Nota:
Como el código JSON de la tarjeta tiene que estar dentro de una etiqueta <script>, el cuerpo del correo electrónico del mensaje que requiere acción TIENE que tener formato HTML. Los mensajes de texto sin formato no se admiten.
Agregue el atributo
hideOriginalBodypara controlar lo que sucede con el cuerpo del correo electrónico. En este caso estableceremos el atributo entruepara que no se muestre el cuerpo.{ "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 el JSON resultante en una etiqueta
<script>de tipoapplication/adaptivecard+json.Nota:
Si usa el formato de mensaje de tarjeta heredado en lugar del formato de la tarjeta adaptable, el tipo de etiqueta
<script>DEBE 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>Genere un documento HTML para representar el cuerpo del correo electrónico e incluya la etiqueta
<script>en el<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>Envíe un mensaje a través de SMTP con el código HTML como cuerpo.
Enviar el mensaje
Para ver ejemplos de cómo enviar mensajes, consulte los siguientes temas.
- Enviar mensaje que requiere acción mediante Microsoft Graph: aplicación de consola de ejemplo escrita en C# que envía un mensaje que requiere acción mediante Microsoft Graph.
- Enviar un mensaje que requiere acción por SMTP: un script Python de ejemplo que envía un mensaje que requiere acción mediante el servidor SMTP de Office 365. También incluye una carga útil de HTML de ejemplo para el cuerpo del correo electrónico del mensaje que requiere acción.
Realizar acciones
Para obtener ejemplos sobre cómo realizar acciones, vea lo siguiente.
- Hello Actionable Messages: un proyecto de muestra con un botón para la implementación en Azure con un solo clic. Este ejemplo es una solución integral de mensaje accionable que puede estar configurada y funcionando en 10 minutos y sirve como referencia para crear un extremo de acción de producción.
Herramientas de resolución de problemas
- Depurador de mensajes que requieren acción: un complemento de Outlook que permite a los desarrolladores inspeccionar la carga útil de la tarjeta en los mensajes que requieren acción e identificar por qué no se procesa la tarjeta.