contaoacademy / contao-zammad-nc-api-bundle
API Anbindung zum Ticket System Zammad über ein Gateway des Notification-Center
Installs: 379
Dependents: 0
Suggesters: 0
Security: 0
Stars: 10
Watchers: 2
Forks: 0
Open Issues: 0
Type:contao-bundle
Requires
- php: >=8.1
- codefog/contao-haste: ^5.1
- contao/core-bundle: ^4.13 || ^5.3
- symfony/config: ^5.4 || ^6.4 || ^7.0
- symfony/dependency-injection: ^5.4 || ^6.4 || ^7.0
- symfony/http-client: ^5.4 || ^6.4 || ^7.0
- symfony/http-kernel: ^5.4 || ^6.4 || ^7.0
- terminal42/notification_center: ^2.0.5
Requires (Dev)
- contao/easy-coding-standard: ^6.0
- contao/rector: ^1.0
README
API Anbindung zum Ticket System Zammad über ein eigenes Gateway des Notification Centers.
Beschreibung
Über die Schnittstelle können Formulardaten direkt als neues Ticket an Zammad gesendet werden. Falls ein Kontakt in Zammad nicht gefunden wird, wird dieser ebenfalls erzeugt. Im Nachrichtentext können beliebige Daten anhand von Simple Tokens ergänzt werden.
Important
Die Version 3.* ist nicht mit den Vorgängerversionen kompatibel. Bei einem Update von 2.* auf 3.* muss die Erweiterung neu konfiguriert werden.
Dokumentation
Eine ausführliche Doku findest Du hier: https://www.fenepedia.de/tools/zammad-connector
Schnellstart-Anleitung
- In Zammad ein neuen Zugriffstoken generieren: User > Profil > Token-Zugriff > Erstellen (Berechtigung:
ticket.agent
) - Notification Center > Neues Gateway vom Typ Zammad-API (Host + Token hinterlegen)
- Neue Benachrichtigung (z. B. Formularübergragung)
- Neue Nachricht erstellen: Gateway = Zammad
- Pflichtfelder ausfüllen: E-Mail, Ticket-Betreff, Ticket-Gruppe, Nachrichtentext (Simple Token möglich:
##form_feldname##
) - Kunden-Parameter bei Bedarf ergänzen (Empfehlung:
firstname
,lastname
)
Zuordnung der Formularfelder
Ab Version 3.0 findet die Zuordnung der Felder über Simple Tokens statt. Anbei noch eine Liste von bekannten Feldnamen für die Kundendaten:
- firstname = Vorname
- lastname = Nachname
- mobile = Mobilnummer
- phone = Telefonnummer
- fax = Faxnummer
- web = Website
- address = Adresse
- department = Abteilung
- street = Straße
- zip = Postleitzahl
- city = Stadt
- Country = Land
- note = Notiz
Welche Version soll ich installieren?
Unterstützer:innen
Die Entwicklung der Erweiterung wurde von den folgenden Personen bzw. Unternehmen ermöglicht:
- Fritz Michael Gschwantner | inspiredminds
- Alexander Naumov
- Christian Feneberg | Contao Academy