Formulário de correio (Pré-visualização)
A maneira mais fácil de imprimir e enviar cartas e cartões postais: USPS First Class, Certified, Priority e Priority Express Mail.
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 Mailform |
| URL | https://help.mailform.io |
| support@mailform.io |
| Metadados do conector | |
|---|---|
| Editora | Mailform, Inc. |
| Sítio Web | 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 Empresarial; Comercialização |
O conector Mailform permite fluxos no ambiente Power Automate para enviar correio físico: forneça uma prova PDF e algumas especificações de impressão, como impressão a cores/preto e branco ou impressão simplex/duplex, e o Mailform imprimirá o documento de acordo com as especificações, enfiá-lo num envelope apropriado, adicionar portes e entregá-lo ao USPS (e em breve, FedEx) em seu nome. O conector fornece um método único e simples para fazer isso: você pode, por exemplo, ter um fluxo que reage a um novo cadastro de usuário enviando 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 prosseguir:
- Uma conta Mailform com uma conta de crédito válida e diferente de zero (para pagar os seus trabalhos de impressão e correio). Registe-se gratuitamente no Mailform
Como obter credenciais
Para obter credenciais:
- Inicie sessão na sua conta Mailform em Mailform
- Aceda às suas definições de Faturação visitando Mailform Billing
- Clique no botão Comprar Crédito da Conta e, em seguida, clique na opção $25.00 para adicionar o montante 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.
- Vá para as configurações de acesso à API clicando na guia API ACCESS ou visitando Mailform API Access
- Clique no botão NEW API TOKEN e, em seguida, dê ao token um rótulo (como Power Automate Testing). 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 e-mail real será enviado. As encomendas em modo de teste serão aceites e, em seguida, imediatamente canceladas, e não afetarão o seu saldo de crédito.
- O novo token da API será mostrado: copie-o, pois NÃO será exibido nunca mais. Observe que os tokens de API do modo de teste nunca podem ser trocados do modo de teste: quando você estiver pronto para entrar no ar, 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 Power Automatic:
- Crie um novo fluxo clicando no botão Criar.
- Selecione a opção Scheduled Cloud Flow.
- Nomeie o fluxo e defina a data e a frequência (neste 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 Mailform e, em seguida, selecione a ação Imprime e envia uma carta ou cartão postal usando Mailform.
- Preencha os endereços de destinatário e remetente.
- Preencha o documento e imprima as especificações: primeiro clique na opção Parâmetros Avançados e, em seguida, selecione url e, em seguida, insira o valor https://www.mailform.io/samples/sampleflyer.pdf. Em seguida, clique na opção Parâmetros avançados e, em seguida, selecione cor e, em seguida, selecione Sim.
- Clique no botão Salvar na parte superior do editor e pronto. Quando o fluxo for executado, a ordem será colocada na conta Mailform associada à chave da API.
Problemas conhecidos e limitações
- As provas de impressão devem ter menos de 40 MB: se o documento PDF que está a enviar tiver mais de 40 MB, terá de o pré-processar para reduzir o tamanho do ficheiro.
Erros e soluções comuns
N/A
FAQ
N/A
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | 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.
Esta conexão não é compartilhável. Se o aplicativo avançado 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 Mailform a ser usada para esta conexão | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Imprime e envia uma carta ou cartão postal usando o Mailform |
Cria um novo pedido de formulário de correio fornecendo a prova de impressão, bem como os detalhes do pedido (classe de serviço, cor/preto e branco, impressão frente e verso/frente e verso e muito mais) |
| Obtém o usuário autenticado |
Recuperar informações sobre o usuário do Mailform autenticado |
| Obtém uma encomenda existente |
Recuperar um pedido existente criado por meio da API |
Imprime e envia uma carta ou cartão postal usando o Mailform
Cria um novo pedido de formulário de correio fornecendo a prova de impressão, bem como os detalhes do pedido (classe de serviço, cor/preto e branco, impressão frente e verso/frente e verso e muito mais)
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Ficheiro
|
file | file |
O documento PDF a enviar por correio |
|
|
URL
|
url | string |
URL do PDF será baixado |
|
|
Referência do Cliente
|
customer_reference | string |
Uma referência de cliente opcional a ser anexada ao pedido |
|
|
Serviço de Entrega
|
service | True | string |
O serviço de entrega a ser utilizado. 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 este pedido |
|
|
Single/Dupla Face
|
simplex | boolean |
True se o documento deve ser impresso uma página para uma folha, false se o documento pode ser impresso em ambos os lados de uma folha |
|
|
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 plano
|
flat | boolean |
True se o documento DEVE ser enviado em um envelope plano, false se for aceitável enviar o documento dobrado |
|
|
Incluir envelope de devolução
|
return_envelope | boolean |
True se o documento DEVE ser enviado com um envelope de devolução. Não especifique se nenhum envelope de devolução é necessário |
|
|
Use o Selo Real
|
stamp | boolean |
Verdadeiro se o documento DEVE usar um selo postal real, falso se é aceitável enviar o documento usando portes medidos ou uma impressão |
|
|
Mensagem de Postal
|
message | string |
A mensagem a ser impressa no lado não ilustrado 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 postal |
|
Empresa/Organização Beneficiária
|
to.organization | string |
A organização ou empresa do destinatário |
|
|
Endereço do destinatário
|
to.address1 | True | string |
O número da rua e o nome do destinatário |
|
Número da Suite/Quarto/Andar/Unidade do Destinatário
|
to.address2 | string |
O número da suíte ou do quarto do destinatário |
|
|
Cidade do destinatário
|
to.city | True | string |
A cidade de 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 do Destinatário/Código Postal
|
to.postcode | True | string |
O código postal ou código postal do destinatário |
|
País beneficiá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 Remetente
|
from.organization | string |
A organização ou empresa do remetente |
|
|
Endereço do remetente
|
from.address1 | True | string |
O número da rua e o nome do remetente |
|
Número da Suíte do Remetente/Quarto/Andar/Unidade
|
from.address2 | string |
O número da suíte ou do quarto do remetente |
|
|
Cidade do remetente
|
from.city | True | string |
A cidade de endereço do remetente |
|
Estado/localidade do remetente
|
from.state | True | string |
O estado do endereço do remetente |
|
Código Postal do Remetente/Código Postal
|
from.postcode | True | string |
O código postal ou código postal do remetente |
|
País do remetente
|
from.country | string |
O país de endereço do remetente |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
código
|
error.code | string |
código de erro |
|
mensagem
|
error.message | string |
mensagem de erro |
|
details
|
details | string |
Outros detalhes |
|
sucesso
|
success | boolean |
verdadeiro sobre o sucesso |
|
id
|
data.id | string | |
|
itens de linha
|
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
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | string | |
|
e-mail
|
string | ||
|
nome
|
name | string | |
|
id
|
balance.id | string | |
|
Montante
|
balance.amount | integer | |
|
moeda
|
balance.currency | string |
Obtém uma encomenda existente
Recuperar um pedido existente criado por meio da API
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do pedido do formulário de correio
|
id | True | string |
O ID do pedido do formulário de correspondência |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
código
|
error.code | string |
código de erro |
|
mensagem
|
error.message | string |
mensagem de erro |
|
details
|
details | string |
Outros detalhes |
|
sucesso
|
success | boolean |
verdadeiro sobre o sucesso |
|
id
|
data.id | string | |
|
itens de linha
|
data.lineitems | array of object | |
|
id
|
data.lineitems.id | string | |
|
serviço
|
data.lineitems.service | string | |
|
tracking_number
|
data.lineitems.tracking_number | string |