Compartir a través de


DataMotion (versión preliminar)

DataMotion, Inc. se especializa en API de intercambio de datos seguros, lo que permite a las empresas integrar soluciones seguras de intercambio de mensajes y archivos en sus flujos de trabajo existentes y ahorrar tiempo de desarrollo. El protocolo de seguridad siguiente puede llevar mucho tiempo, pero el conector de DataMotion permite la mensajería cifrada unidireccional sin problemas, lo que ayuda a los usuarios a seguir siendo compatibles con las regulaciones del sector y las directivas de seguridad de su empresa.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Compatibilidad con DataMotion
URL https://datamotion.com/support-request/
Correo Electrónico support@datamotion.com
Metadatos del conector
Publicador DataMotion, Inc.
Sitio web https://datamotion.com/secure-message-delivery-api/
Directiva de privacidad https://datamotion.com/privacy-policy/
Categorías Comunicación; Seguridad

DataMotion, Inc. es una empresa de API especializada en transferencia segura de datos. Esto significa que puede usar nuestro conector de entrega de mensajes seguro para enviar texto, documentos, imágenes, archivos y mucho más cifrados a cualquier usuario con una dirección de correo electrónico válida. Con este cifrado de un extremo a otro, puede asegurarse de que el contenido de los mensajes no se ha desconectado ni modificado de ninguna manera, tanto si está en tránsito como en la bandeja de entrada. Además de enviar mensajes de forma segura, el conector de entrega de mensajes seguro le permite realizar un seguimiento y retirar mensajes seguros. Al integrar esta funcionalidad en los flujos de trabajo, los usuarios podrán automatizar de forma segura las tareas que pueden haberse quedado completamente fuera de la cuestión antes, ya que es posible que la automatización haya puesto en peligro la seguridad. Su organización podrá aprovechar Power Automate para automatizar una gran cantidad de tareas, como el control adecuado y seguro de la información clínica, la transferencia de registros médicos de pacientes, la transferencia de códigos auxiliares de pago, el almacenamiento de planes de jubilación de los empleados, etc.

Prerrequisitos

Para usar el conector de entrega de mensajes seguro de DataMotion, primero deberá crear una cuenta de DataMotion. Tiene la opción de crear una cuenta de pago, basada en suscripciones o una evaluación gratuita de 30 días para empezar. Para crear una cuenta, vaya a datamotion.com/portal.

Una vez que haya completado este paso, recibirá automáticamente un crédito de 25 USD para probar la API. Desde aquí, puede seleccionar "Pagos" para continuar agregando al saldo en forma de pago único o periódico. Necesitará un saldo para continuar enviando, rastreando y retirando mensajes seguros con el conector de entrega de mensajes seguro.

Obtención de credenciales

Para crear una cuenta de DataMotion, vaya a datamotion.com/portal donde verá una lista de planes de API mostrados. Mantenga el puntero sobre el plan "entrega segura de mensajes" y haga clic en el icono "Probar ahora".

Una vez que haya seleccionado "Probar ahora", verá la página "API – secure message delivery Self-Service Center" (API: entrega segura de mensajes Self-Service Centro). Este centro proporciona la opción de probar las API de DataMotion, revisar la documentación y ponerse en contacto con el soporte técnico si es necesario.

En la esquina superior derecha de la pantalla hay un botón "Iniciar sesión". Haga clic en este botón para empezar. Aparecerá un nuevo elemento emergente una vez seleccionado el botón; en la parte inferior de esta ventana emergente, seleccione "Regístrese aquí".

Una vez completados estos pasos, verá una solicitud de información y una sección para crear una contraseña. Escriba la información necesaria y cree la contraseña segura.

Revise y acepte los términos de servicio y, a continuación, finalice el proceso seleccionando "Crear su cuenta". ¡Ahí lo tienes! Su cuenta se ha creado y tendrá automáticamente un saldo de $25 para probar nuestras API.

Introducción a nuestro conector

La entrega segura de mensajes de DataMotion es una adición perfecta dentro de los flujos de trabajo automatizados. El propio conector no se puede usar como desencadenador, pero se puede usar para enviar, realizar un seguimiento y retirar mensajes seguros una vez que se enciende el flujo de trabajo.

Hay algunos desencadenadores comunes para los flujos de trabajo que usan el conector de entrega de mensajes seguro. Un envío de formulario es un ejemplo, ya que es posible que los usuarios necesiten extraer datos confidenciales de un formulario y enviarlos de forma segura. La firma de un formulario mediante el conector DocuSign también será un desencadenador común. Los documentos importantes que deben firmarse y pasarse a lo largo suelen ser críticos para la empresa, o contienen PII, PHI o PCI y, por lo tanto, deben enviarse de forma segura. Por último, se puede usar un intervalo de tiempo para desencadenar un flujo de trabajo de forma diaria, semanal o mensual. Esto resulta especialmente útil cuando los datos importantes, como una lista actualizada de cuentas de cliente o una revisión semanal de beneficios, deben cifrarse y enviarse a un tercero de forma periódica.

Para empezar a trabajar con el conector de entrega de mensajes seguro, cree primero un flujo de trabajo de Power Automate y seleccione un desencadenador. Puede usar uno de los ejemplos anteriores o un desencadenador más único.

Una vez seleccionado un desencadenador, deberá agregar los datos confidenciales que desea enviar. Por ejemplo, si elige un envío de formulario como desencadenador, el primer paso del flujo de trabajo será recopilar los datos de este formulario. Una vez que haya recopilado datos confidenciales a través del flujo de trabajo, el siguiente paso es enviar los datos a través de un mensaje seguro. Para ello, deberá agregar un paso de flujo de trabajo adicional.

Para ello, seleccione "+ Paso siguiente" y busque el conector dataMotion. Para ello, escriba "entrega segura de mensajes" en la barra de búsqueda de la parte superior de la sección del nuevo paso.

Una vez que haya seleccionado el botón "+ Paso siguiente", verá una lista de acciones asociadas a este conector. Elija "Enviar mensaje seguro" como acción.

Un nuevo widget mostrará la solicitud de mensaje seguro.

A continuación, le guiaré por cada sección de la solicitud y proporcionaremos entradas de ejemplo. Tenga en cuenta que es posible que tenga que personalizar estos campos para probar correctamente (especialmente la dirección "Para").

  • Versión

    • V: esta sección solicita la versión de DataMotion API que está usando. Puede encontrar la versión de la API que usa en la sección "Cómo puedo" de nuestro portal de autoservicio. En la parte superior de la sección "Parámetro obligatorio", puede encontrar la versión de la API.
  • X-API-Secret

    • Para obtener la clave secreta de API, vuelva al centro de autoservicio e inicie sesión. Una vez que haya iniciado sesión, debería aparecer una nueva pestaña titulada "Aplicaciones". Seleccione esta pestaña.
      • Desde aquí, seleccione el botón "Crear aplicación" y asigne un nombre a la aplicación. A continuación, seleccione "Other" (Otro) para el tipo de aplicación y proporcione una descripción.
      • Seleccione el inicio de sesión "más" (+) en el centro de la sección Claves de API y copie el secreto de API que se proporciona en el elemento emergente. Pegue esta clave en el cuadro de texto X-API-Secret en Power Automate.
  • X-API-Key

    • En la sección Clave de API, copie la clave proporcionada y péguela en la sección X-API-Key de Power Automate.
  • De

    • La dirección "From" será la dirección desde la que va a enviar el mensaje seguro. Escriba en la dirección con la que creó el secreto de API y la clave.
  • Para

    • La dirección "Para" puede ser cualquier dirección con un buzón de correo. Para probarlo, puede escribir la misma dirección a la que usó desde o cualquier dirección a la que tenga acceso.
  • Cc (opcional)

    • Escriba cualquier dirección de correo electrónico adicional que tenga un buzón correspondiente que desee copiar.
  • Cco (opcional)

    • Escriba cualquier dirección de correo electrónico adicional que tenga un buzón correspondiente que desee copiar ciegamente.
  • Asunto (opcional)

    • Escriba el asunto del correo electrónico.
  • Datos adjuntos (opcional)

    • Para agregar datos adjuntos, deberá proporcionar la cadena base64, el tipo de contenido, el nombre de archivo y el identificador de contenido. Hay algunos pasos adicionales para recopilar esta información automáticamente, pero para la demostración de hoy, puede dejar esta sección en blanco.
  • HtmlBody (opcional)

    • En esta sección, puede agregar texto html para enviar en el cuerpo del mensaje. En este ejemplo, puede mantener esta sección en blanco.
  • TextBody (opcional)

    • En esta área, describa el cuerpo en texto sin formato y agregue la información confidencial que desea enviar.

Al hacer clic en cada uno de los cuadros de texto, es posible que vea "Insertar parámetros del paso anterior". Estos parámetros que ve sugeridos son las respuestas que puede haber extraído previamente de un formulario, una hoja de Excel u otro documento confidencial. Puede seleccionar estos parámetros para incluir estos datos en el cuerpo del correo electrónico.

Una vez que haya finalizado las configuraciones, seleccione "Guardar". Verá un mensaje que confirma que el flujo de trabajo se ha guardado en la parte superior de la pantalla.

Ahora ha creado un flujo de trabajo que incorpora la API de entrega de mensajes seguros de DataMotion.

Problemas y limitaciones conocidos

El conector de entrega de mensajes seguros de DataMotion tiene una limitación conocida. Si un usuario intenta realizar un seguimiento o retirar un mensaje directamente después de enviarlo, puede aparecer un mensaje de error que indica que no se encontró el mensaje. Esto se debe a que el identificador del mensaje aún no se ha actualizado. Un retraso de dos segundos o un reintento en caso de error resolverá este problema.

Errores y soluciones comunes

Un secreto o una clave de API no válidos producirán un error 401. Para resolver este error, debe crear una nueva clave. Vaya al portal de entrega de mensajes seguros de DataMotion y seleccione la pestaña Aplicaciones. En esta pestaña verá una sección Clave de API con la pantalla de la clave de API actual. Elimine la clave de API actual con el icono de papelera situado a la derecha de la clave.

Una vez seleccionado el icono de papelera, se quitará la clave y se agregará una nueva opción para agregar una clave en el centro de la sección Clave de API de la página. Seleccione esta opción y guarde de forma segura la clave secreta (que verá mostrada) ya que no podrá acceder a esta clave de nuevo desde el portal de DataMotion. Desde aquí, copie la nueva clave de API en el flujo de trabajo de Power Automate.

Preguntas más frecuentes

¿Dónde obtengo una clave de API y un secreto?

Para crear una clave de API o un secreto, vaya al portal de entrega de mensajes seguros de DataMotion y seleccione la pestaña "Aplicaciones". En la sección "Clave de API", estará disponible una opción para agregar una clave; verá la opción en el centro de la sección. Seleccione esta opción y guarde de forma segura la clave secreta que se mostrará, ya que no podrá acceder a esta clave de nuevo desde el portal de DataMotion. Desde aquí, copie la nueva clave de API en el flujo de trabajo de Power Automate.

¿Cómo me sucribo a una cuenta de DataMotion?

Para registrarse en una cuenta de DataMotion, vaya a datamotion.com/portal donde verá una lista de planes de API mostrados. Mantenga el puntero sobre el plan "entrega segura de mensajes" y haga clic en el icono "Probar ahora".

Una vez que haya seleccionado "Probar", verá la página "API – secure message delivery Self-Service Center" (API: entrega segura de mensajes Self-Service Centro). Este centro proporciona la opción de probar las API de DataMotion, revisar la documentación y ponerse en contacto con el soporte técnico si es necesario.

En la esquina superior derecha de la pantalla hay un botón "Iniciar sesión". Seleccione este botón para empezar. Aparecerá un nuevo elemento emergente una vez seleccionado el botón; en la parte inferior de esta ventana emergente, seleccione "Suscribirse aquí".

Una vez completados estos pasos, verá una solicitud de información y una sección para crear una contraseña. Escriba la información necesaria y cree la contraseña segura.

Revise y acepte los términos de servicio y, a continuación, finalice el proceso seleccionando "Crear su cuenta". ¡Ahí lo tienes! Su cuenta se ha creado y tendrá automáticamente un saldo de $25 para probar nuestras API.

¿Cómo puedo agregar mi saldo?

Para agregar al saldo, vaya al portal de entrega de mensajes seguros de DataMotion y seleccione "Pagos" en el saldo disponible. Proporcione el nombre, la empresa y la dirección y, a continuación, presione "Siguiente". Desde aquí, puede configurar un pago periódico que se rellenará automáticamente; también tiene la opción de realizar un pago único.

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Enviar un mensaje seguro

Envía un mensaje de forma segura, lo que garantiza que los datos no están dañados.

Retirar un mensaje seguro

Retirar un mensaje seguro que se envió anteriormente.

Seguimiento de un mensaje seguro

Realice un seguimiento de un mensaje seguro para asegurarse de que el mensaje se entrega y se abre.

Enviar un mensaje seguro

Envía un mensaje de forma segura, lo que garantiza que los datos no están dañados.

Parámetros

Nombre Clave Requerido Tipo Description
De
From True string

Dirección del usuario que enviará el mensaje.

Para
To array of string

Matriz de destinatarios del mensaje seguro.

CC
Cc array of string

Matriz de destinatarios, carbono copiado en el mensaje seguro.

Bcc
Bcc array of string

Matriz de destinatarios, carbono ciego copiado en el mensaje seguro.

Asunto
Subject string

Asunto del mensaje seguro.

AttachmentBase64
AttachmentBase64 string

Cadena codificada en Base64 de los datos adjuntos.

ContentType
ContentType string

Tipo de medio de los datos adjuntos.

NombreDeArchivo
FileName string

Nombre del archivo adjunto.

ContentId
ContentId string

El identificador de contenido (solo se rellena si los datos adjuntos son una imagen insertada).

HtmlBody
HtmlBody string

Cuerpo HTML del mensaje de correo electrónico.

TextBody
TextBody string

Cuerpo de texto del mensaje de correo electrónico.

v
v True string

Versión de la API. Para encontrar esto, visite https://developers.datamotion.com y seleccione "Versiones de API (BaseURL)" en el menú de la izquierda.

X-API-Key
X-API-Key True string

Identificador único que se usa para identificar el objeto clave de API. Para obtener más información sobre esto, visite https://datamotion.com/how-to-use-datamotion-with-power-automate/.

X-API-Secret
X-API-Secret True string

Valor secreto asociado a la clave de API. Para obtener más información sobre esto, visite https://datamotion.com/how-to-use-datamotion-with-power-automate/.

Devoluciones

Enviar un modelo de respuesta de mensaje seguro.

Retirar un mensaje seguro

Retirar un mensaje seguro que se envió anteriormente.

Parámetros

Nombre Clave Requerido Tipo Description
TransactionId
transactionId True uuid

Identificador del mensaje seguro que se va a retirar.

v
v True string

Versión de la API. Para encontrar esto, visite https://developers.datamotion.com y seleccione "Versiones de API (BaseURL)" en el menú de la izquierda.

X-API-Key
X-API-Key True string

Identificador único que se usa para identificar el objeto clave de API. Para obtener más información sobre esto, visite https://datamotion.com/how-to-use-datamotion-with-power-automate/.

X-API-Secret
X-API-Secret True string

Valor secreto asociado a la clave de API. Para obtener más información sobre esto, visite https://datamotion.com/how-to-use-datamotion-with-power-automate/.

Seguimiento de un mensaje seguro

Realice un seguimiento de un mensaje seguro para asegurarse de que el mensaje se entrega y se abre.

Parámetros

Nombre Clave Requerido Tipo Description
TransactionId
transactionId True uuid

Identificador del mensaje seguro al que se va a realizar el seguimiento.

v
v True string

Versión de la API. Para encontrar esto, visite https://developers.datamotion.com y seleccione "Versiones de API (BaseURL)" en el menú de la izquierda.

X-API-Key
X-API-Key True string

Identificador único que se usa para identificar el objeto clave de API. Para obtener más información sobre esto, visite https://datamotion.com/how-to-use-datamotion-with-power-automate/.

X-API-Secret
X-API-Secret True string

Valor secreto asociado a la clave de API. Para obtener más información sobre esto, visite https://datamotion.com/how-to-use-datamotion-with-power-automate/.

Devoluciones

Objeto de seguimiento de mensajes.

Definiciones

SendSecureMessageResponse

Enviar un modelo de respuesta de mensaje seguro.

Nombre Ruta de acceso Tipo Description
TransactionId
TransactionId uuid

Identificador de la transacción.

NumberOfRecipients
NumberOfRecipients integer

Número total de destinatarios.

MessageSize
MessageSize integer

Tamaño del mensaje en bytes.

Expiration
Expiration string

Fecha y hora en la que expira el mensaje.

ProjectId
ProjectId uuid

Identificador del proyecto.

ApplicationId
ApplicationId uuid

Identificador de la aplicación

TrackMessageResponse

Objeto de seguimiento de mensajes.

Nombre Ruta de acceso Tipo Description
Cost
Cost double

Costo total de la transacción.

Attachments
Attachments array of AttachmentMetaData

Tipo complejo que contiene la estructura de datos adjuntos, la estructura SecurityEnvelope y la estructura de seguimiento por datos adjuntos.

ExpirationDate
ExpirationDate string

Fecha y hora para la expiración del mensaje.

MessageId
MessageId integer

El id. del mensaje.

MessageSize
MessageSize integer

Tamaño del mensaje en bytes.

SecurityEnvelope
SecurityEnvelope object

Objeto de sobre de seguridad del mensaje.

Seguimiento
Tracking array of Tracking

Lista de objetos de seguimiento de mensajes.

Asunto
Subject string

Asunto del mensaje.

AttachmentMetaData

Objeto de datos adjuntos del mensaje.

Nombre Ruta de acceso Tipo Description
AttachmentId
AttachmentId integer

Identificador único de datos adjuntos.

NombreDeArchivo
FileName string

Nombre del archivo adjunto.

ContentId
ContentId object

Identificador de contenido adjunto (solo se rellena si los datos adjuntos son una imagen insertada).

ContentType
ContentType string

Tipo de medio de los datos adjuntos.

SecurityEnvelope
SecurityEnvelope object

Sobre de seguridad de datos adjuntos.

Tamaño
Size Size

Objeto de tamaño de datos adjuntos.

Seguimiento
Tracking AttachmentTracking

Información de seguimiento de datos adjuntos.

Seguimiento

Información de seguimiento de mensajes.

Nombre Ruta de acceso Tipo Description
DateOpened
DateOpened string

Cadena de fecha y hora de cuando se abrió el mensaje. Nota: Si year = 1900, no hay ninguna fechaAbrida asociada con el estado actual del mensaje.

Correo Electrónico
Email string

Dirección de correo electrónico del destinatario.

MessageStatusDescription
MessageStatusDescription string

Estado representado como una descripción de cadena.

MessageStatusId
MessageStatusId integer

Indicador numérico del estado del destinatario individual.

ReceiverField
ReceiverField string

Indica si este destinatario era el TO, CC o CCO del mensaje.

Tamaño

Objeto de tamaño de datos adjuntos.

Nombre Ruta de acceso Tipo Description
StdString
StdString string

Valor de cadena que contiene el tamaño de un archivo adjunto;

AttachmentTracking

Información de seguimiento de datos adjuntos.

Nombre Ruta de acceso Tipo Description
Recipientes
Recipients array of Recipient

Objeto de destinatario del mensaje.

DateOpened
DateOpened string

Cadena de fecha y hora de cuando se abrió el mensaje. Nota: Si year = 1900, no hay ninguna fechaAbrida asociada con el estado actual del mensaje.

Correo Electrónico
Email string

Dirección de correo electrónico del destinatario.

MessageStatusDescription
MessageStatusDescription string

Estado representado como una descripción de cadena.

MessageStatusId
MessageStatusId integer

Indicador numérico del estado del destinatario individual.

ReceiverField
ReceiverField string

Indica si este destinatario era el TO, CC o CCO del mensaje.

Destinatario

Objeto de destinatario del mensaje.

Nombre Ruta de acceso Tipo Description
ChecksumValidated
ChecksumValidated integer

Uno de los siguientes valores: 0 (no válido), 1 (válido) o 2 (NotApplied).

Entregado
Delivered boolean

Indica si el mensaje se ha entregado o no.

DeliveredDate
DeliveredDate string

Cadena DateTime que representa cuándo se entregó el mensaje.

Descargó
Downloaded boolean

Indica si se han descargado o no los datos adjuntos.

DownloadedDate
DownloadedDate string

Cadena DateTime que representa cuándo se descargó el archivo adjunto.

Correo Electrónico
Email string

Dirección de correo electrónico del destinatario.