Compartilhar via


EasyPost Mail (versão prévia)

A Bing Technologies permite que você envie emails postais, emails, SMS e fax diretamente do seu computador com um único clique. A API EasyPost permite uploads automatizados e autenticados nos serviços de comunicação do Bing, dando suporte a documentos únicos ou em lote com metadados, fornecidos manualmente ou extraídos automaticamente. Depois de carregados, os sistemas do Bing validam, processam, imprimem e apresentam seus emails. Uma conta do Bing é necessária para uso. Para obter detalhes, consulte www.bingmail.com.au.

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 do Bing
URL https://help.bingmail.com.au/
Email customerservice@bingmail.com.au
Metadados do conector
Publicador Tecnologias do Bing
Documentação da API https://docs.microsoft.com/connectors/easypostdocumentatio
Website https://www.bingmail.com.au/
Política de privacidade https://bingmail.com.au/privacy-policy
Categorias Operações de TI
connectionDisplayName Conexão EasyPost
connectionDescription Conectar-se ao Easypost usando suas credenciais de conta

Conector do Bing EasyPost

Documentação original do Upload Direto

A API EasyPost fornece upload direto automatizado de documentos para os serviços de comunicação do Bing. A API estabelece uma sessão autenticada que permite o upload de um documento ou conjunto de documentos e metadados associados. Depois de concluir a sessão, os sistemas com suporte do Bing validarão, processarão, imprimirão e apresentarão seu email. As informações de endereçamento são fornecidas à API por meio de um arquivo de metadados ou, como alternativa, o processador automático pode extrair endereço e outros metadados de dentro dos documentos.

Publicador

Esse conector é gerenciado e publicado pela Bing Technologies Pty Ltd

Pré-requisitos

Para usar o EasyPost Connector, você precisará:

  • Um plano do Microsoft Power Apps ou do Power Automate
  • Uma conta de cliente do Bing
  • Uma conta de usuário e senha do portal do Bing

Operações com suporte

O conector dá suporte às seguintes operações:

  • Get session ID: obtenha a ID da sessão usando o código da conta do Bing e a conexão de Autenticação Básica anexada, uma ID de sessão é solicitada. Isso usa uma solicitação HTTP GET para "publicinterface/get_session_id.json". Isso retornará uma EPID (ID de sessão) no formato JSON.
  • Upload files: carregue metadados e documento Usando uma ID de sessão fornecida, uma URL é construída para carregar os arquivos usando a solicitação HTTP PUT. Vários arquivos podem ser carregados na sessão usando quantas etapas carregar arquivos forem necessárias.
  • End session: encerre a sessão Encerrar a sessão com outra solicitação HTTP GET para o ponto de extremidade "publicinterface/end_session.json" com a ID da sessão fornecida. Isso retornará um status e uma lista dos arquivos que foram recebidos com êxito. Em seguida, ele disparará o processamento de back-end dos recursos carregados. As cartas enviadas aparecerão no portal do cliente do Bing, identificáveis pela ID da sessão.

Exemplo típico:

[Get Session ID]  -->  [Upload files]  -->  [End session]

Authentication

Esse conector só dá suporte à Autenticação básica de acesso. O prompt para criar uma conexão usando credenciais válidas do Bing se apresentará ao adicionar esse conector como uma nova etapa pela primeira vez.

Problemas e limitações conhecidos

Item Description
Autenticação digest A autenticação digest é compatível (e preferencial) para essa API, no entanto, os conectores personalizados do Power Automate atualmente não dão suporte à Autenticação Digest pronta para uso.
multipart/form-data Outro método de carregamento direto de arquivos para o sistema EasyPost é o método de formulário multipart, no entanto, os conectores personalizados do Power Automate atualmente não dão suporte a isso.
Encerrar a sessão 200 OK Ao usar a ação End session , se fornecer uma ID de sessão inválida, o sistema retornará 200 OK, mas com um corpo de: "error": "unknown session"
Problema de ações de tipo GET Power Automate incluindo tipo de corpo inválido em solicitações de tipo GET.
RESOLVIDO NA ATUALIZAÇÃO 1.0.4

Versão: 1.0.4


Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:

Autenticação básica Faça logon usando seu nome de usuário e senha para o Bing. Todas as regiões Não compartilhável
Padrão [PRETERIDO] Essa opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores. Todas as regiões Não compartilhável

autenticação Básica

ID de autenticação: basic-auth

Aplicável: todas as regiões

Faça logon usando seu nome de usuário e senha para o Bing.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
Nome de usuário cadeia Verdade
Senha secureString Verdade

Padrão [PRETERIDO]

Aplicável: todas as regiões

Essa opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limitações

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

Ações

Carregar arquivos

Carregar um único arquivo usando uma ID de sessão válida

Encerrar sessão

Encerre uma sessão válida, concluindo o upload para começar a imprimir ou enviar.

Obter a ID da sessão

Obter uma ID de sessão válida para começar a carregar arquivos

Carregar arquivos

Carregar um único arquivo usando uma ID de sessão válida

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da Sessão
session_id True string

A ID da sessão para a qual carregar arquivos

Nome do Arquivo
file_name True string

O nome do arquivo (extensão de arquivo incl)

Conteúdo do arquivo
fileContent True binary

Encerrar sessão

Encerre uma sessão válida, concluindo o upload para começar a imprimir ou enviar.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da Sessão
session_id True string

A ID da sessão que você deseja encerrar.

Retornos

Nome Caminho Tipo Description
ID da Sessão
session_id string

A ID da sessão encerrada

Resultado da sessão
result string

Resultado final da sessão (OK, NO FILES etc..)

status
status string
arquivos
files array of object
Nome do Arquivo
files.name string

Nome de arquivo carregado

files.sz integer

Tamanho do arquivo carregado

Tamanho do upload
files.upld_sz integer
cl_sz
files.cl_sz integer
Pedaços
files.chunks integer
intenção
files.intent integer
primeiro
files.first double
último
files.last double
hospedar
files.host string

Solicitação interna de tratamento de host

apath
files.apath string
gpath
files.gpath string
sha1
files.sha1 string
erro
error string

Falha na solicitação, geralmente sessão desconhecida.

Erra
errs array of string

Obter a ID da sessão

Obter uma ID de sessão válida para começar a carregar arquivos

Parâmetros

Nome Chave Obrigatório Tipo Description
Código da conta do Bing
account True string

O código da conta do Bing associado à solicitação.

Retornos

Nome Caminho Tipo Description
Nome de usuário
user string

O nome de usuário associado à solicitação.

AccountID
account string

A ID da conta do Bing associada à solicitação.

ID da Sessão
session_id string

A ID da sessão criada