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/ |
| 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.
- 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.
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.
- Corpo
- TrackMessageResponse
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
|
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
|
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
|
string |
O endereço de email do destinatário. |