Helpdesk und Webhook

Übergaben als Ticket in Zendesk, Freshdesk oder HubSpot – und per Webhook an Zapier, Make, Slack oder dein eigenes System.

Möchte ein Kunde mit einem Menschen sprechen, bekommst du die Anfrage immer per E-Mail. Außerdem erscheint sie im Team-Chat, ab dem Tarif Pro auf Wunsch auch dort, wo dein Team schon arbeitet: im Helpdesk oder per Webhook. Einrichten unter Einstellungen › Verbindungen, Abschnitt Termine & Helpdesk.

Zendesk

  1. Zendesk Admin Center › Apps und Integrationen › APIs › Zendesk API.
  2. Token-Zugriff aktivieren, API-Token hinzufügen, Token kopieren.
  3. In ShopLyra: Tickets anlegen in Zendesk, Subdomain (z.B. meinshop aus meinshop.zendesk.com), E-Mail des Agenten, dem der Token gehört, und den Token eintragen.
  4. Anbindungen speichern, dann Testticket senden.

Das Ticket hat den Kunden als Absender, den Chatverlauf als interne Notiz und die Tags shoplyra und chat – praktisch für Ansichten und Trigger.

Freshdesk

  1. In Freshdesk oben rechts auf dein Profil › Profileinstellungen.
  2. Rechts steht Ihr API-Schlüssel – kopieren.
  3. In ShopLyra: Freshdesk, Subdomain (z.B. meinshop aus meinshop.freshdesk.com) und API-Schlüssel eintragen, speichern, testen.

HubSpot

  1. HubSpot Einstellungen › Integrationen › Private Apps › Private App erstellen.
  2. Bereiche: tickets, crm.objects.contacts.read, crm.objects.contacts.write.
  3. App erstellen, Zugriffstoken kopieren.
  4. In ShopLyra: HubSpot und Token eintragen, speichern, testen.

ShopLyra sucht den Kontakt über die E-Mail-Adresse (oder legt ihn an) und verknüpft das Ticket mit ihm.

Webhook für Zapier, Make und eigene Systeme

Trag eine Adresse mit https:// ein. Bei jeder Übergabe schicken wir dorthin:

POST {deine Adresse}
Content-Type: application/json
X-ShopLyra-Event: handoff.created
X-ShopLyra-Signature: sha256=…

{
  "event": "handoff.created",
  "bot": "b93476bc84804",
  "shop": "Mein Shop",
  "sentAt": "2026-11-06T10:15:00+01:00",
  "data": {
    "email": "kunde@example.com", "name": "Anna", "note": "Paket beschädigt",
    "page": "/produkt/espressomuehle", "subject": "Chat-Übergabe: Paket beschädigt",
    "transcript": [ { "role": "user", "text": "…" }, { "role": "assistant", "text": "…" } ],
    "ticket": { "system": "zendesk", "ref": "4711", "url": "https://…" }
  }
}

Ist die Terminbuchung eingerichtet, kommt bei jedem im Chat gebuchten Termin zusätzlich das Ereignis booking.created mit event (Termin-Typ), startsAt, name, email und note.

  • Zapier: Trigger Webhooks by Zapier › Catch Hook, Adresse kopieren, hier eintragen, Test-Webhook senden. Danach z.B. Slack › Send Channel Message oder Google Sheets › Create Row.
  • Make: Modul Webhooks › Custom webhook, Adresse kopieren, hier eintragen, Test-Webhook senden, damit Make die Datenstruktur erkennt.

Signatur prüfen (für Entwickler)

Jeder Webhook ist mit deinem Secret signiert (Secret anzeigen). So prüfst du, dass er wirklich von ShopLyra kommt:

// PHP
$expected = 'sha256=' . hash_hmac('sha256', file_get_contents('php://input'), $secret);
if (!hash_equals($expected, $_SERVER['HTTP_X_SHOPLYRA_SIGNATURE'] ?? '')) { http_response_code(401); exit; }

// Node.js
const expected = 'sha256=' + crypto.createHmac('sha256', secret).update(rawBody).digest('hex');
if (!crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(req.headers['x-shoplyra-signature'] ?? ''))) return res.sendStatus(401);

Wenn etwas nicht ankommt

Schlägt ein Ticket oder Webhook fehl, bekommst du die Anfrage trotzdem per E-Mail, und im Überblick erscheint unter Qualität ein Hinweis mit dem Grund (z.B. „Zendesk lehnt den Zugang ab – API-Token und Rechte prüfen“). Webhooks gehen nur an öffentliche https://-Adressen.

Datenschutz

Mit Helpdesk oder Webhook gibst du Name, E-Mail und Chatverlauf an diese Dienste weiter. Nimm sie in deine Datenschutzerklärung und dein Verzeichnis der Verarbeitungstätigkeiten auf und schließe mit ihnen einen Auftragsverarbeitungsvertrag.

Mehr dazu im Ratgeber