Comment intégrer Mailrelay dans votre plugin, CRM ou APP ? Et offrez plus d'options à vos utilisateurs.

Si vous développez un CRM, une APP, un plugin ou un autre type de plugin, l'intégration de Mailrelay peut être une option très intéressante pour mettre en valeur votre produit ou service.

Les avantages sont nombreux :

Cette intégration est en effet un processus très simple, grâce à l'API Mailrelay.

Cependant, pour rendre votre travail encore plus facile, nous allons voir aujourd'hui un tutoriel qui clarifiera tous les doutes que vous pouvez avoir dans le processus d'intégration de Mailrelay à votre système.

Commençons!

De quelles fonctions de l'API Mailrelay aurons-nous besoin pendant le processus d'intégration ?

Dans cet article, nous allons voir un exemple d'intégration de base, c'est-à-dire comment synchroniser les utilisateurs de votre CRM, APP ou plugin avec Mailrelay, afin que vos clients aient leurs contacts disponibles sur leur compte et puissent leur envoyer des newsletters.

Intégrer Mailrelay de cette manière est très simple.

De plus, il existe des options avancées, telles que l'envoi de campagnes par e-mail depuis votre APP, CRM, etc. Mais cela nécessite déjà un développement supplémentaire, et bien que le processus soit le même, cela augmenterait quelque peu la portée de cet article.

Quoi qu'il en soit, si vous pensez que ce serait quelque chose d'intéressant, vous pouvez laisser un commentaire, et nous essaierons de préparer un autre article à l'avenir à ce sujet.

Maintenant, pour l'intégration que nous avons mentionnée, nous aurons besoin de ces fonctions API :

Rien d'autre, avec ces fonctions on peut intégrer le logiciel, et on verra comment faire.

► Quelle est la démarche à suivre pour intégrer les abonnés à Mailrelay ?

C'est très simple, étape par étape, ce que nous allons faire c'est :

Voyons le processus étape par étape.

1) Vérifiez que l'abonné existe déjà

La première chose est de vérifier si le contact existe déjà, car s'il n'existe pas, il peut être ajouté, car il n'est pas possible d'avoir des emails en double sur Mailrelay.

Pour vérifier cela, nous utiliserons getSubscribers.

Dans la description de l'API, vous pouvez voir un exemple de code que vous pouvez utiliser, qui ressemble à ceci :

C'est le code de base pour vérifier si un contact existe déjà, la requête se fera à l'aide de l'adresse email.

Si le contact existe, le système renverra un tableau avec toutes les informations de l'abonné telles que le nom, l'e-mail, les groupes dans lesquels il est enregistré, etc.

Et aussi, l' identifiant de l' abonné :

Déployer
(
[0] => objet stdClass
(
[id] => 2
[nom] =>

…

Et au cas où le contact n'existe pas ?

Dans ce cas, la fonction renvoie un tableau vide.

Déployer
(
)

Comme il est vide, vous saurez que cet email n'existe pas sur le système et vous pourrez l'ajouter.

Jusqu'à présent, intégrer Mailrelay avec n'importe quel logiciel semble très facile, n'est-ce pas ? Eh bien, ne vous inquiétez pas, ce ne sera pas compliqué.

2)Ajouter un nouvel abonné

Si l'abonné n'existe pas, nous pouvons l'ajouter, même si vous vous demanderez certainement ce qui se passe si nous essayons d'ajouter un abonné qui existe déjà ? Eh bien, rien de grave, le système vous avertirait simplement que cela ne peut pas être fait :

Et donc il ne l'ajouterait pas.

Dans ce cas, pour ajouter un abonné, nous utiliserons la fonction addSubscriber avec un code similaire au suivant :

Les paramètres de base et requis sont :

Important : Le contact sera déjà actif et n'aura pas besoin d'être confirmé par email, car il est en cours d'import depuis un système CRM, e-commerce, etc. Et donc le contact doit déjà avoir été validé avant d'être enregistré sur notre logiciel.

Le cas échéant, le contact peut être inactivé et peut être activé via un email de confirmation par exemple, mais par défaut, il est entendu que l'utilisation de l'API est uniquement destinée à la migration de données préalablement validées.

Que renverrait cet appel ?

Si l'appel est effectué de manière positive, il renverrait quelque chose comme :

objet(stdClass)#1 (2) {
[« statut »]=>
entier(1)
[« données »]=>
entier(9)
}

Nous devons faire attention au fait qu'il renverra l'ID de l'abonné (dans l'exemple, ce serait 9).

Eh bien, jusqu'à présent, deux processus ont été effectués, nous avons vérifié que l'abonné existe, et s'il n'existe pas, nous l'avons ajouté. L'étape suivante consiste à mettre à jour un abonné qui existe déjà.

3) Mettre à jour un abonné existant

C'est un cas habituel, après être passé par la première étape, nous pouvons mettre à jour l'abonné en utilisant la fonction updateSubscriber :

Si la fonction fonctionne, elle renvoie :

bool (vrai)

Ce code est également simple, mais il y a quelques points à prendre en compte :

Ce dernier point est essentiel pour que je le souligne.

Cette fonction nécessite que toutes les données de l'abonné soient renseignées. Par exemple, si l'abonné appartient déjà au groupe 1 et que dans le tableau groupes vous indiquez la valeur 3, l'abonné appartiendrait uniquement au groupe 3.

Si vous souhaitez que l'abonné soit enregistré pour le groupe 1 et le groupe 3, vous devez indiquer les deux valeurs dans le tableau.

Il en va de même avec les champs personnalisés (customFields), s'ils ne sont pas indiqués, les champs personnalisés seront vides. Vous devrez indiquer toutes les données que vous souhaitez ajouter pour l'abonné.

Ce n'est pas un problème.

Parce qu'à l'étape 1, avec getSubscribers, toutes les données ont déjà été obtenues.

4) se désinscrire et supprimerAbonné

Ces deux fonctions, unsubscribe, et deleteSubscriber peuvent être utilisées sans problème, il suffit d'insérer l'adresse email de l'abonné.

Quelle est la différence?

Opt-out, désabonnement, permet à l'abonné de se réabonner à l'avenir, alors que s'il est supprimé, il ne peut plus être ajouté.

C'est la différence. Il y a plus de fonctions dans l'API Mailrelay pour créer un email, obtenir des statistiques, importer une base de données, etc.

Cependant, dans ce bref tutoriel, je voulais expliquer uniquement les fonctions qui vous permettent d'intégrer Mailrelay avec différents types de logiciels, tels que des applications, des plugins, des CRM, etc.

Et dans tous les cas, l'utilisation de l'API est très simple et intuitive, avec notamment des exemples d'utilisation en PHP pour la plupart des fonctions.

Raisons d'intégrer Mailrelay dans votre CRM, APP, plugin ou tout autre logiciel.

Les raisons d'intégrer Mailrelay sont nombreuses, d'une part, Mailrelay est l'un des principaux outils d'email marketing. Cela signifie qu'un grand nombre d'utilisateurs utilisent notre logiciel et que le processus d'intégration sera encore plus rentable.

Mailrelay est aussi un logiciel utilisé par les grandes entreprises, les blogueurs et d'innombrables petites entreprises et PME, avec le plus grand compte gratuit :

Par conséquent, l'intégration peut également aider à gagner en visibilité.

De plus, l'intégration de Mailrelay est très simple grâce à l'API pour les développeurs, et c'est quelque chose que plusieurs entreprises ont déjà fait, comme :

Ils offrent déjà des fonctionnalités supplémentaires à leurs utilisateurs.