API und Webhooks

Ihr CRM übergibt Ihre geschützten Kunden, Ihr System übernimmt die Firmen mit positiver Rückmeldung und die Adressen der Postkampagnen selbst, ruft den Kampagnenbericht ab und erfährt von jedem wichtigen Ereignis sofort.

1 / 8

So fragen Sie in Ihrem eigenen Konto nach dem Aufrufprotokoll, und so antwortet Apex. Die Adressen sind erfunden.

So verbinden Sie es

Sie erstellen im Kontomenü einen Schlüssel, Ihr Entwickler bindet ihn anhand der Dokumentation an, und von da an halten Ihre Systeme selbst Kontakt.

1
Start mit einem Testschlüssel
Der Superuser des Kontos oder ein Administrator erstellt im Kontomenü unter API und Webhooks den Testschlüssel. Mit einem Testschlüssel verhält sich jeder Aufruf wie live, aber im Konto ändert sich nichts, und beim Lesen kommen Beispieldaten zurück.
An Ihrem Schreibtisch: den Schlüssel erstellen.
2
Ihr Entwickler arbeitet mit der Dokumentation
Auf trendizz.com/developers ist jeder Aufruf beschrieben, mit Beispielen in curl, JavaScript, Python und PHP, dazu fünf ausführliche Anleitungen. Mit dem Testschlüssel kann Ihr Entwickler die Aufrufe auch im Browser ausprobieren, bevor er sie anbindet.
An Ihrem Schreibtisch: den Schlüssel an den Entwickler weitergeben.
3
Live arbeiten Ihre Systeme
Mit dem Live-Schlüssel übergibt das CRM die geschützten Kunden und übernimmt die Firmen mit positiver Rückmeldung, und die Druckerei lädt die Postanschriften herunter. Jeder Aufruf landet im Aufrufprotokoll, jeder Webhook im Zustellprotokoll. Der Live-Schlüssel funktioniert in einem kostenpflichtigen Paket.
An Ihrem Schreibtisch: eine Frage an Apex, wenn Sie wissen möchten, was passiert ist.

Was durchgeht, in beide Richtungen

Ihr System kann geschützte Kunden übergeben, Firmen und E-Mail-Adressen ausschließen, die positiven Rückmelder und die Postanschriften übernehmen und den Kampagnenbericht abrufen.

Aus Ihrem System

Geschützte KundenDomain oder E-Mail-Adresse, bei Bedarf mit der ID aus Ihrem System; keine Kampagne schreibt ihnen

AusschlüsseDomain oder E-Mail-Adresse, mit Grund

Stapelbis zu 10.000 geschützte Kunden oder Ausschlüsse in einem Aufruf

Als versendet markiertdie Druckerei meldet je Firma, was sie zur Post gegeben hat

Trendizz APIapi.trendizz.com/v1 · jeder Aufruf und jeder Webhook protokolliert

In Ihr System

Positive Rückmeldermit den Ansprechpartnern, wie im Export; auf Wunsch nur das, was sich seit dem letzten Abruf geändert hat

Adressen der PostkampagneFirmenname und Postanschrift, als Export, nur die neuen oder alle

Ereignisse per Webhooksigniert, sofort; zum Beispiel eine positive Antwort, eine Abmeldung oder die Markierung „Gewonnen“

Die API übergibt das Ergebnis Ihrer Arbeit: die Firmen mit positiver Rückmeldung und die Adressen Ihrer Postkampagnen. Jede solche Übergabe erscheint auch unter Meine Exporte.

Was Ihnen das bringt

Geschützte Kunden bleiben unbehelligt

Wer sich bei Ihnen registriert oder ein Abo abschließt, wird von Ihrem System noch in derselben Minute als geschützter Kunde übergeben, und keine Kampagne schreibt ihm. Kündigt er, löscht Ihr System ihn, und die Firma kann wieder angeschrieben werden.

Das Ergebnis landet dort, wo Sie arbeiten

Eine Firma mit positiver Rückmeldung kommt samt Ansprechpartnern per Webhook im CRM an, sobald Trendizz die Antwort als positiv erkennt. War das CRM zwischenzeitlich nicht erreichbar, holt der nächste Abruf nach, was ausgeblieben ist.

Jeder Schritt lässt sich nachvollziehen

Jeder Aufruf und jede Webhook-Zustellung wird protokolliert: wann, mit welchem Schlüssel, was angefragt und was geantwortet wurde. Der Superuser und die Administratoren des Kontos sehen das Protokoll 90 Tage lang im Detail, und auch Apex kann sagen, was passiert ist.

Zugang, Limit, Pakete

Die API funktioniert mit einem Live-Schlüssel in den kostenpflichtigen Paketen, mit einem Testschlüssel in jedem Paket, auch in Apex Free. Im Free-Paket oder bei ausbleibender Zahlung ruhen Live-Aufrufe und Webhooks, die Schlüssel und Endpunkte bleiben erhalten, und mit einem Abo läuft alles von selbst wieder an.
Ein einheitliches Limit in jedem Paket: 1.000 Aufrufe pro Stunde und Firma, für den Testschlüssel und den Live-Schlüssel getrennt. Ein Stapel zählt als ein Aufruf.
Je Firma gibt es einen Test- und einen Live-Schlüssel, daneben beliebig viele Berichtsschlüssel, die nur das Konto und die Kampagnenberichte lesen und sich deshalb zum Beispiel dem System einer Agentur geben lassen. Schlüssel erstellt der Superuser des Kontos oder ein Administrator, und der Schlüssel arbeitet mit den Rechten seines Erstellers. Nach einem neuen Live-Schlüssel funktioniert der alte noch 7 Tage. Verlässt der Ersteller das Team oder verliert er die Rolle Administrator, bleibt der Schlüssel erhalten, weist aber jeden Aufruf ab, bis der Superuser oder ein Administrator ihn übernimmt.
Mit einem Testschlüssel verhält sich jeder Aufruf wie live, aber im Konto ändert sich nichts, und beim Lesen kommen Beispieldaten zurück, in jedem Paket.
Keine Kampagne schreibt einem geschützten Kunden, auch nicht eine, die sich an Bestandskunden richtet. Wen Sie anschreiben möchten, etwa in einer Wiederkaufskampagne, laden Sie in eine Kampagne; als geschützt markieren Sie die, die Sie in Ruhe lassen wollen.
Neue Firmen finden, analysieren und ansprechen Sie in Apex, innerhalb von Trendizz; die API übergibt das Ergebnis an Ihr System. Markieren Sie eine Firma als gewonnen, erfährt Ihr System davon per Webhook.

API-Dokumentation zum Ausprobieren

Jeder Aufruf mit Beispielen in curl, JavaScript, Python und PHP, fünf ausführliche Anleitungen, die Fehlercodes und die Ereignistypen. Mit dem Testschlüssel lässt sich alles auch im Browser ausprobieren.

Dokumentation öffnen

Weitere Funktionen

Probieren Sie es kostenlos aus.

Fragen Sie Apex. Apex antwortet in Ihrem Konto, zugeschnitten auf Ihre Firma.

Kostenloses Konto, ohne Kartendaten · monatliche Gebühr, ohne Mindestlaufzeit