Skip to main content

Trigger

Es können Trigger definiert werden, die automatische Aktionen in DeDeSales ausführen, z. B. eine Website aufrufen, eine Aktivität anlegen oder eine E-Mail senden.

  1. Verwenden Sie das grüne Plus um eine neue Definition anzulegen
  2. Klicken Sie auf einen vorhandenen Trigger um diesen zu bearbeiten
  3. In der Übersicht sehen Sie wann die letzte Ausführung war
  4. Die Anzahl zeigt, wie oft der Trigger ausgelöst wurde
Basis

Bei

Neuanlage
    füllen
  1. Name des Triggers festlegen
  2. Secret festlegen
  3. Typ des Triggers festlegen 
  4. Je nach Typ hinterlegen Sie erst die Pflichtfelder aus und bekommen dann eine Guidentsprechende zugewiesen.URL Dieseoder mitdas dementsprechende festgelegtenBild
    5. Secret ergeben die spätere Zuordnung.

Mögliche Aktionen die ausgeführt werden können:
  • Aktivität anlegen
  • Lead bearbeiten
  • E-Mail senden

Hier müssen Sie jeweils die Felder Ihren Wünschen entsprechend ausfüllen.

So wird der Trigger ausgelöst

Ein Trigger wird immer nur einmal ausgelöst. Sollte also ein Bild mehrfach gezeigt oder ein Link mehrfach angeklickt werden, wird die Aktion nur ein einziges mal ausgelöst.

Um den Trigger auszulösen wird eine URL benötigt. Die URL setzt sich wie folgt zusammen:

https://{ihre-dedesales-backend-url}/trigger/{guid des triggers}?j={base64 kodierte Json Daten}&h={hash}

 

Ihre DeDeSales Backend URL

Diese entnehmen Sie bitte dem Browser, wenn Sie das Backend aufrufen. Beachten Sie, dass Sie eine URL für das Test und das Live System haben. Sie müssen die URL verwenden, in der Sie auch den Trigger angelegt haben.

Guid des Triggers

Die Guid des Triggers sehen Sie, wenn Sie den Trigger im Backend aufrufen.

image.png

Base64 kodierte Json Daten

Damit DeDeSales bei dem Trigger aufruf, die Daten korrekt verarbeiten kann müssen Informationen als Json Objekt mitgegeben werden.

{
"contactId": "K10001",
"customerId": "K10002",
"leadId": "4234-234234343-234324-234",
"employeeNr": "99990"
}
contactId
Die Kontaktnummer des Ansprechpartners.
customerId
Die Kundennummer.
leadId
Die Guid des Leads. Wird nur benötigt, wenn Sie als Aktion Lead bearbeiten gewählt haben.
employeeNr
Die Nummer des Mitarbeiters aus dem DeDeSales Backend unter dem die Aktion ausgeführt wird.
Hash

Der Hash ist dafür da, dass die Trigger nicht fälschlicherweise ausgelöst werden. Bei dem Hash handelt es sich um einen MD5-Hash. Dieser wird aus folgendem String erstellt {base64 kodierte Json Daten}{secret}

Das Secret geben Sie bei der Anlage des Triggers im DeDeSales-Backend an.

Stimmt der Hash nicht mit dem im DeDeSales ermittelten Wert überein, wird bei Aufruf der URL ein Fehler 500 zurückgemeldet.

Back to top