Templates HTML réutilisables

API

Mis à jour le 30 September 2019 à 17h25

Créez, visualisez et modifiez vos modèles de courrier ou de carte postale pour optimiser vos envois.

Vous cherchez des idées de design ? En voici quelques-uns ici ! Vous avez créé un design sympa et vous souhaitez le partager avec la communauté ? Contactez-nous par mail (hello@MySendingBox.fr) ou via le chat en bas à droite !

Vous pouvez créer un modèle depuis votre Dashboard . Lorsque vous créez un template vous devez indiquer un nom qui vous permettra d'identifier le template et le HTML.

Nous vous conseillons de lire le guide sur le design HTML pour envoyer un HTML correct pour l'impression et l'envoi.

Les templates HTML sont compatibles avec la fusion des variables. Cela vous permet d'avoir un modèle de lettre bien défini et d'y ajouter simplement des variables pour le personnaliser en fonction du destinataire.

Vous pourrez éditer votre template après sa création, donc ne vous inquiétez pas s'il n'est pas parfait dès le début !

Retrouvez le template que vous venez de créer dans la liste sur la page Templates HTML de votre Dashboard.
Utilisez "API id" pour appeler votre template lors de la création d'un courrier.
Le bouton "Prévisualiser" vous permet d'avoir une idée du rendu final de votre courrier.

Attention : suivant le navigateur que vous utilisez, le résultat peut être différent. Il est conseillé de tester le rendu en PDF en créant un nouveau courrier ou une nouvelle carte postale avec la clé API de test.

Lors de la création d'une campagne vous pourrez séléctionner les templates que vous avez créé.

Aussi, lors de vos appels à l'API, au lieu de passer du HTML, vous pouvez maintenant passer l'identifiant d'un template, afin de générer votre courrier à partir de celui-ci.
Passez l'identifiant de votre template (que vous pouvez retrouver sur la page de votre template) en paramètre à source_file et passez template_id en paramètre à source_file_type.

Votre courrier sera généré à partir de ce template et la fusion des variables sera appliquée.

Avec cet exemple nous allons générer un courrier avec le template public Lettre Format Classique
Cliquez ici pour le dupliquer et le modifier .

curl -X POST https://api.MySendingBox.fr/letters \
  -u '<VOTRE_CLE_API>:' \
  -d '{
   "description": "Lettre de démo",
   "mode":"test",
   "to": {
      "name": "Erlich Bachman",
      "address_line1": "30 rue de Rivoli",
      "address_city": "Paris",
      "address_postalcode": "75004",
      "address_country": "FRANCE"
   },
   "color" : "color",
   "postage_type" : "lrar",
   "from": {
      "company": "Pied Piper",
      "address_line1": "28 rue de Rivoli",
      "address_city": "Paris",
      "address_postalcode": "75004",
      "address_country": "FRANCE"
   },
   "source_file": "HJ3iX0hrb",
   "source_file_type":"template_id",
   "variables": {
           "prenom" : "Erlich",
           "nom" : "Bachman",
           "contenu.objet" : "Négociation du pourcentage",
           "contenu.nom" : "Bachman",
           "expediteur.nom" : "Pied Piper",
           "expediteur.capital_social" : "1 000 000 000 €",
           "expediteur.numero" : "28",
           "expediteur.rue" : "rue de Rivoli",
           "expediteur.code_postal" : "75004",
           "expediteur.ville" : "Paris",
           "expediteur.rcs" : "123456789",
           "expediteur.tva" : "97654321"
    }
}'

Ceci générera ce PDF

Si vous avez des questions n'hésitez pas à nous contacter grâce à la messagerie en bas à droite.

Créer un template HTML

Visualiser un template

Utiliser un template

Exemple de code