Wie integriere ich Mailrelay in dein Plugin, CRM oder APP? Und bieten Sie Ihren Benutzern mehr Optionen.
Veröffentlicht: 2017-11-23Wenn Sie ein CRM, eine APP, ein Plugin oder eine andere Art von Plugin entwickeln, kann die Integration von Mailrelay eine sehr interessante Option sein, um Ihr Produkt oder Ihre Dienstleistung hervorzuheben.
Die Vorteile sind vielfältig:
- Sie bieten Ihren Benutzern mehr Optionen, was immer positiv sein wird
- Mailrelay ist ein führendes E-Mail-Marketing-Tool mit Hunderttausenden von Benutzern; Sie können diese Sichtbarkeit nutzen
- Einige dieser Benutzer werden Ihr System verwenden
Diese Integration ist dank der Mailrelay-API tatsächlich ein sehr einfacher Prozess.
Um Ihnen die Arbeit jedoch noch einfacher zu machen, sehen wir heute ein Tutorial, das alle Zweifel klärt, die Sie möglicherweise bei der Integration von Mailrelay in Ihr System haben.
Lass uns anfangen!
- 1 Welche Mailrelay API-Funktionen benötigen wir während des Integrationsprozesses?
- 1.1 ► Welchen Prozess müssen Sie befolgen, um Abonnenten in Mailrelay zu integrieren?
- 2 1) Überprüfen Sie, ob der Abonnent bereits existiert
- 2.1 Und falls der Kontakt nicht existiert?
- 3 2)Neuen Abonnenten hinzufügen
- 3.1 Was würde diesen Anruf erwidern?
- 4 3) Aktualisieren Sie einen bestehenden Abonnenten
- 5 4) abmelden und löschenAbonnent
- 5.1 Gründe, Mailrelay in Ihr CRM, Ihre APP, Ihr Plugin oder jede andere Software zu integrieren.
- 5.2 Verwandte Beiträge:

Welche Mailrelay API-Funktionen benötigen wir während des Integrationsprozesses?
In diesem Artikel sehen wir uns ein Beispiel für eine grundlegende Integration an, d. h. wie Sie die Benutzer Ihres CRM, Ihrer APP oder Ihres Plugins mit Mailrelay synchronisieren, damit Ihre Kunden ihre Kontakte auf ihrem Konto zur Verfügung haben und ihnen Newsletter senden können.
Die Einbindung von Mailrelay auf diese Weise ist sehr einfach.
Außerdem gibt es erweiterte Optionen, wie das Versenden von E-Mail-Kampagnen aus Ihrer APP, Ihrem CRM usw. Dies erfordert jedoch bereits eine Weiterentwicklung und obwohl der Prozess derselbe ist, würde dies den Umfang dieses Artikels etwas erhöhen.
Wie auch immer, wenn Sie denken, dass es etwas Interessantes wäre, können Sie einen Kommentar hinterlassen, und wir werden versuchen, in Zukunft einen weiteren Beitrag darüber vorzubereiten.
Für die erwähnte Integration benötigen wir nun diese API-Funktionen:
- getAbonnenten
- addAbonnent
- updateAbonnent
- Abmelden
- löschenAbonnent
Nichts anderes, mit diesen Funktionen können wir die Software integrieren, und wir werden sehen, wie es geht.
► Welchen Prozess müssen Sie befolgen, um Abonnenten in Mailrelay zu integrieren?
Es ist ganz einfach, Schritt für Schritt, was wir tun werden:
- Stellen Sie sicher, dass der Kontakt, den Sie hinzufügen möchten, bereits in Mailrelay vorhanden ist
- Wenn es nicht existiert, wird es der E-Mail-Marketing-Software hinzugefügt
- Und falls vorhanden, wird sie bei Bedarf aktualisiert
- Optional können Sie es bei Bedarf löschen oder abbestellen
Sehen wir uns den Prozess Schritt für Schritt an.
1) Überprüfen Sie, ob der Abonnent bereits existiert
Als erstes muss überprüft werden, ob der Kontakt bereits existiert, denn wenn er nicht existiert, kann er hinzugefügt werden, da es nicht möglich ist, doppelte E-Mails auf Mailrelay zu haben.
Um dies zu überprüfen, verwenden wir getSubscribers.
In der API-Beschreibung sehen Sie ein Beispiel für den Code, den Sie verwenden können, etwa so:

Es ist der grundlegende Code, um zu überprüfen, ob ein Kontakt bereits existiert, die Abfrage erfolgt über die E-Mail-Adresse.
Wenn der Kontakt existiert, gibt das System ein Array mit allen Abonnenteninformationen wie Name, E-Mail, Gruppen, in denen er registriert ist, usw. zurück.
Und auch die Abonnenten-ID:
Array
(
[0] => stdClass-Objekt
(
[id] => 2
[Name] =>
…
Und falls der Kontakt nicht existiert?
In diesem Fall gibt die Funktion ein leeres Array zurück.
Array
(
)
Da sie leer ist, wissen Sie, dass diese E-Mail nicht auf dem System vorhanden ist und Sie können sie hinzufügen.

Bisher scheint die Integration von Mailrelay in jede Software sehr einfach, nicht wahr? Nun, keine Sorge, es wird nicht kompliziert.
2)Neuen Abonnenten hinzufügen
Wenn der Abonnent nicht existiert, können wir ihn hinzufügen, obwohl Sie sich sicherlich fragen werden, was passiert, wenn wir versuchen, einen bereits bestehenden Abonnenten hinzuzufügen? Nun, nichts Ernstes, das System würde Sie einfach warnen, dass es nicht möglich ist:
- stdClass Object ( [status] => 0 [error] => email: El email ya existe )
Und deshalb würde es es nicht hinzufügen.
In diesem Fall verwenden wir zum Hinzufügen eines Abonnenten die Funktion addSubscriber mit einem Code ähnlich dem folgenden:

Die grundlegenden und erforderlichen Parameter sind:
- Name
- Und die Gruppe
Wichtig: Der Kontakt ist bereits aktiv und muss nicht per E-Mail bestätigt werden, da er aus einem CRM-System, E-Commerce usw. importiert wird. Daher sollte der Kontakt bereits vor der Registrierung in unserer Software validiert sein.
Bei Bedarf kann der Kontakt deaktiviert und beispielsweise über eine Bestätigungs-E-Mail aktiviert werden, aber standardmäßig versteht sich die Verwendung der API nur für die Migration zuvor validierter Daten.
Was würde diesen Anruf erwidern?
Wenn der Anruf positiv erfolgt, würde er Folgendes zurückgeben:
Objekt(stdKlasse)#1 (2) {
["Status"]=>
int(1)
["Daten"]=>
int(9)
}
Wir sollten darauf achten, dass die Abonnenten-ID zurückgegeben wird (im Beispiel wäre es 9).
Nun, bisher wurden zwei Prozesse durchgeführt, wir haben überprüft, ob der Abonnent existiert, und wenn er nicht existiert, haben wir ihn hinzugefügt. Der nächste Schritt besteht darin, einen bereits vorhandenen Abonnenten zu aktualisieren.
3) Aktualisieren Sie einen bestehenden Abonnenten
Dies ist ein üblicher Fall, nachdem wir den ersten Schritt durchlaufen haben, können wir den Abonnenten mit der Funktion updateSubscriber aktualisieren:

Wenn die Funktion funktioniert, gibt sie Folgendes zurück:
bool (wahr)
Dieser Code ist ebenfalls einfach, aber es sind einige Punkte zu beachten:
- Sie benötigen die Teilnehmer-ID; diese erhalten Sie in Schritt 1 mit getSubscribers
- Sie müssen alle Gruppen informieren, für die der Abonnent registriert wird
Dieser letzte Punkt ist wesentlich, damit ich ihn hervorheben möchte.
Diese Funktion setzt voraus, dass alle Daten des Teilnehmers mitgeteilt werden. Wenn der Abonnent beispielsweise bereits zu Gruppe 1 gehört und Sie in den Array-Gruppen den Wert 3 angeben, würde der Abonnent nur zu Gruppe 3 gehören.
Wenn der Teilnehmer für Gruppe 1 und Gruppe 3 registriert werden soll, müssen Sie beide Werte im Array angeben.
Das gleiche passiert mit benutzerdefinierten Feldern (customFields), wenn sie nicht angegeben sind, sind die benutzerdefinierten Felder leer. Sie müssen alle Daten angeben, die Sie für den Abonnenten hinzufügen möchten.
Es ist kein Problem.
Denn in Schritt 1 wurden mit getSubscribers bereits alle Daten bezogen.
4) abmelden und löschenAbonnent
Diese beiden Funktionen, abmelden und deleteSubscriber können problemlos verwendet werden, geben Sie einfach die E-Mail-Adresse des Abonnenten ein.
Was ist der Unterschied?
Opt-out, Abbestellen, ermöglicht es dem Abonnenten, sich in Zukunft erneut anzumelden, während er nach dem Löschen nicht wieder hinzugefügt werden kann.
Das ist der Unterschied. Es gibt weitere Funktionen in der Mailrelay-API, um eine E-Mail zu erstellen, Statistiken zu erhalten, eine Datenbank zu importieren usw.
In diesem kurzen Tutorial wollte ich jedoch nur die Funktionen erklären, mit denen Sie Mailrelay in verschiedene Arten von Software wie APPs, Plugins, CRMs usw. integrieren können.
Und auf jeden Fall ist die Nutzung der API sehr einfach und intuitiv, inklusive Anwendungsbeispielen in PHP für die meisten Funktionen.
Gründe, Mailrelay in Ihr CRM, Ihre APP, Ihr Plugin oder jede andere Software zu integrieren.
Die Gründe für die Integration von Mailrelay sind vielfältig, zum einen ist Mailrelay eines der wichtigsten E-Mail-Marketing-Tools. Dadurch nutzen viele Anwender unsere Software und der Integrationsprozess wird noch profitabler.
Mailrelay ist auch eine Software, die von großen Unternehmen, Bloggern und unzähligen kleinen Unternehmen und KMU verwendet wird, wobei der größte Account kostenlos ist:
Daher kann die Integration auch dazu beitragen, Sichtbarkeit zu gewinnen.
Auch die Integration von Mailrelay ist dank der API für Entwickler sehr einfach und wurde bereits von mehreren Unternehmen durchgeführt, wie zum Beispiel:
- Gedeihende Leads
- Eingeweiht
- MeinThemeShop
- Optingun
- Usw.
Sie bieten ihren Benutzern bereits zusätzliche Funktionen.

