DataMotion (Pré-visualização)
é especializada em APIs seguras de troca de dados, permitindo que as empresas integrem soluções seguras de troca de mensagens e arquivos em seus fluxos de trabalho existentes e economizem tempo de desenvolvimento. Seguir o protocolo de segurança pode ser demorado, mas o conector do DataMotion permite mensagens criptografadas unidirecionais perfeitas, ajudando os usuários a permanecerem em conformidade com as regulamentações do setor e as políticas de segurança da sua empresa.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte DataMotion |
| URL | https://datamotion.com/support-request/ |
| support@datamotion.com |
| Metadados do conector | |
|---|---|
| Editora | DataMotion, Inc. |
| Sítio Web | https://datamotion.com/secure-message-delivery-api/ |
| Política de privacidade | https://datamotion.com/privacy-policy/ |
| Categorias | Comunicação; Segurança |
é uma empresa de API especializada em transferência segura de dados. Isso significa que você pode utilizar nosso conector seguro de entrega de mensagens para enviar com segurança texto, documentos, imagens, arquivos e muito mais criptografados para qualquer usuário com um endereço de e-mail válido. Com essa criptografia de ponta a ponta, você pode ter certeza de que o conteúdo de suas mensagens não foi colocado offline ou alterado de forma alguma, seja durante o trânsito ou na sua caixa de entrada. Além de enviar mensagens com segurança, o conector seguro de entrega de mensagens permite rastrear e retirar mensagens seguras. Ao integrar essa funcionalidade em seus fluxos de trabalho, seus usuários poderão automatizar com segurança tarefas que podem estar completamente fora de questão antes, já que a automação pode ter comprometido a segurança. Sua organização poderá aproveitar o Power Automate para automatizar uma infinidade de tarefas, incluindo o tratamento adequado e seguro de informações clínicas, a transferência de registros de saúde de pacientes, a transferência de holerites, o armazenamento de planos de aposentadoria de funcionários e muito mais.
Pré-requisitos
Para utilizar o conector seguro de entrega de mensagens do DataMotion, primeiro você precisará criar uma conta DataMotion. Você tem a opção de criar uma conta paga baseada em assinatura ou uma avaliação gratuita de 30 dias para começar. Para criar uma conta, navegue até datamotion.com/portal.
Depois de concluir esta etapa, você receberá automaticamente um crédito de US$ 25 para testar a API. A partir daqui, pode selecionar 'Pagamentos' para continuar a adicionar ao seu saldo sob a forma de um pagamento único ou recorrente. Você precisará de um saldo para continuar enviando, rastreando e retirando mensagens seguras com o conector seguro de entrega de mensagens.
Como obter credenciais
Para criar uma conta DataMotion, navegue até datamotion.com/portal onde você verá uma lista de planos de API exibidos. Passe o cursor sobre o plano 'entrega segura de mensagens' e clique no ícone 'Experimentar agora'.
Depois de selecionar 'Experimentar agora', você verá a página 'API – entrega segura de mensagens Self-Service Center' exibida. Este centro oferece a opção de testar as APIs do DataMotion, revisar a documentação e entrar em contato com o suporte, se necessário.
No canto superior direito do ecrã existe um botão 'Login'. Clique neste botão para começar. Um novo pop-up será exibido assim que o botão for selecionado; Na parte inferior deste pop-up, selecione 'Inscreva-se aqui'.
Depois de concluir essas etapas, você verá uma solicitação de informações e uma seção para criar uma senha. Introduza as informações necessárias e crie a sua palavra-passe segura.
Revise e concorde com os termos de serviço e, em seguida, conclua o processo selecionando "Criar sua conta". Aí está! Sua conta foi criada e você terá automaticamente um saldo de $25 para testar nossas APIs.
Comece a usar nosso conector
A entrega segura de mensagens da DataMotion é uma adição perfeita em fluxos de trabalho automatizados. O conector em si não pode ser usado como um gatilho, mas pode ser usado para enviar, rastrear e retirar mensagens seguras assim que o fluxo de trabalho for iniciado.
Existem alguns gatilhos comuns para fluxos de trabalho que utilizam o conector seguro de entrega de mensagens. Um envio de formulário é um exemplo, pois os usuários podem precisar extrair dados confidenciais de um formulário e, em seguida, enviá-los de forma segura. Assinar um formulário usando o conector DocuSign também será um gatilho comum. Documentos importantes que precisam ser assinados e passados são geralmente críticos para os negócios ou contêm PII, PHI ou PCI e, portanto, devem ser enviados com segurança. Finalmente, um intervalo cronometrado pode ser usado para acionar um fluxo de trabalho diariamente, semanalmente ou mensalmente. Isso é especialmente útil quando dados importantes, como uma lista atualizada de contas de clientes ou uma revisão semanal de lucros, precisam ser criptografados e enviados a terceiros regularmente.
Para começar a usar o conector seguro de entrega de mensagens, primeiro crie um novo fluxo de trabalho do Power Automate e selecione um gatilho. Você pode utilizar um dos exemplos acima ou um gatilho mais exclusivo.
Uma vez selecionado um gatilho, você precisará adicionar os dados confidenciais que deseja enviar. Por exemplo, se você escolher um envio de formulário como um gatilho, a primeira etapa no fluxo de trabalho será coletar os dados desse formulário. Depois de reunir dados confidenciais através do seu fluxo de trabalho, o próximo passo é enviar os dados através de uma mensagem segura. Para fazer isso, você precisará adicionar uma etapa de fluxo de trabalho adicional.
Para fazer isso, selecione '+ Next Step' e procure o conector DataMotion. Você pode fazer isso digitando 'entrega segura de mensagens' na barra de pesquisa na parte superior da seção da nova etapa.
Depois de selecionar o botão '+ Próxima etapa', você verá uma lista de ações associadas a esse conector. Escolha 'Enviar mensagem segura' como a ação.
Um novo widget exibirá a solicitação de mensagem segura.
Abaixo, percorrerei cada seção da solicitação e fornecerei entradas de exemplo. Tenha em mente que você pode precisar personalizar esses campos para testar corretamente (especialmente o endereço 'Para'!).
Versão
- V– esta seção está solicitando a versão da API DataMotion que você está usando. Você pode encontrar a versão da API que está usando na seção 'Como fazer' do nosso portal de autoatendimento. Na parte superior da seção 'Parâmetro necessário', você pode encontrar a versão da API.
X-API-Segredo
- Para obter a chave secreta da API, navegue de volta para o centro de autoatendimento e faça login. Depois de iniciar sessão, deverá aparecer um novo separador intitulado "Aplicações". Selecione este separador.
- A partir daqui, selecione o botão 'Criar Aplicação' e dê um nome à aplicação. Em seguida, selecione 'Outro' para o tipo de aplicativo e forneça uma descrição.
- Selecione o sinal de 'mais' (+) no centro da seção Chaves de API e copie o Segredo da API fornecido no pop-up. Cole esta chave na caixa de texto X-API-Secret no Power Automate.
- Para obter a chave secreta da API, navegue de volta para o centro de autoatendimento e faça login. Depois de iniciar sessão, deverá aparecer um novo separador intitulado "Aplicações". Selecione este separador.
Chave X-API
- Na seção Chave da API, copie a chave fornecida e cole-a na seção X-API-Key no Power Automate.
De
- O endereço 'De' será o endereço a partir do qual está a enviar a mensagem segura. Digite o endereço com o qual você criou o Segredo e a Chave da API.
Para
- O endereço «Para» pode ser qualquer endereço com uma caixa de correio. Para testar, você pode inserir o mesmo endereço que você usou para o endereço de origem ou qualquer endereço que você tenha acesso.
Cc (Opcional)
- Digite qualquer endereço de e-mail adicional que tenha uma caixa de correio correspondente que você gostaria de copiar.
Cco (Opcional)
- Digite qualquer endereço de e-mail adicional que tenha uma caixa de correio correspondente que você gostaria de copiar cegamente.
Assunto (Opcional)
- Insira o assunto do e-mail.
Anexos (Opcional)
- Para adicionar um anexo, você precisará fornecer a cadeia de caracteres base64, o tipo de conteúdo, o nome do arquivo e a ID do conteúdo. Há algumas etapas adicionais para coletar essas informações automaticamente, mas para a demonstração de hoje, você pode deixar esta seção em branco.
HtmlBody (Opcional)
- Nesta seção, você pode adicionar texto html para enviar no corpo da mensagem. Para este exemplo, você pode manter esta seção em branco.
TextBody (Opcional)
- Nesta área, destaque o corpo em texto simples e adicione as informações confidenciais que você gostaria de enviar.
Ao clicar em cada uma das caixas de texto, você pode ver "Inserir parâmetros da etapa anterior". Esses parâmetros sugeridos são as respostas que você pode ter extraído anteriormente de um formulário, planilha do Excel ou outro documento confidencial. Você pode selecionar esses parâmetros para incluir esses dados no corpo do e-mail.
Depois de finalizar as configurações, selecione 'Salvar'. Você verá uma mensagem confirmando que seu fluxo de trabalho foi salvo na parte superior da tela.
Agora você criou um fluxo de trabalho que incorpora a API de entrega segura de mensagens DataMotion!
Problemas conhecidos e limitações
O conector seguro de entrega de mensagens do DataMotion tem uma limitação conhecida. Se um usuário tentar rastrear ou retirar uma mensagem diretamente após enviá-la, uma mensagem de erro pode aparecer indicando que a mensagem não pôde ser encontrada. Isso ocorre porque o ID da mensagem ainda não foi atualizado. Um atraso de dois segundos ou uma nova tentativa em caso de falha resolverá esse problema.
Erros e soluções comuns
Um segredo ou chave de API inválida resultará em um erro 401. Para resolver esse erro, você precisa criar uma nova chave. Navegue até o portal seguro de entrega de mensagens DataMotion e selecione a guia Aplicativos. Nesta guia, você verá uma seção Chave de API com sua exibição de chave de API atual. Exclua sua chave de API atual com o ícone da lixeira localizado à direita da chave.
Assim que o ícone da lixeira for selecionado, a chave será removida e uma nova opção para adicionar uma chave estará disponível no meio da seção Chave de API da página. Selecione esta opção e salve com segurança a chave secreta (que você verá exibida), pois você não poderá acessar essa chave novamente a partir do portal DataMotion. A partir daqui, copie a sua nova chave de API para o seu fluxo de trabalho do Power Automatic.
FAQ
Onde posso obter uma chave de API e um segredo?
Para criar uma chave ou segredo de API, navegue até o portal seguro de entrega de mensagens DataMotion e selecione a guia 'Aplicativos'. Na seção 'API Key', uma opção para adicionar uma chave estará disponível; Você verá a opção no meio da seção. Selecione esta opção e salve com segurança a chave secreta que será exibida, pois você não poderá acessar essa chave novamente a partir do portal DataMotion. A partir daqui, copie a sua nova chave de API para o seu fluxo de trabalho do Power Automatic.
Como faço para me inscrever em uma conta DataMotion?
Para se inscrever em uma conta DataMotion, navegue até datamotion.com/portal onde você verá uma lista de planos de API exibidos. Passe o cursor sobre o plano 'entrega segura de mensagens' e clique no ícone 'Experimentar agora'.
Depois de selecionar 'Tentar', você verá a página 'API – entrega segura de mensagens Self-Service Center' exibida. Este centro oferece a opção de testar as APIs do DataMotion, revisar a documentação e entrar em contato com o suporte, se necessário.
No canto superior direito do ecrã existe um botão 'Login'. Selecione este botão para começar. Um novo pop-up será exibido assim que o botão for selecionado - na parte inferior deste pop-up, selecione 'inscreva-se aqui'.
Depois de concluir essas etapas, você verá uma solicitação de informações e uma seção para criar uma senha. Introduza as informações necessárias e crie a sua palavra-passe segura.
Revise e concorde com os termos de serviço e, em seguida, conclua o processo selecionando "Criar sua conta". Aí está! Sua conta foi criada e você terá automaticamente um saldo de $25 para testar nossas APIs.
Como faço para adicionar ao meu saldo?
Para adicionar ao seu saldo, navegue até o portal seguro de entrega de mensagens DataMotion e selecione 'Pagamentos' abaixo do seu saldo disponível. Indique o seu nome, empresa e morada e, em seguida, clique em 'Seguinte'. A partir daqui, você pode configurar um pagamento recorrente que será recarregado automaticamente; Você também tem a opção de fazer um pagamento único.
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Enviar uma mensagem segura |
Envia uma mensagem de forma segura garantindo que os dados não estejam corrompidos. |
| Rastrear uma mensagem segura |
Rastreie uma mensagem segura para garantir que a mensagem seja entregue e aberta. |
| Retirar uma mensagem segura |
Retire uma mensagem segura que foi enviada anteriormente. |
Enviar uma mensagem segura
Envia uma mensagem de forma segura garantindo que os dados não estejam corrompidos.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
De
|
From | True | string |
O endereço do usuário que enviará a mensagem. |
|
Para
|
To | array of string |
Uma matriz de destinatários da mensagem segura. |
|
|
Cc
|
Cc | array of string |
Uma matriz de destinatários, carbono copiado na mensagem segura. |
|
|
Cco
|
Bcc | array of string |
Uma matriz de destinatários, carbono cego copiado na mensagem segura. |
|
|
Assunto
|
Subject | string |
O assunto da mensagem segura. |
|
|
AttachmentBase64
|
AttachmentBase64 | string |
Uma cadeia de caracteres codificada em Base64 do anexo. |
|
|
Tipo de conteúdo
|
ContentType | string |
O tipo de mídia do anexo. |
|
|
Nome do arquivo
|
FileName | string |
O nome do ficheiro anexo. |
|
|
ContentId
|
ContentId | string |
O Content ID (preenchido apenas se o anexo for uma imagem embutida). |
|
|
HtmlBody
|
HtmlBody | string |
O corpo HTML da mensagem de e-mail. |
|
|
Corpo de texto
|
TextBody | string |
O corpo de texto da mensagem de e-mail. |
|
|
v
|
v | True | string |
A versão da API. Isso pode ser encontrado visitando https://developers.datamotion.com e selecionando 'Versões da API (BaseURL)' no menu à esquerda. |
|
X-API-Key
|
X-API-Key | True | string |
Um identificador exclusivo usado para identificar o objeto API Key. Para saber mais sobre isso, visite https://datamotion.com/how-to-use-datamotion-with-power-automate/. |
|
X-API-Secret
|
X-API-Secret | True | string |
Um valor secreto vinculado à chave de API. Para saber mais sobre isso, visite https://datamotion.com/how-to-use-datamotion-with-power-automate/. |
Devoluções
Enviar modelo de resposta de mensagem segura.
Rastrear uma mensagem segura
Rastreie uma mensagem segura para garantir que a mensagem seja entregue e aberta.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
TransactionId
|
transactionId | True | uuid |
O ID da mensagem segura a ser rastreada. |
|
v
|
v | True | string |
A versão da API. Isso pode ser encontrado visitando https://developers.datamotion.com e selecionando 'Versões da API (BaseURL)' no menu à esquerda. |
|
X-API-Key
|
X-API-Key | True | string |
Um identificador exclusivo usado para identificar o objeto API Key. Para saber mais sobre isso, visite https://datamotion.com/how-to-use-datamotion-with-power-automate/. |
|
X-API-Secret
|
X-API-Secret | True | string |
Um valor secreto vinculado à chave de API. Para saber mais sobre isso, visite https://datamotion.com/how-to-use-datamotion-with-power-automate/. |
Devoluções
Objeto de controle de mensagens.
- Body
- TrackMessageResponse
Retirar uma mensagem segura
Retire uma mensagem segura que foi enviada anteriormente.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
TransactionId
|
transactionId | True | uuid |
O ID da mensagem segura a ser retirada. |
|
v
|
v | True | string |
A versão da API. Isso pode ser encontrado visitando https://developers.datamotion.com e selecionando 'Versões da API (BaseURL)' no menu à esquerda. |
|
X-API-Key
|
X-API-Key | True | string |
Um identificador exclusivo usado para identificar o objeto API Key. Para saber mais sobre isso, visite https://datamotion.com/how-to-use-datamotion-with-power-automate/. |
|
X-API-Secret
|
X-API-Secret | True | string |
Um valor secreto vinculado à chave de API. Para saber mais sobre isso, visite https://datamotion.com/how-to-use-datamotion-with-power-automate/. |
Definições
SendSecureMessageResponse
Enviar modelo de resposta de mensagem segura.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
TransactionId
|
TransactionId | uuid |
O ID da transação. |
|
NúmerodeDestinatários
|
NumberOfRecipients | integer |
O número total de destinatários. |
|
MessageSize
|
MessageSize | integer |
O tamanho da mensagem em bytes. |
|
Expiração
|
Expiration | string |
A data e hora em que a mensagem expira. |
|
ProjectId
|
ProjectId | uuid |
O Id do projeto. |
|
ApplicationId
|
ApplicationId | uuid |
O ID do aplicativo |
TrackMessageResponse
Objeto de controle de mensagens.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Custo
|
Cost | double |
Custo total da transação. |
|
Attachments
|
Attachments | array of AttachmentMetaData |
Um tipo complexo que contém a Estrutura de Anexo, a Estrutura SecurityEnvelope e a Estrutura de Controle por anexo. |
|
ExpirationDate
|
ExpirationDate | string |
A data/hora de expiração da mensagem. |
|
MessageId
|
MessageId | integer |
O Id da mensagem. |
|
MessageSize
|
MessageSize | integer |
O tamanho da mensagem em bytes. |
|
SecurityEnvelope
|
SecurityEnvelope | object |
O objeto do envelope de segurança da mensagem. |
|
Monitorização
|
Tracking | array of Tracking |
Uma lista de objetos de controle de mensagens. |
|
Assunto
|
Subject | string |
O assunto da mensagem. |
AttachmentMetaData
Objeto de anexo de mensagem.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
AttachmentId
|
AttachmentId | integer |
Identificador exclusivo do anexo. |
|
Nome do arquivo
|
FileName | string |
Nome do ficheiro anexo. |
|
ContentId
|
ContentId | object |
ID do conteúdo do anexo (preenchido apenas se o anexo for uma imagem embutida). |
|
Tipo de conteúdo
|
ContentType | string |
O tipo de mídia do anexo. |
|
SecurityEnvelope
|
SecurityEnvelope | object |
Envelope de segurança de anexo. |
|
Tamanho
|
Size | Size |
Objeto de tamanho de anexo. |
|
Monitorização
|
Tracking | AttachmentTracking |
Informações de rastreamento de anexos. |
Monitorização
Informações de rastreamento de mensagens.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
DataAberto
|
DateOpened | string |
A cadeia de caracteres de data/hora de quando a mensagem foi aberta. Nota: Se ano = 1900, então não há DateOpened associado ao status da mensagem atual. |
|
Email
|
string |
O endereço de e-mail do destinatário. |
|
|
MessageStatusDescription
|
MessageStatusDescription | string |
Status representado como uma descrição de cadeia de caracteres. |
|
MessageStatusId
|
MessageStatusId | integer |
Indicador numérico do estatuto do destinatário individual. |
|
ReceiverField
|
ReceiverField | string |
Indica se esse destinatário era o TO, CC ou BCC da mensagem. |
Tamanho
Objeto de tamanho de anexo.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
StdString
|
StdString | string |
Um valor de cadeia de caracteres que contém o tamanho de um anexo; |
AttachmentTracking
Informações de rastreamento de anexos.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Destinatários
|
Recipients | array of Recipient |
Objeto do destinatário da mensagem. |
|
DataAberto
|
DateOpened | string |
A cadeia de caracteres de data/hora de quando a mensagem foi aberta. Nota: Se ano = 1900, então não há DateOpened associado ao status da mensagem atual. |
|
Email
|
string |
O endereço de e-mail do destinatário. |
|
|
MessageStatusDescription
|
MessageStatusDescription | string |
Status representado como uma descrição de cadeia de caracteres. |
|
MessageStatusId
|
MessageStatusId | integer |
Indicador numérico do estatuto do destinatário individual. |
|
ReceiverField
|
ReceiverField | string |
Indica se esse destinatário era o TO, CC ou BCC da mensagem. |
Recipient
Objeto do destinatário da mensagem.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Soma de verificaçãovalidada
|
ChecksumValidated | integer |
Um dos seguintes valores: 0 (Invalid), 1 (Valid) ou 2 (NotApplied). |
|
Entregues
|
Delivered | boolean |
Indica se a mensagem foi entregue ou não. |
|
Data de entrega
|
DeliveredDate | string |
A cadeia de caracteres DateTime que representa quando a mensagem foi entregue. |
|
Baixado
|
Downloaded | boolean |
Indica se o anexo foi baixado ou não. |
|
Data de download
|
DownloadedDate | string |
A cadeia de caracteres DateTime que representa quando o anexo foi baixado. |
|
Email
|
string |
O endereço de e-mail do destinatário. |