Découvrez le support API de Mailjet

Vous voyez dans quel état peut vous mettre la perspective de faire appel au support client ? Bien. Maintenant, mettez-vous dans la peau d’un développeur. En général, les problèmes que nous rencontrons sont complexes et nécessitent une assistance spécifique. C’est l’une des raisons pour lesquelles nous améliorons constamment nos guides API, notre communauté de développeurs et nos bibliothèques : chez Mailjet, nous facilitons la tâche aux développeurs qui ont besoin d’aide. Grâce à vos précieux retours, nous sommes certains d’être sur la bonne voie.

Et si nous faisions encore mieux ? Eh oui, c’est possible ! Nous avons aujourd’hui le grand plaisir d’annoncer que, cet été, notre équipe de support a recruté et formé deux agents dédiés aux questions API.

La raison est simple : notre offre de produits s’enrichit. Nous estimons donc nécessaire d’assurer un support plus pointu, particulièrement en matière d’API, où l’expertise fait toute la différence. Un support API implique de savoir lire, exécuter et corriger des échantillons de code dans de nombreux langages de programmation (y compris ceux qui nous sont le moins familiers) afin de cerner les améliorations ou rectifications nécessaires pour que vos emails atteignent vos cibles. Cela requiert de la patience, une solide compréhension de l’environnement du développement logiciel et une connaissance approfondie du fonctionnement de notre API.

Quoi de neuf ?

Désormais, vous pouvez associer une balise « Question API » aux tickets que vous ouvrez auprès de notre équipe de support. Cela simplifie le tri des requêtes, permettant à nos agents dédiés de se charger personnellement de ce type de ticket. Naturellement, les autres membres de notre équipe de support restent à l’écoute de vos autres questions API plus générales.

La mise à disposition d’un service de support dédié à notre communauté de développeurs est loin d’être une nouveauté pour nous. Depuis l’an dernier, l’adresse api@mailjet.com est le point de contact de notre équipe en charge des relations avec les développeurs. Elle fait office de lien direct entre vous et nos experts, qui aident et conseillent les utilisateurs de notre API.

Passionnés comme nous le sommes, nous pensons qu’il est encore possible de perfectionner le traitement et le suivi des questions qui nous sont posées. C’est aussi vrai pour le support API. C’est pourquoi, à partir du 1er octobre, l’adresse api@mailjet.com ne sera plus dévolue au support : elle redeviendra l’adresse à laquelle vous pourrez nous envoyer vos retours et vos déclarations d’amour (et aussi vous procurer des articles promotionnels – nous savons que vous en êtes friands…)

picture1

GitHub continue à accueillir les débats autour des améliorations et rectifications de nos wrappers officiels. GitHub nous offre deux avantages clés : d’une part, de précieux échanges avec notre communauté et, d’autre part, la collecte des retours de contributeurs qui prennent le temps de nous signaler des problèmes ou de faire des demandes d’extraction pour améliorer nos bibliothèques. Ce pour quoi nous vous remercions chaudement ! Vous nous aidez concrètement à améliorer notre outil.

Zhivko et Mike

En plus de tous les points mentionnés plus haut (par exemple : l’expertise et les circuits courts internes pour les questions API), nous sommes convaincus qu’une approche personnelle en matière de support permet de construire une relation durable avec nos utilisateurs.

Laissez-nous donc vous présenter les deux champions chargés de traiter toutes vos questions API et d’optimiser votre expérience avec Mailjet. Pour l’instant, le support API est uniquement disponible en anglais. Puisque nous, les développeurs, avons l’habitude d’employer des termes techniques anglais, cela nous semble être un bon point de départ.

Fini le suspens, enfin des noms ! Zhivko Zhelev répondra à vos questions API et résoudra tous les problèmes que vous pourrez rencontrer. Il est basé à Sofia, en Bulgarie, et travaille main dans la main avec Emmanuel Boisgontier (l’auteur génial de notre documentation API et de réponses à de nombreuses questions API). Zhivko est chargé du support API pour l’Europe.

Michael Pauer (« Mike » pour les intimes), nous a rejoints en 2013. Depuis, lorsque les membres de l’équipe Europe rentrent chez eux pour un repos bien mérité après vous avoir accompagné, il prend le relais depuis le Canada pour vous apporter des réponses. Au fil du temps, il a porté de nombreuses casquettes et appris à connaître les tenants et les aboutissants de notre système, notamment notre API. Mike supervise le support API pour le fuseau horaire nord-américain.

Nous espérons que cette nouvelle organisation vous conviendra et améliorera encore votre expérience de notre plateforme.

N’hésitez pas à nous envoyer vos questions et retours sur Twitter ou à l’adresse api@mailjet.com.

Un nouveau look pour Dev.Mailjet

À l’heure actuelle, l’email est un aspect clé de n’importe quelle application, et pourtant, gérer sa propre infrastructure email est fastidieux pour la plupart des développeurs. C’est la raison pour laquelle nous dédions notre travail à construire des solutions d’emailing plus faciles à intégrer et utiliser.

Depuis 2015, notre API s’est beaucoup améliorée. Elle a mûri grâce à vos retours d’utilisation. Nous y avons apporté des changements, et nous avons même décidé de donner un coup de neuf à notre bon vieux site dev.mailjet.com, avec plein de nouvelles fonctionnalités pour l’occasion. Voilà tout ce qu’il faut savoir sur ces changements :

 

Un site complètement refondu pour les développeurs

2016 a été une année très chargée du côté de l’activité développeurs chez Mailjet. Les visites sur notre site dédié, dev.mailjet.com, ont largement augmenté et nous avons décidé qu’il était temps de le rafraîchir un peu.

Vous pouvez voir cette nouvelle version comme une maison largement améliorée pour les développeurs. Nous avons passé un bon coup de peinture sur les murs, avec un design aligné sur notre identité visuelle actuelle. Elle est aussi beaucoup plus facile à utiliser : vous pouvez désormais comprendre ce que fait l’API Mailjet en un clin d’oeil, sans avoir à naviguer dans toute la documentation.

send email API

En parallèle de cette refonte, nous lançons également une nouvelle newsletter dédiée à notre communauté de développeurs, afin de les tenir au courant des dernières nouvelles liées à l’API. Pour vous y inscrire (on vous le recommande chaudement), c’est par ici.

 

Notre API est encore plus cool qu’avant

L’API est le produit phare de Mailjet pour les développeurs. Et ce n’est pas pour nous vanter, mais avec les derniers ajouts que nous lui avons apportés, nous pensons que c’est plutôt un chouette produit :

Cerise sur le gâteau : nous avons aussi ouvert un compte Twitter dédié à notre communauté d’utilisateurs. C’est génial de rencontrer du monde durant les hackathons et les événements, mais nous trouvions qu’il nous manquait un moyen d’interagir avec vous tous les jours. Dites bonjour à @mailjetdev ?

 

Et après ?

Excellente question. Tout ça est déjà pas mal, mais la meilleure partie, c’est que ce n’est que le début d’une longue série d’améliorations prévues pour les utilisateurs de l’API Mailjet. Voilà un aperçu exclusif de ce que nous vous préparons pour les prochains mois :

  • Vous avez peut-être entendu parler de notre nouvelle fonctionnalité marketing : l’Automatisation. Vous pouvez désormais accueillir vos nouveaux utilisateurs automatiquement, et d’autres workflows automatisés seront bientôt lancés pour couvrir de nouveaux cas d’usage. Pour l’instant, elle n’est disponible que via l’interface mais nous avons prévu de la rendre accessible depuis l’API d’ici la fin de l’année.
  • En dehors des emails automatisés, il y a aussi notre projet open-source, qui est un peu notre bébé. MJML est un langage de balises qui facilite (enfin) le développement d’emails responsive pour les développeurs. Depuis son lancement en février 2016, MJML a reçu de nombreux retours très positifs de la communauté et son amélioration continue. Réintégrer complètement MJML à la Send API de Mailjet et dans Passport est l’une de nos priorités.
  • En parlant d’amélioration justement, nous concentrons également nos efforts sur l’API afin de la rendre encore plus performante. Les prochaines étapes consistent à améliorer l’index pour rendre la navigation encore plus simple pour les experts de l’API Mailjet.
  • En parallèle de ces projets et produits, nous souhaitons créer un espace dédié à notre communauté d’utilisateurs. Cet espace sera inclus dans le nouveau site et permettra aux utilisateurs de partager du contenu tech, d’échanger des astuces et de s’entraider.
  • Enfin, nous continuons bien sûr nos efforts pour publier plus de ressources documentaires permettant de faciliter la compréhension et l’utilisation de notre API. Cela passe par la création de nouvelles démos et d’un kit de démarrage pour simplifier la prise en main.

 

Comme toujours, nous sommes ravis de recevoir vos contributions sur Github et vos interactions avec nous sur Twitter. Vos retours nous permettent d’améliorer continuellement notre produit pour mieux correspondre à vos besoins. Merci d’être toujours aussi géniaux.

Email transactionnel : aller plus loin grâce au templating

L’email est un canal extrêmement efficace pour interagir avec de nouveaux clients. Aujourd’hui, les utilisateurs se servent de leur adresse personnelle pour travailler, communiquer avec leur réseau et s’informer sur leurs marques préférées. De plus, les emails transactionnels ont des taux d’ouverture et de clics quatre à huit fois supérieurs à ceux des emails marketing. Ce sont des messages envoyés automatiquement à un utilisateur selon une action prédéfinie afin de finaliser ou récapituler une opération. Les emails de réinitialisation de mot de passe, de confirmation et de réception des expéditions sont quelques exemples d’emails transactionnels. Ces messages représentent donc un vecteur d’engagement de taille, car les informations qu’ils contiennent sont importantes.

Les clients s’attendent non seulement à recevoir ces communications au bon moment, mais souhaitent également bénéficier de contenus personnalisés, pertinents et utiles. Imaginez par exemple un relevé bancaire commençant par « Cher client », et un autre commençant par « Cher {{first_name}} ». Vous préférerez certainement cette dernière formule.

Si les emails personnalisés constituent déjà un véritable progrès par rapport aux emails génériques, il est possible de les améliorer et d’aller plus loin.

Pour répondre à ce besoin tout en facilitant la tâche à nos utilisateurs, nous sommes aujourd’hui fiers d’annoncer que notre Send API pour les emails transactionnels inclut désormais des fonctionnalités de templating. Nous avons choisi d’utiliser une syntaxe inspirée des langages des moteurs de templating les plus répandus comme Jinja2 ou Twig que vous connaissez déjà. Ainsi, vous n’aurez plus à vous préoccuper du traitement des messages et vous pourrez vous concentrer pleinement sur la création de templates que vos clients apprécieront.

Même s’ils représentent une valeur ajoutée considérable, ces emails se situent malheureusement à la périphérie de votre cœur de métier. Délicat et chronophage, le processus de création est donc parfois source de frustration (en particulier pour les développeurs).

Entrons dans le vif du sujet avec un exemple simple, et profitons de la sortie imminente du nouvel épisode de la saga Star Wars pour appliquer notre raisonnement.

Nous souhaitons envoyer deux emails basés sur des modèles différents, l’un pour le Bon Côté de la Force et l’autre pour le Côté Obscur. Dans notre base de données, chaque contact est associé à un côté de la Force. Ces informations nous permettent de définir les paramètres HTML ainsi que certaines conditions du langage des modèles Mailjet pour chaque client. Par exemple :
Des conditions peuvent également être ajoutées pour l’objet de l’email :

Cet exemple assez succinct est loin d’être exhaustif, mais souligne bien l’intérêt des conditions de templating dans les modèles d’emails. Sans cette fonctionnalité, il vous faudrait créer deux modèles distincts, l’un pour les Jedi, l’autre pour les Sith. Plus productif, ce procédé est moins laborieux et vous évite des tâches répétitives en cas de volumes importants à traiter.

D’autres fonctionnalités utiles sont également disponibles : ajout/suppression de sections entières selon le profil de votre contact, insertion facilitée de listes de produits (boucle itérative), etc. N’hésitez donc pas à les utiliser !

Entièrement intégré à notre Send API, le langage pour templating pour les emails transactionnels de Mailjet est non seulement compatible avec les modèles, mais également avec tout code HTML ou texte contenant des éléments de templating.

Une fois votre email finalisé, vous pouvez l’envoyer facilement grâce à cet appel API en utilisant Curl :

Pour le contact passenger@mailjet.com, on obtient alors un email dont l’objet est « Hello email Jedi !» avec un corps HTML/texte « Dear Jedi, welcome to Mailjet! May the delivery force be with you » (car il est évident que Passenger de Mailjet est un Jedi). À l’inverse, pour darkvador@mailjet.com, l’email aura pour objet « Are you a doing dark things with email?» et « The dark side I sense in you. » en corps HTML/texte.

Vous pouvez toujours envoyer vos emails transactionnels via SMTP grâce aux nouveaux en-têtes personnalisés à votre disposition : « X-MJ-TemplateID » et « X-MJ-Vars ».

Après des semaines de dur labeur, l’équipe Mailjet est heureuse de vous proposer cette nouvelle fonctionnalité de templating. Nous espérons que vous partagez notre enthousiasme avec l’arrivée de ce premier outil pour les emails transactionnels. La fonctionnalité est disponible dès aujourd’hui en bêta test privé. Vous pouvez vous inscrire en écrivant à api@mailjet.com. Pas de panique si vous ne pouvez pas vous inscrire ! La sortie officielle est prévue pour la fin de l’année.

Restez connectés, d’autres grandes annonces suivront prochainement !

Dans la peau d’un développeur évangéliste

API (Application Programming Interface, ou Interface de Programmation). Expérience Développeur (DX). Vous avez peut-être déjà entendu ces termes, sans vraiment en comprendre le sens. Sachez qu’ils sont très utilisés dans le monde des SaaS. Les développeurs se servent des APIs pour améliorer des produits existants et faire émerger de nouvelles idées et de nouvelles pratiques. Les APIs permettent aux entreprises l’intégration rapide et facile d’applications à leurs systèmes: c’est un gain de temps, d’argent et de ressources considérable pour elles, puisqu’elles peuvent faire confiance à l’expertise des APIs sans avoir à développer de solution de leur côté.

Pour aider les développeurs des différentes entreprises à mieux communiquer entre eux, de nouveaux métiers ont émergé. Parmi eux, le développeur évangéliste (ou DevEv). A la fois développeur et marketeur, le DevEv agit comme un médiateur entre l’entreprise pour laquelle il travaille et les utilisateurs techniques du produit qu’il représente. Il voyage dans le monde pour rencontrer les développeurs et se tenir au courant des différentes tendances technologiques. En outre, son rôle est également de faire en sorte que le produit qu’il défend soit facile d’utilisation pour les développeurs.

Bien sûr, cette fonction évolue constamment et connaît des variations d’une entreprise à l’autre. Cependant, pour vous donner une meilleure idée du travail accompli par un DevEv, nous avons résumé l’activité 2014 de notre équipe dans cette infographie.


 

Chez Mailjet, le développement et le code sont des pierres angulaires – Julien Tartarin, co-fondateur de Mailjet, est lui-même un développeur. Dès la création de la plateforme, nous avons adossé Mailjet à sa propre API, et l’avons rendu publique et libre pour que n’importe quel développeur puisse l’utiliser.