Forma de email (versão prévia)
A maneira mais fácil de imprimir e enviar cartas e cartões postais: USPS First Class, Certified, Priority e Priority Express Mail.
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 a forma de email |
| URL | https://help.mailform.io |
| support@mailform.io |
| Metadados do conector | |
|---|---|
| Publicador | Mailform, Inc. |
| Site | https://www.mailform.io |
| Política de Privacidade | https://www.mailform.io/privacy |
| Termos de Serviço | https://www.mailform.io/terms |
| Categorias | Gestão de empresas; Marketing |
O conector mailform permite que os fluxos no ambiente do Power Automate enviem emails físicos: forneça uma prova de PDF e algumas especificações de impressão, como impressão em preto e preto ou impressão simplex/duplex, e o Mailform imprimirá o documento para especificar, o colocará em um envelope apropriado, adicionará postagem e o entregará ao USPS (e em breve, FedEx) em seu nome. O conector fornece um método simples e simples para fazer isso: você pode, por exemplo, ter um fluxo que reage a uma nova inscrição de usuário enviando-lhes documentos de marketing ou enviando a um cliente um cartão postal com um cupom 30 dias após o envio do pedido.
Pré-requisitos
Você precisará do seguinte para continuar:
- Uma conta do Mailform com uma conta de crédito válida, diferente de zero (para pagar seus trabalhos de impressão e email). Inscreva-se gratuitamente no Mailform
Como obter credenciais
Para obter credenciais:
- Faça logon em sua conta do Mailform no Mailform
- Vá para suas configurações de Cobrança visitando a Cobrança do Mailform
- Clique no botão Crédito da Conta de Compra e clique na opção $25.00 para adicionar o valor mínimo de crédito à sua conta.
- Conclua o processo de pagamento: isso criará uma conta de crédito e adicionará crédito à sua conta.
- Acesse as configurações de Acesso à API clicando na guia ACESSO à API ou visitando o Acesso à API do Mailform
- Clique no botão NOVO TOKEN de API e, em seguida, dê um rótulo ao token (como o Teste do Power Automate). Durante o teste, você pode habilitar o modo de teste para essa chave: todas as solicitações de API serão aceitas e verificadas, mas nenhum email real será enviado. Os pedidos do modo de teste serão aceitos e cancelados imediatamente e não afetarão seu saldo de crédito.
- O novo token de API será mostrado: copie-o para baixo, pois ele NÃO será exibido novamente. Observe que os tokens de API do modo de teste nunca podem ser alternados para fora do modo de teste: quando você estiver pronto para entrar em operação, precisará criar um novo token de API.
Introdução ao conector
Para demonstrar o uso do Mailform, criaremos um fluxo que enviará um panfleto com um código de cupom no meu aniversário. No editor do Power Automate:
- Crie um novo fluxo clicando no botão Criar.
- Selecione a opção Fluxo de Nuvem Agendado.
- Nomeie o fluxo e defina a data e a frequência (nesse caso, a cada 12 meses em 27 de dezembro de 2023).
- Clique no botão Criar.
- Clique no ícone de adição e clique em Adicionar uma ação.
- Na caixa de diálogo, procure o Mailform e, em seguida, selecione Imprimir e envia uma carta ou cartão postal usando a ação Mailform.
- Preencha os endereços do destinatário e do remetente.
- Preencha as especificações de documento e impressão: primeiro clique na opção Parâmetros Avançados e selecione a URL e insira o valor https://www.mailform.io/samples/sampleflyer.pdf. Em seguida, clique na opção Parâmetros Avançados e selecione a cor e selecione Sim.
- Clique no botão Salvar na parte superior do editor e terminamos. Quando o fluxo for executado, o pedido será colocado na conta mailform associada à chave de API.
Problemas e limitações conhecidos
- As provas de impressão devem ter menos de 40 MB: se o documento PDF que você está endereçando for superior a 40 MB, você precisará pré-processá-lo para reduzir o tamanho do arquivo.
Erros e soluções comuns
N/A
perguntas frequentes
N/A
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
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 |
|---|---|---|---|
| Chave de API | secureString | A chave de API do Mailform a ser usada para essa conexão | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Imprime e envia uma carta ou cartão postal usando o Mailform |
Cria uma nova ordem mailform fornecendo a prova de impressão, bem como os detalhes do pedido (classe de serviço, cor/preto e branco, impressão de lado único/duplo e muito mais) |
| Obtém o usuário autenticado |
Recuperar informações sobre o usuário do Mailform autenticado |
| Obtém uma ordem existente |
Recuperar uma ordem existente criada por meio da API |
Imprime e envia uma carta ou cartão postal usando o Mailform
Cria uma nova ordem mailform fornecendo a prova de impressão, bem como os detalhes do pedido (classe de serviço, cor/preto e branco, impressão de lado único/duplo e muito mais)
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
File
|
file | file |
O documento PDF a ser enviado por email |
|
|
URL
|
url | string |
A URL do PDF será baixada |
|
|
Referência do cliente
|
customer_reference | string |
Uma referência opcional do cliente a ser anexada ao pedido |
|
|
Serviço de Entrega
|
service | True | string |
O serviço de entrega a ser usado. Deve ser um dos valores especificados |
|
Webhook de notificação
|
webhook | string |
O webhook que deve receber notificações sobre atualizações de pedidos para essa ordem |
|
|
Lado único/duplo
|
simplex | boolean |
True se o documento deve ser impresso uma página em uma planilha, false se o documento puder ser impresso em ambos os lados de uma planilha |
|
|
Cor/Preto & Branco
|
color | boolean |
True se o documento deve ser impresso em cores, false se o documento deve ser impresso em preto e branco |
|
|
Incluir Envelope Simples
|
flat | boolean |
True se o documento DEVE ser enviado por email em um envelope simples, false se for aceitável enviar o documento dobrado |
|
|
Incluir envelope de retorno
|
return_envelope | boolean |
True se o documento DEVE ser enviado por email com um envelope de retorno. Não especifique se nenhum envelope de retorno é necessário |
|
|
Usar Carimbo Real
|
stamp | boolean |
True se o documento DEVE usar um carimbo de postagem real, false se for aceitável enviar o documento usando postagem limitada ou uma marca |
|
|
Mensagem de cartão postal
|
message | string |
A mensagem a ser impressa no lado não-imagem de um cartão postal. Obrigatório se o serviço estiver definido como USPS_POSTCARD |
|
|
Nome do destinatário
|
to.name | True | string |
O nome do destinatário deste envelope ou cartão postal |
|
Empresa/organização do destinatário
|
to.organization | string |
A organização ou a empresa do destinatário |
|
|
Endereço de Rua do Destinatário
|
to.address1 | True | string |
O número da rua e o nome do destinatário |
|
Pacote de destinatários/sala/piso/número de unidade
|
to.address2 | string |
O número do pacote ou quarto do destinatário |
|
|
Cidade do Destinatário
|
to.city | True | string |
A cidade do endereço do destinatário |
|
Estado/localidade do destinatário
|
to.state | True | string |
O estado do endereço do destinatário |
|
Código postal/cep do destinatário
|
to.postcode | True | string |
O código postal ou cep do destinatário |
|
País do Destinatário
|
to.country | string |
O país de endereço do destinatário |
|
|
Nome do remetente
|
from.name | True | string |
O nome do remetente |
|
Empresa/Organização do Remetente
|
from.organization | string |
A organização ou a empresa do remetente |
|
|
Endereço de Rua do Remetente
|
from.address1 | True | string |
O número da rua e o nome do remetente |
|
Sender Suite/Room/Floor/Unit Number
|
from.address2 | string |
O número do pacote ou quarto do remetente |
|
|
Cidade do Remetente
|
from.city | True | string |
A cidade do endereço do remetente |
|
Estado/Localidade do Remetente
|
from.state | True | string |
O estado do endereço do remetente |
|
Código postal do remetente/cep
|
from.postcode | True | string |
O código postal ou cep do remetente |
|
País do Remetente
|
from.country | string |
O país de endereço do remetente |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
codificar
|
error.code | string |
código de erro |
|
mensagem
|
error.message | string |
mensagem de erro |
|
details
|
details | string |
outros detalhes |
|
sucesso
|
success | boolean |
true sobre o sucesso |
|
id
|
data.id | string | |
|
lineitems
|
data.lineitems | array of object | |
|
id
|
data.lineitems.id | string | |
|
serviço
|
data.lineitems.service | string |
Obtém o usuário autenticado
Recuperar informações sobre o usuário do Mailform autenticado
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | string | |
|
email
|
string | ||
|
nome
|
name | string | |
|
id
|
balance.id | string | |
|
quantidade
|
balance.amount | integer | |
|
moeda
|
balance.currency | string |
Obtém uma ordem existente
Recuperar uma ordem existente criada por meio da API
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do pedido de formulário de email
|
id | True | string |
A ID da ordem do Mailform |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
codificar
|
error.code | string |
código de erro |
|
mensagem
|
error.message | string |
mensagem de erro |
|
details
|
details | string |
outros detalhes |
|
sucesso
|
success | boolean |
true sobre o sucesso |
|
id
|
data.id | string | |
|
lineitems
|
data.lineitems | array of object | |
|
id
|
data.lineitems.id | string | |
|
serviço
|
data.lineitems.service | string | |
|
tracking_number
|
data.lineitems.tracking_number | string |