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
- Zendesk Admin Center › Apps und Integrationen › APIs › Zendesk API.
- Token-Zugriff aktivieren, API-Token hinzufügen, Token kopieren.
- In ShopLyra: Tickets anlegen in Zendesk, Subdomain (z.B.
meinshopaus meinshop.zendesk.com), E-Mail des Agenten, dem der Token gehört, und den Token eintragen. - 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
- In Freshdesk oben rechts auf dein Profil › Profileinstellungen.
- Rechts steht Ihr API-Schlüssel – kopieren.
- In ShopLyra: Freshdesk, Subdomain (z.B.
meinshopaus meinshop.freshdesk.com) und API-Schlüssel eintragen, speichern, testen.
HubSpot
- HubSpot Einstellungen › Integrationen › Private Apps › Private App erstellen.
- Bereiche:
tickets,crm.objects.contacts.read,crm.objects.contacts.write. - App erstellen, Zugriffstoken kopieren.
- 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.