Zum Inhalt springen

Entwickler

Dein Entwicklerteam bindet Arowana an eure Systeme an.

Dein Marketing-Team arbeitet in der Oberfläche, dein Entwicklerteam bindet Arowana an eure Systeme an: mit einer REST-API, signierten Webhooks, Schlüsseln mit genau den Rechten, die euer System braucht, und kostenlosen Test-E-Mails.

Kostenlos startenSo startest du
  • ShopifyKundschaft, Bestellungen und Bestellverlauf
  • PostHogNutzer:innen und Ereignisse aus deiner App
  • Google SheetsListen aus deinem Team, stündlich abgeglichen
  • CSV-ImportExporte aus deinem bisherigen Tool
POST https://api.arowana.app/v1/events
Authorization: Bearer <api_key>

{
  "contact": { "email": "lena@example.com" },
  "event": "order.completed",
  "properties": {
    "order_id": "1042",
    "value": 59.9,
    "currency": "EUR"
  }
}
  • → email.clicked
  • → contact.created
  • → consent.updated
Anbindungen und ein Ereignis, das dein System an die REST-API schickt.

Zur API-Dokumentation

Schlüssel und Rechte

API-Schlüssel mit minimalen Rechten.

Ein API-Schlüssel gehört zu einem Workspace und bekommt einzelne Rechte, zum Beispiel nur Ereignisse schreiben. Arowana zeigt ihn einmal an und speichert danach nur eine Prüfsumme.

13 Rechte
Von Kontakte lesen bis Abrechnung ändern. Ein Schlüssel für den Shop-Abgleich braucht zum Beispiel nur zwei.
Ablaufdatum
Schlüssel können ein Ablaufdatum bekommen. Rechte an der Abrechnung gelten nur, solange die Person, die den Schlüssel erstellt hat, Inhaber oder Admin ist.
Limits
Pro Schlüssel und Minute 300 Sendungen, 600 Lesezugriffe und 300 Schreibzugriffe. Jede Antwort sagt, wie viel noch übrig ist, und wann es weitergeht.

Neuer API-Schlüssel

Workspace Marlow

arw_••••••••••••••••••••7Qk2

Wird nur einmal angezeigt. Gilt bis 31. März.

  • Kontakte lesen
  • Kontakte schreiben
  • Ereignisse schreiben
  • Nachrichten senden
  • Kampagnen steuern
  • Abrechnung ändern
Ein API-Schlüssel nur für den Shop-Abgleich. Werte sind ein Beispiel.

Webhooks

Signierte Webhooks für 23 Ereignisse.

Ihr abonniert die Ereignisse, die euch interessieren, einzeln oder als Gruppe wie message.*. Jede Zustellung ist signiert und wird bei Fehlern wiederholt.

23 Ereignisse
Nachrichten von zugestellt bis geklickt, E-Mail-Bounces, Beschwerden und Abmeldungen, neue und geänderte Kontakte, Einwilligungen, RCS-Absender und Guthaben.
Signatur
HMAC-SHA256 über den unveränderten Body im Header X-Arowana-Signature. Doppelte Zustellungen erkennt ihr an der Event-ID.
Wiederholen und nachsenden
Bis zu fünf Versuche: sofort, nach einer Minute, fünf Minuten, einer Stunde und einem Tag. Im Zustellprotokoll seht ihr jeden Versuch und sendet einzelne Zustellungen erneut.
import crypto from "node:crypto";

function isFromArowana(rawBody, header, secret) {
  const expected = "sha256=" + crypto
    .createHmac("sha256", secret)
    .update(rawBody)
    .digest("hex");
  const a = Buffer.from(header ?? "");
  const b = Buffer.from(expected);
  return a.length === b.length && crypto.timingSafeEqual(a, b);
}

// header: req.headers["x-arowana-signature"]
Eine Webhook-Signatur in Node.js prüfen.

Ereignisse

Starte Kampagnen und Flows aus deinem eigenen Backend.

Ereignisse aus Shop, Website und App landen im Profil der Person. Jedes Ereignis kann einen Flow starten und zählt für Segmente und Auswertungen.

REST-API
Standardnamen wie order.completed, checkout.started oder signup.completed, oder eure eigenen. Die Person wird über ID, eigene ID, E-Mail oder Telefonnummer gefunden und sonst neu angelegt.
Website
Ein kleines Skript ohne Cookies mit track, identify und order.
Apps
Beispiele für Swift, Kotlin, React Native und Flutter. Apps schicken Ereignisse mit einem öffentlichen App-Schlüssel, ohne API-Schlüssel.
// Nach Login, Anmeldung oder Checkout:
arowana.push(["identify", { email: "lena@example.com" }]);

// Was sonst zählt:
arowana.push(["track", "checkout.started", {
  value: 59.90, currency: "EUR"
}]);

// Danke-Seite (mit Shopify nicht nötig):
arowana.push(["order", {
  order_id: "1042", value: 59.90, currency: "EUR"
}]);
Ereignisse von der Website an Arowana schicken.

Claude

Dein AI Agent als Marketing Automation Team mit Arowana.

Claude verbindet sich über das Model Context Protocol mit einem Workspace. Die Anmeldung läuft über OAuth, und Claude kann nur Entwürfe und Einstellungen anlegen.

Anmeldung
OAuth 2.1 mit PKCE und dynamischer Registrierung. Zugangsschlüssel gelten eine Stunde, Erneuerungsschlüssel 30 Tage.
Rechte
Lesen von Summen, Entwürfe schreiben und Einstellungen schreiben. Versand, Veröffentlichung und Abrechnung sind ausgeschlossen.

Claude verbinden

OAuth 2.1

  • workspace:readÜbersicht, Felder, Gruppen und Summen
  • drafts:writeEntwürfe für Kampagnen, Vorlagen, Seiten und Journeys
  • settings:writeAbsender, Versanddomains, Webhooks und API-Schlüssel

Zugang 1 StundeErneuerung 30 Tagejederzeit trennbar

Was eine Verbindung über den Connector bekommt.

Im Detail

Alle Fakten

Authentifizierung
Authorization: Bearer mit einem Schlüssel pro Workspace.
Format
JSON. Fehler kommen als error, message und, wo es hilft, mit hint und docs_url.
Seiten
limit und offset, bis zu 200 Einträge pro Seite, dazu die Gesamtzahl.
Idempotenz
Idempotency-Key gilt 24 Stunden. Eine Wiederholung bekommt die erste Antwort zurück.
Größe
Bis zu 4 MB pro Anfrage, 1.000 Kontakte pro Sammelanfrage und 10.000 pro Import.
Spezifikation
OpenAPI 3.1 unter /api/v1/openapi.json, lesbar unter /docs/api.
Noch nicht per API
SMS-Versand und die RCS-Testumgebung folgen.

So startest du

Starte heute mit deinen eigenen Daten.

Kostenlos starten

  1. 1

    Konto anlegen

    Kostenlos und ohne Grundgebühr. Teammitglieder kosten nichts.

  2. 2

    API-Schlüssel erstellen

    Mit Berechtigungen nur für das, was euer System braucht.

  3. 3

    Ersten Aufruf senden

    Die Dokumentation zeigt Beispiele für jeden Endpunkt.

Passt dazu