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.
- 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.
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.
- Body
- TrackMessageResponse
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
|
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
|
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
|
string |
Dirección de correo electrónico del destinatario. |