Bemerkung

Header based actions in Google channels work in the same way as in email channels. This is why the section has been adopted verbatim from here.

Header Based Actions

With specific email headers, you can make Zammad perform different actions depending on the content of the headers. So, if you create a new email (e.g. from a form on your website) you can set these headers to perform actions or to hand over special information like custom attributes.

Gefahr

🛡 Vertrauenswürdige Kanäle notwendig 🛡

This feature is a potential risk with external communication and thus require channels being set to trusted explicitly. You can find instructions about how to set a channel to trusted at the end of this page.

Tipp

  • The header names listed below are examples and in our opinion the most relevant ones. However, you can adjust mostly all article or ticket attributes including custom ones if you know the attribute’s exact name. Have a look here to find the attribute names.

  • Please note that while header names are case insensitive, header values are not. Make sure to specify values in expected case, otherwise they will not match.

Auto responses

Normally, Zammad runs internal checks to see if an incoming email is an automatic response. In such cases Zammad will not send trigger based responses. You can override this with the below mentioned headers:

x-zammad-send-auto-response

Verwenden Sie false, um Trigger-basierte Antworten zu deaktivieren. Sofern Sie es auf true setzen, wird Zammad eine Antwort senden.

This option does not work if e.g. precedence: list is set unless you use the auto response header below as well.

x-zammad-is-auto-response

Wenn Sie diesen Header setzen weiß Zammad, dass die entsprechende E-Mail eine automatisch generierte Antwort ist (true). Das verhindert die Ausführung von E-Mail-basierten Triggern.

Setzen Sie den Header auf false, wenn eine automatische Antwort generiert werden soll.

Dieser Header erlaubt es, die automatische Erkennung zum Beispiel für precedence: list zu übersteuern.

Ticket Attribute

Zammad allows you to use headers to manipulate ticket creations or follow ups. The manipulation can be used instead of triggers. Triggers are considered after header settings and thus can still override headers.

To differentiate between ticket creation and follow-up:

  • Verwenden Sie für die Erstellung: X-Zammad-Ticket-{Attribute Name}

  • Verwenden Sie für Antworten: X-Zammad-Ticket-FollowUp-{Attribute Name}

Das erlaubt es, die Änderungen nur in der erforderlichen Situation auszuführen.

Tipp

When using attributes that require date / time values, ensure to use Time Zoned Times. e.g. for 28th September 2021 on 8 am CEST, you can use one of the following examples:

  • 2021-09-28T08:00:00+0200

  • 2021-09-28T08:00:00+02:00

  • 2021-09-28T06:00:00.000Z

X-Zammad-Ticket-Priority & X-Zammad-Ticket-FollowUp-Priority
Ermöglicht Ihnen die Anpassung der Ticket-Priorität.
Beispiel: X-Zammad-Ticket-Priority: 1 low
X-Zammad-Ticket-Group & X-Zammad-Ticket-FollowUp-Group
Ermöglicht Ihnen, in die reguläre Gruppenzuweisung einzugreifen.
Beispiel: X-Zammad-Ticket-Group: Verkauf
X-Zammad-Ticket-Owner & X-Zammad-Ticket-FollowUp-Owner
Weisen Sie ein Ticket direkt einem Besitzer zu oder ändern Sie diesen. Gültige Werte sind entweder Login oder E-Mail
Beispiel: X-Zammad-Ticket-Owner: jdoe
X-Zammad-Ticket-State & X-Zammad-Ticket-FollowUp-State
Setzen Sie einen bestimmten Ticket-Status.
Beispiel: X-Zammad-Ticket-State: closed
Warten-Status erfordern immer das pending_time-Attribut zusätzlich.
Example: X-Zammad-Ticket-Pending_Time: 2021-09-26T08:00:00+0200
X-Zammad-Customer-Email
Verändern Sie den Kunden des Tickets. Das kann ein anderer Benutzer sein als der Absender. Antworten an den Original-Absender sind weiterhin möglich.
Beispiel: X-Zammad-Customer-Email: jdoe@example.com

Dieser Header steht für Follow-Ups nicht zur Verfügung.

X-Zammad-Customer-Login
Verändern Sie den Kunden des Tickets. Das kann ein anderer Benutzer sein als der Absender. Antworten an den Original-Absender sind weiterhin möglich.
Beispiel: X-Zammad-Customer-Login: jdoe

Dieser Header steht für Follow-Ups nicht zur Verfügung.

Artikel Attribute

Zammad erlaubt es, die Attribute und den Status von Artikeln für bereits abgerufene E-Mails zu verändern.

X-Zammad-Article-Sender
Manipulate the sender type (agent, customer or system)
Beispiel: X-Zammad-Article-Sender: System

System Emails are indicated in a similar way as trigger-responses. Users can’t see them natively and see only a indicator like that:

Eingehende E-Mail als Artikel vom Absender-Typ System
X-Zammad-Article-Type
Ändert den Artikel-Typ von eingehenden E-Mails. Das setzt voraus, dass Sie wissen welche Artikel-Typen in Ihrem System verfügbar sind.
Beispiel: X-Zammad-Article-Type: phone

Warnung

Dieser Header kann unerwünschte Auswirkungen in Ihrer Zammad-Instanz haben und zu unerwartetem Verhalten führen. Nutzen Sie diesen mit absoluter Vorsicht!

X-Zammad-Article-Internal
Verändert die Sichtbarkeit (intern/öffentlich) des Artikels.
Beispiel: X-Zammad-Article-Internal: true
X-Zammad-Ignore
Weist Zammad an, die E-Mail zu verwerfen.
Beispiel: X-Zammad-Ignore: true

Vertrauenswürdiger Kanal

Bemerkung

🚧 Nur selbst gehostet 🚧

The settings below are only available to self hosted users.

Gefahr

⚠️ As stated above, this is dangerous and can lead to unexpected behavior in the communication with external parties. Only follow the instructions below if you know what you are doing.

Das Setzen eines Kanals auf trusted kann nur über die Konsole erfolgen. Führen Sie die folgenden Befehle in der Rails-Konsole aus:

Alle Kanäle auflisten:
>> Channel.all

Suchen Sie die id des Kanals, den Sie auf trusted setzen wollen.

Wählen Sie Ihren identifizierten Kanal aus (ersetzen Sie die 99 durch die richtige ID):

>> channel = Channel.find(99)

Zeigt die aktuell aktivierten Funktionen des ausgewählten Kanals an:

>> options = channel[:options]

Fügen Sie das Kennzeichen "trusted"=>true für den eingehenden Kanal hinzu:

>> options[:inbound][:trusted] = true

Speichern Sie Ihre Änderungen:

>> channel.save!