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

  • Artículo

Para poder probar y publicar mensajes accionables procedentes su servicio, debe proporcionar una información determinada a Microsoft para que habilite esta funcionalidad en los correos electrónicos del servicio. El panel del programador sirve para enviar esa información y llevar un seguimiento del estado de dicho envío a través del portal web.

Nota:

Puede probar fácilmente los mensajes accionables por correo electrónico enviándose un correo electrónico con el marcado necesario sin intervención de Microsoft. Este suele ser el primer paso que se lleva a cabo para empezar a adentrarse 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 que requieren acción por correo electrónico, usará el portal para lo siguiente:

  • Probar los mensajes accionables enviándolos desde su servicio a su propio buzón de correo
  • Publicar los mensajes accionables del servicio, de modo que cualquier usuario de correo electrónico de la organización que use Office 365 pueda recibir estos mensajes con formato especial (esto se suele usar para habilitar los mensajes accionables de un servicio concreto de la organización, como una aplicación de línea de negocio)
  • Publicar los mensajes accionables del servicio, de modo que cualquier usuario de correo electrónico de Office 365 que use dicho servicio pueda recibir estos mensajes con formato especial

En todos los casos anteriores, se enviarán detalles a Microsoft que, tras ser revisados y aprobados, permitirán que se habiliten los mensajes accionables de su servicio.

Secciones del panel

El panel de desarrollador se divide en una serie de secciones lógicas que deberá rellenar en función del ámbito en el que le gustaría que Microsoft habilitara los mensajes accionables procedentes de su servicio.

Detalles del proveedor

En esta sección hay que indicar información clave que permitirá a Office 365 aceptar mensajes de correo electrónico con marcación procedentes de su servicio, así como las direcciones URL que se pueden invocar a través de los botones de acción de esos mensajes.

Esos campos clave son:

  • Dirección de correo electrónico del remitente: una o más direcciones de correo electrónico estáticas correspondiente al servicio desde el que se van a enviar mensajes de correo electrónico con marcación de acción. Por ejemplo: myservice@contoso.com.

  • Direcciones URL de destino: se trata de uno o varios dominios correspondientes a las direcciones URL que procesarán 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. Ejemplo. https://api.myservice.com.

  • Clave pública: si quiere enviar mensajes que requieren acción como tarjeta firmada, deberá especificar la clave pública correspondiente a la clave privada que usará para firmar la tarjeta. El formato de este campo es un elemento RSAKeyValue.

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

Un par de claves RSA se puede generar y exportar 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, puede tardar 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

En esta sección hay que especificar en qué ámbito quiere habilitar los mensajes accionables del servicio. Los ámbitos posibles son:

  • Probar usuarios: habilita los mensajes de correo electrónico que requieren acción enviados desde su servicio a algunos de los usuarios de correo electrónico de O365 de su organización. Este ámbito se suele usar para probar la integración de los mensajes que requieren acción con unos pocos usuarios de prueba especificados por el usuario.
  • Organización: habilita los mensajes que requieren acción enviados desde su servicio a cualquier usuario de correo electrónico de Microsoft 365 dentro de la organización. Es el ámbito que se suele usar para habilitar los mensajes accionables de un servicio concreto de la organización, como una aplicación de línea de negocio interna.
  • Global: Esto habilita los mensajes accionables enviados desde su servicio a cualquier usuario de correo electrónico de Office 365.

Cada uno de los pasos anteriores son independientes. Es decir, solo puede elegir un ámbito para cada envío y estará sujeto al proceso de aprobación por parte de Microsoft.

Nota:

Recuerde que puede probar fácilmente mensajes accionables enviando un correo electrónico a usted mismo con el marcado necesario sin intervención de Microsoft. Puede usar el Designer de mensajes accionables para enviarse a sí mismo sin escribir ningún código. Este suele ser el primer paso que se lleva a cabo para probar la funcionalidad de mensajes accionables.

Registro de autoservicio

El autoservicio de registros está disponible en los registros que usan los siguientes ámbitos.

  • Probar usuarios: la solicitud de registro se aprueba automáticamente en el caso de los usuarios de prueba que se hayan especificado. Esto habilitará los mensajes de correo electrónico que requieren acción enviados desde su servicio a los usuarios de prueba.
  • Organización: esta solicitud de registro se enviará a los administradores de la organización con permisos de administrador de Exchange. Cualquier administrador con estos permisos recibe un correo electrónico con la información de envío y podrá revisar y aprobar la solicitud. Si ningún usuario tiene asignado el rol de administrador de Exchange, en su lugar recibirán este correo los usuarios con el rol de administrador global.

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

Para los registros de Mi organización, las cuentas de administrador recibirán un correo electrónico y el remitente recibirá también una copia de esos correos. Esto le permitirá comunicarse con su administrador si necesita aportar más información o aclaraciones. Cuando se apruebe la solicitud, el remitente y los administradores recibirán una notificación con otro correo electrónico.

Una vez transcurridos 24 horas, puede comprobar si el registro ha entrado en vigor mediante el envío de 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 cualquier buzón de usuario de su organización (para el ámbito de la organización ). Si han transcurrido 24 horas y el registro aún no está en vigor, póngase en contacto con nosotros mediante el vínculo de comentarios en la parte superior del panel de registro con la etiqueta ¿Registro no funciona?.

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.

En esta sección se ofrece una lista de los usuarios de correo electrónico de Microsoft 365 de la organización separados por punto y coma (;). Esto le servirá para probar la integración de los mensajes que requieren acción en unos pocos 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 hay que proporcionar detalles sobre el escenario en el que los usuarios van a consumir mensajes accionables procedentes de su servicio, aparte de otro detalles de relevancia. Esto sirve para que Microsoft averigüe la validez y la utilidad de la solución proporcionada por el servicio.

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.
  • Cuando un correo electrónico se reenvía, Office 365 quita toda la marcación. Por tanto, no reenvíe el correo electrónico: envíelo directamente.

Criterios de registro

Hay algunas cosas que debe tener en cuenta cuando envíe su solución de ámbito Global para su aprobación, ya que puede tener un gran impacto en los usuarios en Office 365.

Directrices de calidad del remitente de correo electrónico

  • Los correos electrónicos se deben autenticar a través de DKIM o SPF.
  • El dominio de nivel superior de la comprobación SPF o de la firma DKIM debe coincidir con el dominio de nivel superior de la dirección de correo electrónico From:. Por ejemplo, si se usa From: myservice@contoso.com, el DKIM o SPF debe ser contoso.com o -.contoso.com.
  • Los correos electrónicos deben provenir de una dirección estática, por ejemplo, myservice@contoso.com.
  • Los correos electrónicos deben respetar las directrices del remitente de correo electrónico.
  • Historial coherente de envío de un gran volumen de correo desde el dominio (del orden de cientos de correos electrónicos al día enviados a Office 365, como mínimo) durante al menos algunas semanas.
  • Una tasa muy baja de quejas de los usuarios por cuestiones de correo no deseado.
  • Se deben usar acciones simples, de rutina y de alta fidelidad disponibles en el servicio. Si se quiere usar interacciones más complejas, se puede recurrir a acciones OpenURI.
  • Las acciones se deben usar en correos transaccionales donde se espera una tasa de interacción elevada. No es aconsejable usarlas en correos masivos de carácter publicitario.

Directrices de acciones

  • La etiqueta del botón debe reflejar claramente la acción que va a tener lugar.
  • La acción Action.OpenUrl debe tener un vínculo profundo en la página específica asociada a la entidad o a la información contenida en el mensaje accionable.
  • Los servicios que se encarguen las solicitudes de acciones deben tener una tasa de errores baja y una respuesta rápida.
  • Consulte Diseño de tarjetas de mensajes que requieren acción de Outlook con el formato de la tarjeta adaptable para obtener instrucciones adicionales sobre el diseño de los mensajes que requieren acción.

Aprobación del envío

Le avisaremos en la dirección de correo electrónico que nos proporcione durante el envío, así que procure indicar la información de contacto correcta.