API de publipostage : envoyez des cartes et des lettres personnalisées depuis votre logiciel
Avec l'API de Yotru, votre CRM, votre boutique en ligne ou votre système de réservation envoie lui-même des cartes postales et des lettres imprimées et personnalisées. Vous créez une carte ou une lettre, vous ajoutez des destinataires et vous approuvez. Pas besoin de fichier de design : Yotru construit l'envoi à partir de votre site web, en français et avec le vouvoiement. Chaque envoi porte le nom du destinataire et son propre code QR, pour voir exactement qui répond.
Ce que vous obtenez
- Aucun travail de design
- Envoyez l'adresse de votre site et Yotru construit la carte ou la lettre avec votre logo et vos couleurs. Ou choisissez un modèle et envoyez votre propre texte.
- Personnel pour chaque destinataire
- Chaque envoi porte le nom du destinataire, son propre code QR et sa propre page d'atterrissage. Des champs personnalisés par destinataire sont possibles.
- Voir qui répond
- Chaque scan appartient à un seul destinataire. Vous le voyez dans votre tableau de bord et pouvez recevoir une alerte par courriel ou dans Slack.
- Gratuit pour développer et tester
- Créer des envois, récupérer des aperçus et ajouter des destinataires ne coûte rien. Vous payez quand vous approuvez une campagne.
- Au Canada et en Europe
- Les cartes postales partent au Canada et aux États-Unis. Les lettres partent aussi en France, en Belgique, au Luxembourg et en Suisse, rédigées en français.
- Impression et affranchissement inclus
- Un seul prix par envoi pour le design, l'impression et la livraison. Une personne de notre équipe relit chaque lot avant l'impression.
Comment ça marche
| Étape | Appel | Ce qui se passe |
|---|---|---|
| 1 | POST /v1/cards | Vous créez une carte ou une lettre, avec product, country et language. Ce que vous omettez vient du modèle ou de votre site web. |
| 2 | POST /v1/recipients | Vous ajoutez jusqu'à 1 000 destinataires par appel. Le premier appel ouvre une campagne tout seul. |
| 3 | POST /v1/campaigns/{id}/approve | Vous approuvez. La réponse contient un lien de paiement, et la campagne part à l'impression une fois payée. |
curl -X POST https://api.yotru.com/v1/cards \
-H "Authorization: Bearer $YOTRU_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Campagne automne","product":"card","country":"CA","language":"fr","website":"https://exemple.ca"}'
curl -X POST https://api.yotru.com/v1/recipients \
-H "Authorization: Bearer $YOTRU_KEY" \
-H "Content-Type: application/json" \
-d '{"cardId":"CARD_ID","recipients":[{"name":"Julie Tremblay","addressLine1":"100 rue Saint-Paul","postcode":"H2Y 1Z8","city":"Montréal","region":"QC","country":"CA"}]}'Un appel d'aperçu renvoie l'envoi exactement tel qu'il sera imprimé, pour le vérifier avant d'approuver.
Ce que vous pouvez construire
- Relance des clients inactifs. Votre boutique écrit aux clients qui n'ont rien commandé depuis six mois.
- Anniversaires et renouvellements. Votre CRM envoie une carte quand quelqu'un est client depuis un an.
- Suivis. Votre système de réservation envoie une carte après une première visite ou un rendez-vous manqué.
- Du courrier pour vos propres clients. Votre logiciel propose des envois à ses utilisateurs, et c'est vous l'expéditeur chez nous.
Ce que ça coûte
Le même prix par envoi qu'une commande passée sur le site, impression et affranchissement inclus. Au Canada, une carte postale coûte 2,69 $ à 100 exemplaires et 1,60 $ à 5 000, avant taxes. Une lettre vers la France coûte 2,79 € à 100 et 1,99 € à 5 000, HT. Il n'y a pas de minimum : sous 100 envois, chacun coûte le prix de 100. Créer et tester est gratuit.
Bon à savoir avant de commencer
- Les cartes postales partent au Canada, aux États-Unis, aux Pays-Bas, en Allemagne et au Royaume-Uni. Les lettres partent dans les 16 pays, dont la France, la Belgique, le Luxembourg et la Suisse.
- Les cartes se construisent à partir de dix modèles et les lettres de quatre, remplis avec votre texte, vos couleurs, votre logo et votre photo.
- Une carte ou une lettre part vers un pays, où habitent ses destinataires. Jusqu'à 1 000 destinataires passent en un appel, et un en-tête Idempotency-Key rend un appel répété sans risque.
Questions sur l'API
- Y a-t-il un mode test ou un bac à sable ?
- Non, et vous n'en avez pas besoin. Créer des envois, récupérer des aperçus et ajouter des destinataires ne coûte rien et n'envoie rien. Seule l'approbation d'une campagne coûte de l'argent.
- Comment obtenir une clé d'API ?
- Créez un compte et ouvrez Paramètres, puis Intégrations et Clés d'API. Votre première clé est créée à l'ouverture de cette page et ne s'affiche qu'une fois. Vous devez être propriétaire ou administrateur, avec une adresse courriel confirmée.
- L'API écrit-elle en français ?
- Oui. Une lettre vers la France ou le Luxembourg est rédigée en français par défaut. Pour le Québec et la Belgique, indiquez language: fr, et la carte ou la lettre vouvoie son lecteur.
- Puis-je écrire au Canada et en France ?
- Oui. Créez une carte ou une lettre par pays : chaque destinataire habite dans le pays de son envoi.
- Qu'arrive-t-il à une adresse erronée ?
- Ce destinataire est refusé avec une raison, comme address ou duplicate, et le reste de la liste passe.
- Y a-t-il des limites d'appels ?
- Chaque clé peut faire 120 appels par minute, et 300 appels par jour qui créent ou modifient des envois ou envoient des photos.
- Puis-je voir qui a répondu ?
- Oui. Chaque envoi a son propre code QR, donc chaque scan appartient à un destinataire. Vous le voyez dans votre tableau de bord et pouvez être averti tout de suite.
- Est-ce compatible avec mon CRM ou ma boutique ?
- Tout système capable de faire un appel HTTPS peut utiliser l'API. Avec HubSpot, vous pouvez aussi connecter vos listes sans code dans le tableau de bord.
Pourquoi nous l'avons construite ainsi : API d'envoi de courrier : cartes postales et lettres depuis votre logiciel.