API-Dokumentation

Mit der API von DIGO Email arbeiten deine Website, dein Onlineshop oder deine Unternehmenssoftware mit deinem Konto zusammen: Sie melden Kontakte mit ihrer Einwilligung an, senden Produkte und Beiträge für deine E-Mails und erfassen Bestellungen und Warenkörbe, damit du siehst, wie viel jede Kampagne verkauft, und Automatisierungen starten kannst.

Bevor du anfängst

In diesen Fällen musst du keinen Code schreiben, denn die Verbindung ist schon fertig:

• WordPress und WooCommerce: Lade das Plugin unter Integrationen herunter. Es bringt die Anmeldungen aus dem Checkout und aus Contact-Form-7-Formularen zu DIGO Email, dazu Bestellungen, Produkte, Blogbeiträge und Warenkörbe.
• digo.sale: Öffne in der Verwaltung deines Shops Marketing → DIGO Email und füge den Schlüssel ein.
• Ein Anmeldeformular: Jede Liste hat ihr eigenes, zum Teilen per Link oder zum Einbinden in deine Website, unter Listen und Formulare.
• ChatGPT und Claude: Verbinde deinen Assistenten unter Integrationen › ChatGPT und Claude. Er meldet sich mit deiner Zustimmung an (OAuth), ohne API-Schlüssel.

Die API ist für alles andere da: eine individuell entwickelte Website, eine andere E-Commerce-Plattform, ein CRM, eine Unternehmenssoftware oder eine App mit eigenem Server.

Erste Schritte

1. Öffne im Dashboard Integrationen. Gib unter Website verbinden den Namen und die Adresse der Website ein und wähle Website als Plattform.
2. Klicke auf Verbinden und Schlüssel erstellen und kopiere den angezeigten Schlüssel: Er beginnt mit dge_ und wird nur ein einziges Mal angezeigt.
3. Teste den Schlüssel, indem du die Verbindungsdaten abfragst:

curl https://www.digo.email/api/v1/ping \
  -H "Authorization: Bearer dge_DEIN_SCHLUESSEL" \
  -H "Accept: application/json"

{
  "store": "Onlineshop",
  "account": "Rossi GmbH",
  "platform": "site",
  "can_send": true,
  "status": "active"
}

Ab der ersten erfolgreichen Anfrage wird die Website im Dashboard als Verbunden angezeigt.

Authentifizierung

Jede Anfrage enthält den Schlüssel der Website im Header Authorization, nach dem Wort Bearer:

Authorization: Bearer dge_DEIN_SCHLUESSEL

• Ein Schlüssel pro Website. Du kannst bis zu 20 Websites verbinden, jede mit ihrem eigenen Schlüssel. Produkte, Beiträge, Bestellungen und Warenkörbe gehören zu der Website, die sie gesendet hat; Kontakte, Listen, Tags und Felder gehören zum Konto und gelten für alle Websites.
• Bewahre ihn auf dem Server auf. Wer den Schlüssel hat, kann in deinem Namen Adressen anmelden und Bestellungen senden: Füge ihn nie in das JavaScript deiner Seiten, in eine auf Handys installierte App oder in ein öffentliches Repository ein.
• Du siehst ihn nur einmal. Wir speichern nur einen verschlüsselten Fingerabdruck des Schlüssels, und im Dashboard zeigen wir seine letzten sechs Zeichen. Wenn du ihn verlierst, erstelle einen neuen.
• Zum Ändern öffnest du Integrationen und dann Bearbeiten oder Schlüssel ändern › Neuer Schlüssel: Der bisherige funktioniert sofort nicht mehr. Mach das, wenn du glaubst, dass jemand ihn gesehen hat.
• Die Website trennen deaktiviert den Schlüssel und löscht die von dieser Website empfangenen Produkte, Beiträge und Bestellungen. Die Kontakte bleiben.

Anfragen und Antworten

Alle Adressen beginnen so:

https://www.digo.email/api/v1

• JSON. Sende die Daten als JSON mit Content-Type: application/json und fordere die Antworten mit Accept: application/json an. Die Antworten sind immer JSON, in UTF-8. Verwende immer HTTPS.
• Deine eigenen IDs. Produkte, Beiträge, Bestellungen und Warenkörbe werden an deiner id erkannt (Text, bis zu 64 Zeichen). Wenn du dieselbe id erneut sendest, wird das Element aktualisiert statt neu angelegt.
• Beträge in Einheiten der Währung, mit Punkt als Dezimaltrennzeichen: 49.90, nicht 4990. Die Währung ist ein Code aus drei Buchstaben (EUR, CHF, USD); fehlt er, gilt die in Integrationen eingestellte Währung der Website.
• Datumsangaben im Format ISO 8601 mit Zeitzone: 2026-10-20T09:30:00+02:00.
• Meldungen. Das Feld message der Fehler ist für Menschen geschrieben, auf Italienisch, Englisch, Spanisch, Französisch oder Deutsch, je nach Header Accept-Language oder Sprache des Kontos. Entscheide in deinem Code anhand des HTTP-Statuscodes und des Feldes error, die sich nie ändern.
• Neue Felder. Antworten können neue Felder bekommen: Ignoriere die, die du nicht kennst.

Fehler

Statuscodes 2xx bedeuten, dass die Anfrage erfolgreich war. In allen anderen Fällen erklärt der Inhalt der Antwort, was passiert ist:

{
  "error": "account_inactive",
  "message": "Das Konto bei DIGO Email ist noch nicht aktiv."
}

{
  "message": "Du musst die Einwilligungserklärung akzeptieren.",
  "errors": {
    "consent": ["Du musst die Einwilligungserklärung akzeptieren."]
  }
}

Limits

• Bis zu 300 Anfragen pro Minute für jede verbundene Website, über alle Endpunkte gerechnet.
• Für POST /contacts höchstens 60 Anmeldungen pro Minute pro Website.
• Produkte, Beiträge und frühere Bestellungen werden in Paketen von 100 pro Anfrage gesendet.
• Die Antworten nennen das allgemeine Limit (X-RateLimit-Limit) und wie viele Anfragen in der laufenden Minute übrig sind (X-RateLimit-Remaining). Über einem Limit erhältst du 429 mit Retry-After.

Eine Anfrage, die an einem Netzwerkfehler, einem 429 oder einem 5xx gescheitert ist, kannst du bedenkenlos wiederholen: Bestellungen, Produkte, Beiträge und Warenkörbe werden über die id aktualisiert, und ein bereits angemeldeter Kontakt wird nicht doppelt angelegt. Andere 4xx-Fehler kommen dagegen unverändert zurück, bis du die Daten korrigierst.

Liste der Endpunkte

Konto und Einstellungen

Diese Endpunkte lesen, was du im Dashboard vorbereitet hast: Deine Website nutzt sie, damit die Person, die sie einrichtet, Listen, Tags und Felder auswählen kann.

GET /ping

Prüft den Schlüssel und den Status des Kontos. Ruf ihn auf, wenn jemand den Schlüssel in die Einstellungen deiner Website einfügt, und ab und zu, um zu wissen, ob das Konto Anmeldungen annimmt. Die Antwort siehst du unter Erste Schritte.

GET /lists

Die Listen des Kontos in alphabetischer Reihenfolge, mit der id, die du zum Anmelden von Kontakten brauchst.

{
  "data": [
    { "id": 3, "name": "Kunden", "double_opt_in": false },
    { "id": 5, "name": "Newsletter", "double_opt_in": true }
  ]
}

Ist double_opt_in auf true, erhält jede neue Anmeldung eine E-Mail zur Bestätigung: Die Person ist erst nach der Bestätigung angemeldet und bekommt erst dann Kampagnen.

GET /tags

Die Tags des Kontos in alphabetischer Reihenfolge. Um einem Kontakt einen Tag zu geben, genügt sein Name: Tags, die es noch nicht gibt, werden angelegt.

{
  "data": [
    { "id": 9, "name": "Berlin" },
    { "id": 7, "name": "VIP" }
  ]
}

GET /fields

Die benutzerdefinierten Felder der Kontakte, die du unter Kontakte › Benutzerdefinierte Felder anlegst.

{
  "data": [
    { "key": "firma", "label": "Firma", "type": "text" },
    { "key": "geburtstag", "label": "Geburtstag", "type": "date" }
  ]
}

GET /forms

Die Anmeldeformulare der Listen, mit allem, was du brauchst, um sie im Stil deiner Website anzuzeigen. Das nutzt der Shortcode des WordPress-Plugins.

curl "https://www.digo.email/api/v1/forms?lang=de" \
  -H "Authorization: Bearer dge_DEIN_SCHLUESSEL" \
  -H "Accept: application/json"

{
  "data": [
    {
      "id": 5,
      "name": "Newsletter",
      "title": "Newsletter abonnieren",
      "action": "https://www.digo.email/f/k3Jd9QmZ2xTb7LpV4nWc8RyA1sGe6HuF",
      "locale": "de",
      "consent_text": "Ich willige ein, E-Mails von Rossi GmbH zu erhalten. Ich kann mich jederzeit wieder abmelden.",
      "labels": { "email": "E-Mail", "optional": "optional", "privacy": "Datenschutzerklärung", "submit": "Anmelden" },
      "privacy_url": "https://www.deineseite.de/datenschutz",
      "double_opt_in": true,
      "fields": [
        { "name": "first_name", "label": "Vorname", "type": "text", "required": false },
        { "name": "fields[geburtstag]", "label": "Geburtstag", "type": "date", "required": false }
      ],
      "script": "https://www.digo.email/js/digo-form.js?v=3",
      "can_send": true
    }
  ]
}

Das Formular läuft nicht über deinen Server: Der Browser der Besucherin oder des Besuchers sendet es direkt an die Adresse action, ohne Schlüssel. Einwilligung, Double-Opt-in und Schutz vor Missbrauch sind die der Formulare von DIGO Email. So baust du es:

• ein <form method="post"> mit action als Ziel;
• das Feld email und die Felder aus fields, jeweils mit ihrem name, Pflichtfelder, wenn required true ist;
• ein Kontrollkästchen consent neben dem Text consent_text und dem Link zu privacy_url, dazu ein verstecktes Feld consent_text mit demselben Text;
• das in script angegebene Skript. Auf den Websites des Kontos (verifizierte Versanddomains und verbundene Websites) sendet es das Formular, ohne die Seite zu verlassen, und zeigt die Antwort direkt dort an; anderswo oder ohne Skript sieht man die Antwort auf einer Seite von DIGO Email.

Nenne kein Feld website: Das ist die Falle für automatische Programme, und ein Formular, das es ausfüllt, wird ignoriert. Ohne den Link zur Datenschutzerklärung in den Einstellungen des Kontos lautet die Antwort 409 privacy_missing.

Kontakte

POST /contacts

Meldet eine Person an, die eingewilligt hat, deine E-Mails zu erhalten: über ein Formular deiner Website, im Checkout oder bei der Registrierung. Ohne Einwilligung wird nichts gespeichert.

curl -X POST https://www.digo.email/api/v1/contacts \
  -H "Authorization: Bearer dge_DEIN_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "email": "lena.schmidt@example.com",
    "first_name": "Lena",
    "last_name": "Schmidt",
    "list_ids": [5],
    "tags": ["Website"],
    "fields": { "firma": "Schmidt Design", "geburtstag": "1990-04-18" },
    "consent": true,
    "consent_text": "Ich möchte den Newsletter von Rossi GmbH mit Neuigkeiten und Angeboten erhalten.",
    "source": "form",
    "form": "Fußzeile",
    "language": "de",
    "page": "https://www.deineseite.de/kontakt",
    "ip": "203.0.113.24",
    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 15_6) AppleWebKit/605.1.15"
  }'

{ "status": "confirming" }

Personen, die schon zu deinen Kontakten gehören

• Listen und Tags werden hinzugefügt, nie entfernt.
• Vor- und Nachname bleiben, wie sie sind; benutzerdefinierte Felder werden nur gefüllt, wenn sie leer sind, und die Sprache nur, wenn noch keine bekannt ist.
• Wer schon angemeldet ist, kommt sofort auch in Listen mit Double-Opt-in, ohne erneute Bestätigung.
• Wer sich abgemeldet hatte, muss über das eigene Postfach bestätigen, auch bei Listen ohne Double-Opt-in: Niemand kann die Person an ihrer Stelle wieder anmelden. An Adressen, die unzustellbar waren oder E-Mails als Spam gemeldet haben, senden wir nichts.

Was danach passiert

• Sobald der Kontakt angemeldet ist, sofort oder nach der Bestätigung, starten die Automatisierungen Meldet sich für eine Liste an und Erhält einen Tag.
• Über dem Kontaktlimit deines Kontos wird die Anmeldung trotzdem gespeichert, aber Kampagnen und Automatisierungen halten an, bis du weitere Kontakte kaufst oder welche entfernst; beim Doppelten des Limits werden neue Anmeldungen mit 409 contact_limit abgelehnt.
• Im Kontaktprofil findest du die Anmeldung mit dem Einwilligungstext, der Website, der Seite und dem Formular.

<?php
// Der Schlüssel kommt aus einer Umgebungsvariable: Schreib ihn nicht in den Code.
$consentText = 'Ich möchte den Newsletter von Rossi GmbH mit Neuigkeiten und Angeboten erhalten.';

if (empty($_POST['einwilligung'])) {
    exit('Um dich anzumelden, hake das Kästchen zur Einwilligung an.');
}

$ch = curl_init('https://www.digo.email/api/v1/contacts');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('DIGO_EMAIL_KEY'),
        'Content-Type: application/json',
        'Accept: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'email' => trim($_POST['email'] ?? ''),
        'first_name' => trim($_POST['vorname'] ?? ''),
        'list_ids' => [5],
        'consent' => true,
        'consent_text' => $consentText, // derselbe Text wie neben dem Kästchen
        'source' => 'form',
        'language' => 'de',
        'page' => 'https://www.deineseite.de/kontakt',
        'ip' => $_SERVER['REMOTE_ADDR'],
        'user_agent' => $_SERVER['HTTP_USER_AGENT'] ?? '',
    ]),
]);
$body = json_decode((string) curl_exec($ch), true);
$code = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);

$messages = [
    'subscribed' => 'Danke, du bist angemeldet.',
    'confirming' => 'Fast geschafft: Öffne die E-Mail, die wir dir geschickt haben, und bestätige.',
    'limited' => 'Heute können wir dir keine weitere Bestätigungs-E-Mail schicken: Versuch es morgen noch einmal.',
    'capped' => 'Heute können wir dir keine weitere Bestätigungs-E-Mail schicken: Versuch es morgen noch einmal.',
];
if ($code === 200) {
    echo $messages[$body['status']] ?? $messages['subscribed'];
} else {
    error_log('DIGO Email: ' . ($body['message'] ?? 'HTTP ' . $code));
    echo 'Die Anmeldung hat nicht geklappt. Bitte versuch es später noch einmal.';
}

const response = await fetch('https://www.digo.email/api/v1/contacts', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DIGO_EMAIL_KEY}`,
    'Content-Type': 'application/json',
    Accept: 'application/json',
  },
  body: JSON.stringify({
    email: 'lena.schmidt@example.com',
    list_ids: [5],
    consent: true,
    consent_text: 'Ich möchte den Newsletter von Rossi GmbH mit Neuigkeiten und Angeboten erhalten.',
    source: 'checkout',
    language: 'de',
  }),
});
const data = await response.json();
if (!response.ok) throw new Error(data.message);
console.log(data.status); // subscribed, confirming, limited oder capped

Produkte und Beiträge

Die Produkte und Blogbeiträge, die du hier sendest, erscheinen im E-Mail-Editor in den Blöcken Produkte und Beiträge: Wer eine Kampagne schreibt, wählt sie aus einer Liste aus, mit Titel, Bild, Preis und Link fertig vorbereitet.

PUT /items

Legt bis zu 100 Elemente pro Anfrage an oder aktualisiert sie, erkannt an type und id. Sende beim ersten Mal alle und danach immer dann, wenn sich Titel, Preis, Bild oder Verfügbarkeit ändern.

curl -X PUT https://www.digo.email/api/v1/items \
  -H "Authorization: Bearer dge_DEIN_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "items": [
      {
        "type": "product",
        "id": "1042",
        "title": "Glasierte Keramiktasse",
        "url": "https://www.deineseite.de/produkte/glasierte-tasse",
        "image": "https://www.deineseite.de/media/glasierte-tasse.jpg",
        "excerpt": "Handgemacht, 350 ml, spülmaschinenfest.",
        "price": 24.00,
        "sale_price": 19.90,
        "available": true
      },
      {
        "type": "post",
        "id": "87",
        "title": "So findest du die richtige Tasse",
        "url": "https://www.deineseite.de/blog/richtige-tasse",
        "image": "https://www.deineseite.de/media/blog-tassen.jpg",
        "excerpt": "Material, Größe und Pflege: ein Ratgeber in fünf Minuten.",
        "published_at": "2026-10-12T08:00:00+02:00"
      }
    ]
  }'

{ "saved": 2, "skipped": [] }

saved zählt die gespeicherten Elemente; skipped listet die IDs, die übersprungen wurden, weil Name oder gültige Adresse fehlten.

DELETE /items/{type}/{id}

Entfernt ein Produkt, das du nicht mehr verkaufst, oder einen Beitrag, der nicht mehr veröffentlicht ist, aus der Liste. Antwortet mit 204, ohne Inhalt, auch wenn das Element nicht vorhanden war. Bereits vorbereitete E-Mails, die es enthalten, ändern sich nicht.

curl -X DELETE https://www.digo.email/api/v1/items/product/1042 \
  -H "Authorization: Bearer dge_DEIN_SCHLUESSEL" \
  -H "Accept: application/json"

Bestellungen

Bestellungen zeigen, wie viel jede Kampagne verkauft, starten die Automatisierungen Kauft im Shop ein und schließen verlassene Warenkörbe. Käuferinnen und Käufer werden nicht zu Kontakten: Wir behalten eine Bestellung nur, wenn die kaufende Person schon zu deinen Kontakten gehört oder über den Link einer Kampagne kommt (siehe Verkäufe aus Kampagnen). Alle anderen werden verworfen.

POST /orders

Erfasst eine Bestellung oder aktualisiert ihren Status. Sende sie beim Anlegen und erneut bei jeder Änderung (Zahlung, Erstattung, Stornierung), immer mit derselben id.

curl -X POST https://www.digo.email/api/v1/orders \
  -H "Authorization: Bearer dge_DEIN_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "id": "5531",
    "number": "#5531",
    "email": "lena.schmidt@example.com",
    "status": "paid",
    "total": 43.80,
    "refunded": 0,
    "currency": "EUR",
    "created_at": "2026-10-20T10:15:00+02:00",
    "click_id": "184467.9f1c2ab07d3e4f51",
    "items": [
      { "id": "1042", "name": "Glasierte Keramiktasse", "quantity": 2, "total": 39.80 }
    ]
  }'

{ "attributed": true }

attributed ist true, wenn die Bestellung für eine Kampagne zählt. Eine Bestellung, die weder einen Kontakt noch eine Kampagne betrifft, wird nicht gespeichert, und die Antwort lautet {"attributed": false, "stored": false}.

• Wird eine Bestellung zum ersten Mal paid und ist die kaufende Person ein Kontakt, starten die Automatisierungen Kauft im Shop ein.
• Eine Bestellung mit pending oder paid schließt die offenen Warenkörbe der kaufenden Person: E-Mails zu verlassenen Warenkörben gehen dann nicht mehr raus.
• In den Berichten zählen bezahlte Bestellungen abzüglich Erstattungen. Ausstehende und stornierte Bestellungen zählen nicht.

POST /orders/history

Importiert frühere Bestellungen, bis zu 100 pro Anfrage, in orders und mit denselben Feldern wie POST /orders. Es gelten dieselben Regeln, aber diese Bestellungen beschreiben, was schon passiert ist: Sie starten keine Automatisierungen und schließen keine Warenkörbe. Du kannst sie erneut senden: Sie aktualisieren dieselben Bestellungen. Eine ungültige E-Mail passt einfach zu keinem Kontakt.

curl -X POST https://www.digo.email/api/v1/orders/history \
  -H "Authorization: Bearer dge_DEIN_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "orders": [
      { "id": "4870", "email": "lena.schmidt@example.com", "status": "paid", "total": 24.00, "created_at": "2026-03-02T17:40:00+01:00" },
      { "id": "4871", "email": "jonas.mueller@example.com", "status": "refunded", "total": 58.50, "refunded": 58.50, "created_at": "2026-03-03T09:12:00+01:00" }
    ]
  }'

{ "received": 2, "stored": 1 }

received zählt die empfangenen Bestellungen, stored die gespeicherten, weil sie zu deinen Kontakten gehören oder aus einer Kampagne kommen.

Warenkörbe

Mit Warenkörben kannst du die Kundschaft mit der Automatisierung Lässt den Warenkorb liegen daran erinnern, was sie in deinem Shop zurückgelassen hat. In E-Mails zeigen die Platzhalter {{carrello_link}}, {{carrello_totale}} und {{carrello_prodotti}} den Link zum Fortsetzen des Warenkorbs, die Summe und die Produkte.

PUT /carts

Speichert den Warenkorb einer Person, deren E-Mail du kennst, weil sie angemeldet ist oder sie im Checkout eingegeben hat. Sende ihn bei jeder Änderung erneut, immer mit derselben id. Wir behalten nur die Warenkörbe von Personen, die schon zu deinen Kontakten gehören: Niemand wird zum Kontakt, weil er einen Warenkorb füllt.

curl -X PUT https://www.digo.email/api/v1/carts \
  -H "Authorization: Bearer dge_DEIN_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "id": "c-8f2a1c",
    "email": "lena.schmidt@example.com",
    "total": 39.80,
    "currency": "EUR",
    "url": "https://www.deineseite.de/warenkorb?fortsetzen=8f2a1c",
    "items": [
      { "id": "1042", "name": "Glasierte Keramiktasse", "quantity": 2, "total": 39.80, "image": "https://www.deineseite.de/media/glasierte-tasse.jpg" }
    ]
  }'

{ "saved": true }

Gehört die E-Mail zu keinem deiner Kontakte, lautet die Antwort {"saved": false}, und ein vorher mit derselben id gespeicherter Warenkorb wird entfernt.

DELETE /carts/{id}

Schließt einen Warenkorb, den die Person geleert hat. Antwortet mit 204, ohne Inhalt. Nach einem Kauf ist das nicht nötig: Die Bestellung schließt die Warenkörbe der kaufenden Person bereits.

curl -X DELETE https://www.digo.email/api/v1/carts/c-8f2a1c \
  -H "Authorization: Bearer dge_DEIN_SCHLUESSEL" \
  -H "Accept: application/json"

Verkäufe aus Kampagnen

Damit du siehst, wie viel jede Kampagne verkauft, verknüpft DIGO Email die Bestellungen mit den Klicks in den E-Mails:

1. Wenn jemand in der E-Mail auf einen Link zu deiner Website klickt, hängen wir an die Adresse den Parameter digo_c an, zum Beispiel https://www.deineseite.de/produkte/glasierte-tasse?digo_c=184467.9f1c2ab07d3e4f51. Das gilt für die in Integrationen eingestellte Adresse der Website und ihre Subdomains.
2. Hat die Person Marketing-Cookies akzeptiert, speichert deine Website den Wert 7 Tage lang im Cookie digo_c. Ein neuerer Klick ersetzt den vorherigen.
3. Wenn die Person kauft, sendest du den Wert des Cookies als click_id mit der Bestellung.

Die Bestellung zählt für die Kampagne, wenn sie innerhalb von 7 Tagen nach dem letzten Klick auf diese E-Mail eingeht. Hat die Person auf mehrere E-Mails geklickt, zählt die letzte.

<script>
(function () {
  var click = new URLSearchParams(location.search).get('digo_c');
  if (!/^\d{1,19}\.[a-f0-9]{16}$/.test(click || '')) return;
  if (!marketingErlaubt()) return; // die Prüfung deines Cookie-Banners
  document.cookie = 'digo_c=' + click + '; path=/; max-age=604800; SameSite=Lax; Secure';
})();
</script>

$order['click_id'] = $_COOKIE['digo_c'] ?? null;

Die Verknüpfung funktioniert nur, wenn die Klickmessung eingeschaltet ist, unter Einstellungen › Unternehmen › Öffnungen und Klicks messen: Ohne sie führen die Links der E-Mails direkt zur Website und tragen kein digo_c.

Bewährte Vorgehensweisen

• Ruf die API von deinem Server auf, nie aus dem Browser: Der Schlüssel darf ihn nicht verlassen.
• Lass deine Kundschaft nicht warten. Stelle Anmeldungen, Bestellungen und Warenkörbe im Checkout in eine Warteschlange und sende sie direkt danach: Wenn DIGO Email langsam oder nicht erreichbar ist, darf der Kauf nicht hängen bleiben.
• Wiederhole in Ruhe nach einem Netzwerkfehler, einem 429 oder einem 5xx und warte jedes Mal etwas länger. Anfragen mit anderen 4xx-Fehlern musst du korrigieren, nicht wiederholen.
• Frag die Einwilligung mit einem Kontrollkästchen ab, das nicht schon angehakt ist, und sende in consent_text genau den Text, den die Person gelesen hat.
• Sende die Sprache der Person, die sich anmeldet, mit language: Bestätigungs-E-Mails, Kampagnen und Abmeldeseiten richten sich danach.
• Halte deinen Katalog aktuell: Sende Produkte, wenn sie sich ändern, und entferne sie, wenn sie nicht mehr verkauft werden.
• Teste mit einer Testliste und deinen eigenen Adressen. Testanmeldungen sind echte Kontakte: Sie zählen zum Limit und erhalten mit Double-Opt-in echte E-Mails. Lösche sie danach im Dashboard.

Support

Bei Fragen zur API schreib an info@digo.email. Nenne den Namen der verbundenen Website, den Endpunkt und die erhaltene Antwort: nie den Schlüssel.