Compartilhar via


DataMotion (versão prévia)

A DataMotion, Inc. é 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. O protocolo de segurança a seguir pode ser demorado, mas o conector do DataMotion permite mensagens criptografadas unidirecionais, ajudando os usuários a permanecerem em conformidade com as regulamentações do setor e as políticas de segurança da sua empresa.

Esse conector está disponível nos seguintes produtos e regiões:

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Regiões do Azure Governamental
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Suporte ao DataMotion
URL https://datamotion.com/support-request/
Email support@datamotion.com
Metadados do conector
Publicador DataMotion, Inc.
Site https://datamotion.com/secure-message-delivery-api/
Política de privacidade https://datamotion.com/privacy-policy/
Categorias Comunicação; Segurança

DataMotion, Inc. é uma empresa de API especializada em transferência segura de dados. Isso significa que você pode utilizar nosso conector de entrega de mensagens segura para enviar com segurança texto criptografado, documentos, imagens, arquivos e muito mais para qualquer usuário com um endereço de email 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 em trânsito ou em sua caixa de entrada. Além de enviar mensagens com segurança, o conector de entrega de mensagens segura permite que você rastreie e retraia mensagens seguras. Ao integrar essa funcionalidade em seus fluxos de trabalho, os usuários poderão automatizar com segurança tarefas que podem estar completamente fora de questão antes, pois a automação pode ter comprometido a segurança. Sua organização poderá aproveitar o Power Automate para automatizar uma miríade de tarefas, incluindo o tratamento adequado e seguro de informações clínicas, a transferência de registros de saúde do paciente, a transferência de stubs de pagamento, o armazenamento de planos de desativação dos funcionários e muito mais.

Pré-requisitos

Para utilizar o conector de entrega de mensagens segura 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 iniciar. Para criar uma conta, navegue até datamotion.com/portal.

Depois de concluir essa etapa, você receberá automaticamente um crédito de US$ 25 para testar a API. A partir daqui, você pode selecionar "Pagamentos" para continuar a adicionar ao seu saldo na forma de um pagamento único ou recorrente. Você precisará de um equilíbrio para continuar enviando, rastreando e retraindo mensagens seguras com o conector de entrega de mensagens segura.

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 mouse sobre o plano de "entrega de mensagens seguras" e clique no ícone "Experimentar Agora".

Depois de selecionar "Experimentar Agora", você verá a página "API – entrega segura de mensagens Self-Service Central" exibida. Esse centro fornece a opção de testar as APIs do DataMotion, examinar a documentação e entrar em contato com o suporte, se necessário.

No canto superior direito da tela, há um botão "Logon". Clique neste botão para começar. Um novo pop-up será exibido quando 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. Insira as informações necessárias e crie sua senha segura.

Examine e concorde com os termos de serviço e conclua o processo selecionando "Criar sua conta". Aí está você! Sua conta foi criada e você terá automaticamente um saldo de US$ 25 para testar nossas APIs.

Introdução ao nosso conector

A entrega segura de mensagens do DataMotion é uma adição perfeita nos fluxos de trabalho automatizados. O conector em si não pode ser usado como um gatilho, mas pode ser usado para enviar, rastrear e retrair mensagens seguras depois que o fluxo de trabalho é inflamado.

Há alguns gatilhos comuns para fluxos de trabalho que utilizam o conector de entrega de mensagens segura. Um envio de formulário é um exemplo, pois talvez os usuários precisem extrair dados confidenciais de um formulário e enviá-los de maneira segura. Assinar um formulário usando o conector DocuSign também será um gatilho comum. Documentos importantes que precisam ser assinados e passados geralmente são críticos para os negócios ou contêm PII, PHI ou PCI e, portanto, devem ser enviados com segurança. Por fim, um intervalo cronometrado pode ser usado para disparar um fluxo de trabalho diariamente, semanalmente ou mensalmente. Isso é especialmente útil quando dados importantes, como uma lista de contas de cliente atualizada ou revisão semanal de lucro, precisam ser criptografados e enviados a terceiros regularmente.

Para começar a usar o conector de entrega de mensagens segura, 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.

Depois que um gatilho for selecionado, 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 coletar dados confidenciais por meio do fluxo de trabalho, a próxima etapa é enviar os dados por meio de uma mensagem segura. Para fazer isso, você precisará adicionar uma etapa de fluxo de trabalho adicional.

Para fazer isso, selecione '+ Próxima Etapa' e pesquise o conector DataMotion. Você pode fazer isso digitando "entrega segura de mensagens" na barra de pesquisa na parte superior da nova seção da 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 talvez seja necessário 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 i" do nosso portal de autoatendimento. Na parte superior da seção 'Parâmetro Obrigatório', você pode encontrar a versão da API.
  • X-API-Secret

    • Para obter a chave secreta da API, navegue de volta para o centro de autoatendimento e entre. Depois de entrar, uma nova guia deverá aparecer intitulada "Aplicativos". Selecione esta guia.
      • A partir daqui, selecione o botão "Criar Aplicativo" e dê um nome ao aplicativo. Em seguida, selecione "Outros" para o Tipo de Aplicativo e forneça uma descrição.
      • Selecione o sinal 'plus' (+) no centro da seção Chaves de API e copie o Segredo da API fornecido no pop-up. Cole essa chave na caixa de texto X-API-Secret no Power Automate.
  • Chave X-API

    • Na seção Chave de 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 do qual você está enviando a mensagem segura. Insira 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 usado para o endereço a partir ou qualquer endereço ao qual tenha acesso.
  • Cc (opcional)

    • Insira qualquer endereço de email adicional que tenha uma caixa de correio correspondente que você gostaria de copiar.
  • Cco (opcional)

    • Insira qualquer endereço de email adicional que tenha uma caixa de correio correspondente que você gostaria de copiar cegamente.
  • Assunto (opcional)

    • Insira o assunto do email.
  • 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 de 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 o corpo da mensagem. Para este exemplo, você pode manter esta seção em branco.
  • TextBody (opcional)

    • Nessa área, delineia o corpo em texto sem formatação e adicione as informações confidenciais que você gostaria de enviar.

Ao clicar em cada uma das caixas de texto, você poderá 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 email.

Depois de finalizar suas 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 de mensagens seguras do DataMotion!

Problemas e limitações conhecidos

O conector de entrega de mensagens segura do DataMotion tem uma limitação conhecida. Se um usuário tentar rastrear ou retrair uma mensagem diretamente depois de enviá-la, uma mensagem de erro poderá aparecer indicando que a mensagem não pôde ser encontrada. Isso ocorre porque a ID da mensagem ainda não foi atualizada. Um atraso de dois segundos ou uma nova tentativa de falha resolverá esse problema.

Erros e soluções comuns

Um segredo ou chave de API inválido resultará em um erro 401. Para resolver esse erro, você precisa criar uma nova chave. Navegue até o portal de entrega de mensagens segura do DataMotion e selecione a guia Aplicativos. Nesta guia, você verá uma seção chave de API com a exibição da chave de API atual. Exclua sua chave de API atual com o ícone de lixeira localizado à direita da chave.

Depois que o ícone de 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 essa opção e salve com segurança a chave secreta (que você verá exibida), pois não poderá acessar essa chave novamente no portal datamotion. A partir daqui, copie sua nova chave de API para o fluxo de trabalho do Power Automate.

perguntas frequentes

Onde posso obter uma chave de API e um segredo?

Para criar uma chave ou segredo de API, navegue até o portal de entrega de mensagens segura datamotion e selecione a guia 'Aplicativos'. Na seção 'Chave de API', uma opção para adicionar uma chave estará disponível; você verá a opção no meio da seção. Selecione essa opção e salve com segurança a chave secreta que será exibida, pois você não poderá acessar essa chave novamente no portal datamotion. A partir daqui, copie sua nova chave de API para o fluxo de trabalho do Power Automate.

Como fazer para me inscrever em uma conta do DataMotion?

Para se inscrever em uma conta datamotion, navegue até datamotion.com/portal em que você verá uma lista de planos de API exibidos. Passe o mouse sobre o plano de "entrega de mensagens seguras" e clique no ícone "Experimentar Agora".

Depois de selecionar "Experimentar", você verá a página "API – entrega segura de mensagens Self-Service Center" exibida. Esse centro fornece a opção de testar as APIs do DataMotion, examinar a documentação e entrar em contato com o suporte, se necessário.

No canto superior direito da tela, há um botão "Logon". Selecione este botão para começar. Um novo pop-up será exibido quando o botão estiver selecionado - na parte inferior deste pop-up, selecione "inscrever-se aqui".

Depois de concluir essas etapas, você verá uma solicitação de informações e uma seção para criar uma senha. Insira as informações necessárias e crie sua senha segura.

Examine e concorde com os termos de serviço e conclua o processo selecionando "Criar sua conta". Aí está você! Sua conta foi criada e você terá automaticamente um saldo de US$ 25 para testar nossas APIs.

Como fazer para adicionar ao meu equilíbrio?

Para adicionar ao seu saldo, navegue até o portal de entrega de mensagens segura datamotion e selecione "Pagamentos" em seu saldo disponível. Forneça seu nome, empresa e endereço e clique em "Avançar". 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.

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Acompanhar uma mensagem segura

Acompanhe uma mensagem segura para garantir que a mensagem seja entregue e aberta.

Enviar uma mensagem segura

Envia uma mensagem de maneira segura, garantindo que os dados não sejam corrompidos.

Retrair uma mensagem segura

Retraia uma mensagem segura que foi enviada anteriormente.

Acompanhar uma mensagem segura

Acompanhe uma mensagem segura para garantir que a mensagem seja entregue e aberta.

Parâmetros

Nome Chave Obrigatório Tipo Description
TransactionId
transactionId True uuid

A 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, em seguida, selecione "Versões de API (BaseURL)" no menu à esquerda.

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

Um identificador exclusivo usado para identificar o objeto chave de API. 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/.

Retornos

Objeto de acompanhamento de mensagens.

Enviar uma mensagem segura

Envia uma mensagem de maneira segura, garantindo que os dados não sejam corrompidos.

Parâmetros

Nome Chave Obrigató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.

Bcc
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.

ContentType
ContentType string

O tipo de mídia do anexo.

Nome do Arquivo
FileName string

O nome do arquivo de anexo.

ContentId
ContentId string

A ID de Conteúdo (preenchida somente se o anexo for uma imagem embutida).

HtmlBody
HtmlBody string

O corpo HTML da mensagem de email.

TextBody
TextBody string

O corpo do texto da mensagem de email.

v
v True string

A versão da API. Isso pode ser encontrado visitando https://developers.datamotion.com e, em seguida, selecione "Versões de API (BaseURL)" no menu à esquerda.

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

Um identificador exclusivo usado para identificar o objeto chave de API. 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/.

Retornos

Enviar um modelo de resposta de mensagem segura.

Retrair uma mensagem segura

Retraia uma mensagem segura que foi enviada anteriormente.

Parâmetros

Nome Chave Obrigatório Tipo Description
TransactionId
transactionId True uuid

A ID da mensagem segura a ser retraída.

v
v True string

A versão da API. Isso pode ser encontrado visitando https://developers.datamotion.com e, em seguida, selecione "Versões de API (BaseURL)" no menu à esquerda.

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

Um identificador exclusivo usado para identificar o objeto chave de API. 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 um modelo de resposta de mensagem segura.

Nome Caminho Tipo Description
TransactionId
TransactionId uuid

A ID da transação.

NumberOfRecipients
NumberOfRecipients integer

O número total de destinatários.

MessageSize
MessageSize integer

O tamanho da mensagem em bytes.

Vencimento
Expiration string

A data em que a mensagem expira.

ProjectId
ProjectId uuid

A ID do projeto.

ApplicationId
ApplicationId uuid

A ID do aplicativo

TrackMessageResponse

Objeto de acompanhamento de mensagens.

Nome 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 Anexos, a Estrutura SecurityEnvelope e a Estrutura de Acompanhamento por anexo.

ExpirationDate
ExpirationDate string

A data/hora da expiração da mensagem.

MessageId
MessageId integer

A ID da mensagem.

MessageSize
MessageSize integer

O tamanho da mensagem em bytes.

SecurityEnvelope
SecurityEnvelope object

O objeto de envelope de segurança da mensagem.

Acompanhamento
Tracking array of Tracking

Uma lista de objetos de acompanhamento de mensagens.

Assunto
Subject string

O assunto da mensagem.

AttachmentMetaData

Objeto de anexo de mensagem.

Nome Caminho Tipo Description
AttachmentId
AttachmentId integer

Identificador exclusivo do anexo.

Nome do Arquivo
FileName string

Nome do arquivo de anexo.

ContentId
ContentId object

ID de conteúdo do anexo (populada somente se o anexo for uma imagem embutida).

ContentType
ContentType string

O tipo de mídia do anexo.

SecurityEnvelope
SecurityEnvelope object

Envelope de segurança do anexo.

Tamanho
Size Size

Objeto de tamanho de anexo.

Acompanhamento
Tracking AttachmentTracking

Informações de acompanhamento de anexos.

Acompanhamento

Informações de acompanhamento de mensagens.

Nome Caminho Tipo Description
DateOpened
DateOpened string

A cadeia de caracteres de data/hora de quando a mensagem foi aberta. Observação: se ano = 1900, não haverá DateOpened associado ao status da mensagem atual.

Email
Email string

O endereço de email do destinatário.

MessageStatusDescription
MessageStatusDescription string

Status representado como uma descrição de cadeia de caracteres.

MessageStatusId
MessageStatusId integer

Indicador numérico do status do destinatário individual.

ReceiverField
ReceiverField string

Indica se esse destinatário era o TO, CC ou CCO da mensagem.

Tamanho

Objeto de tamanho de anexo.

Nome Caminho Tipo Description
StdString
StdString string

Um valor de cadeia de caracteres que contém o tamanho de um anexo;

AttachmentTracking

Informações de acompanhamento de anexos.

Nome Caminho Tipo Description
Destinatários
Recipients array of Recipient

Objeto do destinatário da mensagem.

DateOpened
DateOpened string

A cadeia de caracteres de data/hora de quando a mensagem foi aberta. Observação: se ano = 1900, não haverá DateOpened associado ao status da mensagem atual.

Email
Email string

O endereço de email do destinatário.

MessageStatusDescription
MessageStatusDescription string

Status representado como uma descrição de cadeia de caracteres.

MessageStatusId
MessageStatusId integer

Indicador numérico do status do destinatário individual.

ReceiverField
ReceiverField string

Indica se esse destinatário era o TO, CC ou CCO da mensagem.

Recipient

Objeto do destinatário da mensagem.

Nome Caminho Tipo Description
ChecksumValidated
ChecksumValidated integer

Um dos seguintes valores: 0 (Inválido), 1 (Válido) ou 2 (NotApplied).

Entregue
Delivered boolean

Indica se a mensagem foi entregue ou não.

DeliveredDate
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.

DownloadedDate
DownloadedDate string

A cadeia de caracteres DateTime que representa quando o anexo foi baixado.

Email
Email string

O endereço de email do destinatário.