Enviar un mensaje que requiere acción por correo electrónico en Office 365

Artículo
03/14/2024

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.

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 hideOriginalBody para controlar lo que sucede con el cuerpo del correo electrónico. En este caso estableceremos el atributo en true para 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 tipo application/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 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>

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.