Mailform (préversion)
Le moyen le plus simple d’imprimer et d’envoyer des lettres postales et des lettres postales : USPS First Class, Certified, Priority et Priority Express Mail.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Prise en charge de Mailform |
| URL | https://help.mailform.io |
| Messagerie électronique | support@mailform.io |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Mailform, Inc. |
| Site internet | https://www.mailform.io |
| Politique de confidentialité | https://www.mailform.io/privacy |
| Conditions d’utilisation du service | https://www.mailform.io/terms |
| Catégories | Gestion de l’entreprise ; Marketing |
Le connecteur Mailform permet aux flux dans l’environnement Power Automate d’envoyer des messages physiques : fournir une preuve PDF et certaines spécifications d’impression telles que l’impression en couleur/noir et blanc ou l’impression simplex/duplex, et Mailform imprimera le document à des spécifications, l’empaquetage dans une enveloppe appropriée, ajouter une copie et le remettre à l’USPS (et bientôt, FedEx) en votre nom. Le connecteur fournit une méthode simple et simple pour ce faire : vous pouvez par exemple avoir un flux qui réagit à une nouvelle inscription utilisateur en les envoyant des documents marketing ou en envoyant une carte postale à un client avec un coupon 30 jours après leur commande.
Prerequisites
Vous devez procéder comme suit :
- Un compte Mailform avec un compte de crédit valide et non nul (pour payer vos travaux d’impression et de messagerie). S’inscrire gratuitement à Mailform
Comment obtenir des informations d’identification
Pour obtenir les informations d’identification :
- Connectez-vous à votre compte Mailform sur Mailform
- Accédez à vos paramètres de facturation en visitant Mailform Billing
- Cliquez sur le bouton Acheter le crédit du compte , puis cliquez sur l’option $25.00 pour ajouter le montant minimal de crédit à votre compte.
- Effectuez le processus de paiement : cela crée un compte de crédit et ajoute un crédit à votre compte.
- Accédez aux paramètres d’accès à l’API en cliquant sur l’onglet ACCÈS à l’API ou en accédant à l’accès à l’API Mailform
- Cliquez sur le bouton NOUVEAU JETON d’API , puis donnez au jeton une étiquette (par exemple, Test Power Automate). Lors du test, vous pouvez activer le mode de test pour cette clé : toutes les demandes d’API sont acceptées et vérifiées, mais aucun courrier réel n’est envoyé. Les commandes en mode test seront acceptées, puis immédiatement annulées et n’affecteront pas votre solde de crédit.
- Le nouveau jeton d’API s’affiche : veuillez le copier, car il ne sera plus affiché. Notez que les jetons d’API en mode test ne peuvent jamais être supprimés du mode test : lorsque vous êtes prêt à passer en ligne, vous devrez créer un nouveau jeton d’API.
Bien démarrer avec votre connecteur
Pour illustrer l’utilisation de Mailform, nous allons créer un flux qui enverra un flyer avec un code de coupon sur mon anniversaire. Dans l’éditeur Power Automate :
- Créez un flux en cliquant sur le bouton Créer.
- Sélectionnez l’option Flux cloud planifié.
- Nommez le flux et définissez la date et la fréquence (dans ce cas, tous les 12 mois le 27 juin 2023).
- Cliquez sur le bouton Créer.
- Cliquez sur l’icône plus et cliquez sur Ajouter une action.
- Dans la boîte de dialogue, recherchez Mailform, puis sélectionnez les messages imprimés et envoyez une lettre ou une carte postale à l’aide de l’action Mailform.
- Renseignez les adresses du destinataire et de l’expéditeur.
- Renseignez le document et imprimez les spécifications : cliquez d’abord sur l’option Paramètres avancés, puis sélectionnez l’URL, puis entrez la valeur https://www.mailform.io/samples/sampleflyer.pdf. Cliquez ensuite sur l’option Paramètres avancés, puis sélectionnez couleur, puis sélectionnez Oui.
- Cliquez sur le bouton Enregistrer en haut de l’éditeur, et nous avons terminé. Lorsque le flux s’exécute, la commande est placée dans le compte Mailform associé à la clé API.
Problèmes connus et limitations
- Les preuves d’impression doivent être inférieures à 40 Mo : si le document PDF que vous envoyez est supérieur à 40 Mo, vous devez le prétraiter pour réduire la taille du fichier.
Erreurs courantes et solutions
N/A
Questions fréquentes (FAQ)
N/A
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| Clé d’API | securestring | Clé API Mailform à utiliser pour cette connexion | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Imprime et envoie une lettre ou une carte postale à l’aide de Mailform |
Crée une commande Mailform en fournissant la preuve d’impression ainsi que les détails de la commande (classe de service, couleur/noir et blanc, impression à deux côtés et plus encore) |
| Obtient l’utilisateur authentifié |
Récupérer des informations sur l’utilisateur Mailform authentifié |
| Obtient une commande existante |
Récupérer une commande existante créée via l’API |
Imprime et envoie une lettre ou une carte postale à l’aide de Mailform
Crée une commande Mailform en fournissant la preuve d’impression ainsi que les détails de la commande (classe de service, couleur/noir et blanc, impression à deux côtés et plus encore)
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Fichier
|
file | file |
Document PDF à envoyer |
|
|
URL
|
url | string |
L’URL à partir du fichier PDF sera téléchargée |
|
|
Informations de référence sur le client
|
customer_reference | string |
Référence de client facultative à joindre à la commande |
|
|
Service de livraison
|
service | True | string |
Service de livraison à utiliser. Doit être l’une des valeurs spécifiées |
|
Notification Webhook
|
webhook | string |
Webhook qui doit recevoir des notifications sur les mises à jour de commande de cet ordre |
|
|
Single/Double Sided
|
simplex | boolean |
True si le document doit être imprimé d’une page sur une feuille, false si le document peut être imprimé sur les deux côtés d’une feuille |
|
|
Couleur/Noir et Blanc
|
color | boolean |
True si le document doit être imprimé en couleur, false si le document doit être imprimé en noir et blanc |
|
|
Inclure une enveloppe plate
|
flat | boolean |
True si le document DOIT être envoyé dans une enveloppe plate, false s’il est acceptable d’envoyer le document plié |
|
|
Inclure l’enveloppe de retour
|
return_envelope | boolean |
True si le document DOIT être envoyé par courrier électronique avec une enveloppe de retour. Ne spécifiez pas si aucune enveloppe de retour n’est nécessaire |
|
|
Utiliser un tampon réel
|
stamp | boolean |
True si le document DOIT utiliser un timbre de poste réel, false s’il est acceptable d’envoyer le document à l’aide d’une poste limitée ou d’une empreinte |
|
|
Message de carte postale
|
message | string |
Message à imprimer sur le côté non-image d’une carte postale. Obligatoire si le service est défini sur USPS_POSTCARD |
|
|
Nom du destinataire
|
to.name | True | string |
Nom du destinataire de cette enveloppe ou carte postale |
|
Entreprise/organisation du destinataire
|
to.organization | string |
L’organisation ou l’entreprise du destinataire |
|
|
Adresse postale du destinataire
|
to.address1 | True | string |
Numéro de rue et nom du destinataire |
|
Suite destinataire/Chambre/Étage/Numéro d’unité
|
to.address2 | string |
La suite ou le numéro de chambre du destinataire |
|
|
Ville du destinataire
|
to.city | True | string |
Ville d’adresse du destinataire |
|
État du destinataire/localité
|
to.state | True | string |
État de l’adresse du destinataire |
|
Code postal/code postal du destinataire
|
to.postcode | True | string |
Code postal ou code postal du destinataire |
|
Pays du destinataire
|
to.country | string |
Pays d’adresse du destinataire |
|
|
Nom de l’expéditeur
|
from.name | True | string |
Nom de l’expéditeur |
|
Entreprise/organisation de l’expéditeur
|
from.organization | string |
L’organisation ou l’entreprise de l’expéditeur |
|
|
Adresse postale de l’expéditeur
|
from.address1 | True | string |
Numéro de rue et nom de l’expéditeur |
|
Sender Suite/Room/Floor/Unit Number
|
from.address2 | string |
La suite ou le numéro de chambre de l’expéditeur |
|
|
Ville de l’expéditeur
|
from.city | True | string |
Ville d’adresse de l’expéditeur |
|
État/localité de l’expéditeur
|
from.state | True | string |
État de l’adresse de l’expéditeur |
|
Code postal/code postal de l’expéditeur
|
from.postcode | True | string |
Code postal ou code postal de l’expéditeur |
|
Pays de l’expéditeur
|
from.country | string |
Pays d’adresse de l’expéditeur |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
code
|
error.code | string |
code d’erreur |
|
Message
|
error.message | string |
message d'erreur |
|
details
|
details | string |
autres détails |
|
success
|
success | boolean |
true sur le succès |
|
pièce d'identité
|
data.id | string | |
|
lineitems
|
data.lineitems | array of object | |
|
pièce d'identité
|
data.lineitems.id | string | |
|
service
|
data.lineitems.service | string |
Obtient l’utilisateur authentifié
Récupérer des informations sur l’utilisateur Mailform authentifié
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
pièce d'identité
|
id | string | |
|
Messagerie électronique
|
string | ||
|
nom
|
name | string | |
|
pièce d'identité
|
balance.id | string | |
|
quantité
|
balance.amount | integer | |
|
monnaie
|
balance.currency | string |
Obtient une commande existante
Récupérer une commande existante créée via l’API
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de commande de formulaire de messagerie
|
id | True | string |
ID de l’ordre de formulaire de messagerie |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
code
|
error.code | string |
code d’erreur |
|
Message
|
error.message | string |
message d'erreur |
|
details
|
details | string |
autres détails |
|
success
|
success | boolean |
true sur le succès |
|
pièce d'identité
|
data.id | string | |
|
lineitems
|
data.lineitems | array of object | |
|
pièce d'identité
|
data.lineitems.id | string | |
|
service
|
data.lineitems.service | string | |
|
tracking_number
|
data.lineitems.tracking_number | string |