Introducción a los mensajes accionables en Office 365

Importante

Los mensajes accionables pasan de la autenticación heredada (EAT) a Entra autenticación de token basada en identificadores. La eliminación gradual de la autenticación heredada está en curso y se completará el 8 de junio de 2026. Después de esta fecha, las integraciones que dependen de tokens heredados ya no funcionarán.

Para garantizar un servicio ininterrumpido, los asociados deben implementar la compatibilidad con tokens de identificador de Entra lo antes posible. Para obtener instrucciones sobre cómo actualizar la integración, consulte Habilitar Microsoft Entra ID token para mensajes accionables.

Importante

El portal del proveedor de mensajes accionables se ha movido a una nueva ubicación. Visite el nuevo portal.

Escenarios admitidos

Puede enviar mensajes accionables a través del correo electrónico en los siguientes escenarios.

  • El destinatario debe ser un usuario individual, no un grupo.
  • El destinatario debe estar visible en el mensaje. No coloque el destinatario en el campo BCC.
  • El destinatario debe tener un buzón de correo en Outlook.com o Exchange Online en Office 365.

Nota:

Office 365 los administradores pueden deshabilitar los mensajes accionables mediante el cmdlet Set-OrganizationConfig. Si los mensajes accionables no se representan, consulte 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

Comencemos con algo sencillo: una tarjeta básica con una Action.Http acción y una Action.OpenUrl acción. Use 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. Esta omisión funciona en un escenario de prueba, donde el destinatario es el mismo que el remitente. Al enviar mensajes accionables a cualquier otra persona, establezca la originator propiedad en un identificador de proveedor válido generado por el panel de desarrolladores de Email accionable. Si deja esta propiedad vacía al enviar a otros usuarios, se quita la tarjeta.

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://mms.heiai.top/outlook/actionable-messages"
    }
  ]
}

No dude en experimentar con este sencillo ejemplo en el Designer. Para obtener más información sobre los campos disponibles, consulte la referencia de tarjeta adaptable. Cuando tengas una tarjeta con la que estés contento, puedes pasar a enviarla.

Envío de mensajes accionables a través del correo electrónico

Importante

Para diseñar y probar mensajes accionables, use el Designer De mensajes accionables. Le envía mensajes accionables. También puede usar el Office 365 servidor SMTP para enviar mensajes accionables. No puede enviar mensajes accionables a otros usuarios hasta que se registre a través del panel del desarrollador de mensajes accionables.

Para insertar una tarjeta de mensaje accionable en un mensaje de correo electrónico, encapsula la tarjeta en una <script> etiqueta. Inserte la <script> etiqueta en el <head> del cuerpo HTML del correo electrónico.

Nota:

Dado que debe encapsular el JSON de la tarjeta en una <script> etiqueta, el cuerpo del correo electrónico del mensaje accionable debe ser HTML. No se admiten mensajes de texto sin formato.

  1. Agregue el atributo hideOriginalBody para controlar lo que sucede con el cuerpo del correo electrónico. Establezca el atributo true en 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://mms.heiai.top/outlook/actionable-messages"
    }
  ]
}

  2. Encapsule el JSON resultante en una etiqueta <script> de tipo application/adaptivecard+json.

    Nota:

    Si usa el formato de tarjeta de mensaje heredado en lugar del formato de tarjeta adaptable, el <script> tipo de etiqueta 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://mms.heiai.top/outlook/actionable-messages"
    }
  ]
}
</script>

  3. 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://mms.heiai.top/outlook/actionable-messages"
      }
    ]
  }
  </script>
</head>
<body>
Visit the <a href="https://mms.heiai.top/outlook/actionable-messages">Outlook Dev Portal</a> to learn more about Actionable Messages.
</body>
</html>

  4. Envíe un mensaje a través de SMTP con el CÓDIGO HTML como cuerpo.

Enviar el mensaje

Para obtener ejemplos de envío de mensajes, consulte los siguientes recursos:

Realizar acciones

Para obtener ejemplos de acciones, consulte los siguientes recursos:

  • Hola mensajes accionables: un proyecto de ejemplo con un solo clic Azure implementación. Este ejemplo es una sencilla solución de mensajes accionables de un extremo a otro que puede configurar y empezar a usar en 10 minutos. Actúa como referencia para crear un punto de conexión de acción de producción.

Herramientas de resolución de problemas

  • Depurador de mensajes accionables: un complemento de Outlook que los desarrolladores usan para inspeccionar la carga de la tarjeta en sus mensajes accionables e identificar por qué la tarjeta no se representa.
  • Last updated on