Registrar un servicio con el panel para desarrolladores de mensajes que requieren acción por correo electrónico

Importante

Los mensajes accionables usan la autenticación de tokens basada en Microsoft Entra ID. La transición de la autenticación heredada (EAT) se completó el 8 de junio de 2026. Ya no se admite la autenticación heredada.

Las integraciones que no se han actualizado para usar Microsoft Entra ID tokens ya no funcionan. Los asociados deben usar Entra autenticación de token basada en identificadores para todas las integraciones de mensajes accionables. Para obtener más información, vea Habilitar Microsoft Entra ID token para mensajes accionables.

Para probar y publicar mensajes accionables desde el servicio, proporcione cierta información a Microsoft para habilitar esta funcionalidad para los correos electrónicos del servicio. El panel del desarrollador le ayuda a enviar y realizar un seguimiento del estado del envío a través del portal web.

Nota:

Puede probar fácilmente mensajes accionables por correo electrónico enviando un correo electrónico a usted mismo con el marcado necesario sin intervención de Microsoft. Este paso suele ser el primer paso que intenta al colocar los dedos de los dedos en esta funcionalidad. Consulte estos ejemplos para enviar un mensaje accionable al buzón de correo o use el Designer De mensajes accionables para enviar un mensaje accionable a usted mismo.

Si es un desarrollador que trabaja con mensajes accionables por correo electrónico, use el portal para los casos siguientes:

  • Para probar los mensajes accionables desde el servicio a su propio buzón
  • Para publicar mensajes accionables desde el servicio para que cualquier usuario de correo electrónico de su organización que use Microsoft 365 pueda recibir estos mensajes con formato especial. Esta opción normalmente habilita los mensajes accionables de un servicio que es específico de su organización, como una aplicación de línea de negocio.
  • Para publicar mensajes accionables desde el servicio para que cualquier usuario de correo electrónico de Microsoft 365 que use el servicio pueda recibir estos mensajes con formato especial.

Para todos estos casos, envíe los detalles a Microsoft. Después de la revisión y aprobación, Microsoft habilita los mensajes accionables para su servicio.

Secciones del panel

El panel para desarrolladores se divide en algunas secciones lógicas que debe rellenar en función del ámbito que desea solicitar a Microsoft que habilite mensajes accionables desde el servicio.

Detalles del proveedor

En esta sección, proporcione detalles clave que permitan a Microsoft 365 aceptar correos electrónicos con marcado del servicio, así como direcciones URL que los botones de acción de esos correos electrónicos pueden invocar.

Esos campos clave son:

  • Dirección de correo electrónico del remitente: escriba una o varias direcciones de correo electrónico estáticas que correspondan al servicio que envía correos electrónicos con marcado de acción. Por ejemplo, myservice@contoso.com.

  • Direcciones URL de destino: escriba uno o varios dominios que se correspondan con las direcciones URL que procesan las acciones. La dirección URL de destino puede corresponder al dominio de nivel superior o al subdominio del TLD. Deben ser direcciones URL habilitadas para HTTPS. Por ejemplo, https://api.myservice.com.

  • Clave pública: si tiene previsto enviar mensajes accionables como Tarjeta firmada, especifique la clave pública que corresponde a la clave privada que usa para firmar la tarjeta. El formato de este campo es un elemento RSAKeyValue.

    <RSAKeyValue>
  <Modulus>xA7SEU+e0yQ...</Modulus>
  <Exponent>AQAB</Exponent>
</RSAKeyValue>

Puede generar y exportar un par de claves RSA en el formato correcto mediante PowerShell (7.3 o posterior).

# Generate a key pair:
$rsa = [System.Security.Cryptography.RSA]::Create();

# Private Key, ensure this is saved securely and kept secret:
$rsa.ToXmlString($true)

## Public Key, copy output to dashboard:
$rsa.ToXmlString($false)

Para obtener un ejemplo de cómo obtener XML de clave pública desde un archivo .cert, vea Clase PublicKey.

Nota:

Una vez aprobado el envío, es posible que los cambios tarden algún tiempo en surtir efecto. Si encuentra el siguiente error al enviar tarjetas firmadas y está seguro de que la carga útil es correcta, inténtelo de nuevo después de unas horas.

Adaptive card signature validation failed - Failed to validate signature

Ámbito del envío

Especifique el ámbito donde desea habilitar el mensaje accionable para el servicio. Los ámbitos posibles son:

  • Usuarios de prueba: este ámbito permite enviar correos electrónicos accionables desde el servicio a algunos de los usuarios de correo electrónico de Microsoft 365 de su organización. Use este ámbito para probar la integración de mensajes accionables con algunos usuarios de prueba que especifique.
  • Organización: este ámbito permite enviar mensajes accionables desde el servicio a cualquier usuario de correo electrónico de Microsoft 365 dentro de la organización. Use este ámbito para habilitar mensajes accionables desde un servicio específico de su organización, como una aplicación de línea de negocio.
  • Global: este ámbito habilita el mensaje accionable desde el servicio para cualquier usuario de correo electrónico de Microsoft 365.

Cada ámbito es independiente. Solo puede enviar un ámbito por solicitud y debe obtener la aprobación de Microsoft.

Nota:

Puede probar fácilmente los mensajes accionables enviando un correo electrónico a usted mismo con el marcado necesario sin intervención de Microsoft. Use el Designer De mensajes accionables para enviarse a sí mismo sin escribir ningún código. Este paso suele ser el primer paso para probar los mensajes accionables.

Registro de autoservicio

El registro de autoservicio está disponible para los ámbitos siguientes.

  • Usuarios de prueba: la solicitud de registro se aprueba automáticamente para los usuarios de prueba que especifique. Este registro habilita los correos electrónicos accionables del servicio enviados a los usuarios de prueba.
  • Organización: esta solicitud de registro se enruta a Exchange o Administrador global de su organización para su revisión y aprobación.

Una vez aprobado el envío, ya sea aprobado automáticamente o por el administrador, el registro puede tardar hasta 24 horas en surtir efecto.

Después de 24 horas, compruebe que el registro está activo enviando un mensaje accionable desde el servicio al buzón de correo o a los usuarios de prueba especificados (para el ámbito Usuarios de prueba ) o a cualquier usuario de su organización (para el ámbito de la organización ). Si han transcurrido 24 horas y el registro todavía no está activo, póngase en contacto con nosotros mediante el vínculo de comentarios situado en la parte superior del panel de registro con la etiqueta ¿No funciona el registro?.

Probar direcciones de correo electrónico de usuarios

Esta sección solo procede si el ámbito de envío donde se quiere habilitar los mensajes que requieren acción es Probar usuarios.

Proporcione una lista de usuarios de correo electrónico de Microsoft 365 en su organización, separados por un punto y coma (;). Esta lista le ayuda a probar la integración de mensajes accionables con algunos usuarios antes de crear un envío de ámbito global o de organización.

Información de contacto

Esta sección solo procede si el ámbito de envío donde se quiere habilitar los mensajes que requieren acción es Global.

En esta sección hay que suministrar la información de contacto, así podremos ponernos en contacto con usted en caso de que tengamos más preguntas sobre el envío. Toda la información proporcionada debe ser válida y precisa.

Información del publicador

Esta sección solo procede si el ámbito de envío donde se quiere habilitar los mensajes que requieren acción es Global.

En esta sección hay que proporcionar detalles sobre el servicio que va a enviar mensajes accionables, además de la información de soporte relacionada correspondiente, ya que así podremos ponernos en contacto con usted o remitir a los clientes a su sitio de soporte técnico. Esta información también se usará como parte del proceso de aprobación de Microsoft del proveedor.

Detalles del escenario

Esta sección solo procede si el ámbito de envío donde se quiere habilitar los mensajes que requieren acción es Global.

En esta sección, debe proporcionar detalles sobre el escenario en el que los usuarios usarán mensajes accionables del servicio. Esto ayuda a Microsoft a determinar la validez y la utilidad de la solución.

Detalles de comprobación

Esta sección solo procede si el ámbito de envío donde se quiere habilitar los mensajes accionables es Global.

En esta sección hay que especificar los detalles que van a permitir a Microsoft comprobar el mensaje accionable y las acciones correspondientes que se invocan desde el correo electrónico enviado por el servicio o el proveedor.

Además, envíe un correo electrónico válido procedente de los servidores de producción (o un servidor con encabezados DKIM/SPF/From:/Return-Path: similares), incluido el marcado a onboardoam@microsoft.com. Este procedimiento permitirá a Microsoft determinar que la solución cumple con todas las directrices y requisitos enumerados en Criterios de registro.

  • Antes de enviar el correo electrónico, asegúrese de que la marcación es correcta.
  • Microsoft 365 quita todo el marcado al reenviar un correo electrónico. Por tanto, no reenvíe el correo electrónico: envíelo directamente.

Criterios de registro

Tenga en cuenta estos criterios al enviar la solución para su aprobación para el ámbito global , ya que puede tener un gran impacto en los usuarios de Microsoft 365.

Directrices de calidad del remitente de correo electrónico

  • Autentique los correos electrónicos a través de DKIM o SPF.
  • El dominio de primer nivel de la comprobación SPF o de la firma DKIM debe coincidir con el dominio de primer nivel de la dirección de correo electrónico de From:. Por ejemplo, si se usa From: myservice@contoso.com, el DKIM o SPF debe ser contoso.com o -.contoso.com.
  • Envíe correos electrónicos desde una dirección de correo electrónico estática, como myservice@contoso.com.
  • Siga las instrucciones del remitente del correo electrónico.
  • Mantenga un historial coherente de envío de un gran volumen de correo desde su dominio (un pedido de cientos de correos electrónicos al día como mínimo a Microsoft 365) durante al menos unas semanas.
  • Mantener una tasa muy baja de quejas de correo no deseado de los usuarios.
  • Use acciones sencillas, rutinarias y de alta fidelidad para el servicio. Para interacciones más complejas, use Action.OpenUrl acciones.
  • Use acciones para el correo transaccional donde se espera una alta tasa de interacción. No los use en correo masivo promocional.

Directrices de acciones

  • La etiqueta del botón debe reflejar claramente la acción que se debe realizar.
  • Action.OpenUrl action debe vincularse en profundidad a la página específica asociada a la entidad o a la información presentada en el mensaje accionable.
  • Mantenga una tasa de errores baja y una respuesta rápida para los servicios que controlan las solicitudes de acción.
  • Para obtener instrucciones adicionales sobre el diseño de mensajes accionables, vea Diseñar tarjetas de mensaje accionables de Outlook con el formato de tarjeta adaptable.

Aprobación del envío

Recibirá una notificación en la dirección de correo electrónico que proporcione durante el envío, así que asegúrese de proporcionar la información de contacto correcta.

  • Last updated on