Kundenprofile und Tickets
Kundenprofile abrufen und synchronisieren, Tickets aus deinem System erstellen.
4.4 Kundenprofile
Die Konversationen desselben Kunden werden einem Kundenprofil zugeordnet, auf das die contact_id in der Konversation verweist. Erkennungsreihenfolge: die von dir signierte Mitglieds-ID (user_token oder die per API übergebene user.id) > Kanalnutzer (z. B. WeChat openid) > Webseitenbesucher. Anonyme Besucher werden nach dem Login in das Profil des Mitglieds zusammengeführt; zwei verschiedene Mitglieder werden nicht automatisch zusammengeführt – bei gleicher E-Mail oder Telefonnummer erfolgt nur ein Hinweis im Backend, und der Kundenservice führt sie manuell zusammen.
| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | /v1/contacts?user_id= oder ?email= | Kundenprofil anhand deiner Mitglieds-ID oder E-Mail-Adresse suchen |
| GET | /v1/contacts/{id} | Kundenprofil: Name, E-Mail, Telefon, Tags tags, Notizen notes, benutzerdefinierte Felder attributes, Anzahl der Konversationen, letzter Besuchszeitpunkt, Mitglieds-IDs user_ids |
| PATCH | /v1/contacts/{id} | Daten aus deinem System synchronisieren: name, phone, tags (maximal 30), notes, attributes (vollständig ersetzt, maximal 30 Felder). Nur die zu ändernden Felder übergeben |
4.5 Tickets
| Methode | Pfad | Beschreibung |
|---|---|---|
| POST | /v1/tickets | Ticket erstellen, z. B. über das „Kontakt“-Formular der Website: subject, description, priority (urgent / high / normal / low), name / email / phone des Kunden, optional verknüpft mit conversation_id oder contact_id. Ist eine E-Mail-Adresse vorhanden, wird die Antwort des Kundenservice per E-Mail an den Kunden gesendet |
| GET | /v1/tickets/{id} | Ticket und Zeitverlauf (Kundennachrichten, Antworten des Kundenservice, Statusänderungen; ohne interne Notizen) |
Ticket-Status: open ausstehend, pending wartet auf den Kunden, resolved gelöst, closed geschlossen. Die Bearbeitungsfrist wird je nach Priorität in den „Bot-Einstellungen“ festgelegt.
War diese Seite hilfreich?
Zuletzt aktualisiert:
