· 4 min · TextMeFlow Team

WhatsApp-Benachrichtigungen bei Freshdesk-Tickets per Webhook

Freshdesk teilt einem Kunden per E-Mail mit, dass sein Ticket gelöst wurde. Die meisten öffnen diese E-Mail erst Stunden später, falls überhaupt – und eröffnen das Ticket dann mit „Gibt es etwas Neues?" erneut, weil sie die Lösung nie gesehen haben. WhatsApp wird innerhalb weniger Minuten gelesen. Freshdesk hat keinen nativen WhatsApp-Benachrichtigungskanal, aber seine Automatisierungsregeln können einen Webhook aufrufen, und dieser Webhook kann direkt die Nachrichten-API von TextMeFlow ansprechen – keine Marketplace-App, kein Middleware-Abo.

Schritt 1: Die Automatisierungsregel in Freshdesk bauen

Gehe in Freshdesk zu Admin → Workflows → Automations → Ticket Updates und lege eine neue Regel an. Setze die Bedingung auf den Übergang, für den du wirklich eine Nachricht willst – typischerweise „Status ändert sich zu Resolved" oder „Status ändert sich zu Open UND vorheriger Status war Pending" (das heißt, die Antwort wird nun von deiner Seite erwartet, nicht vom Kunden). Vermeide einen Trigger auf „jedes Ticket-Update": Freshdesk löst dieses Ereignis auch bei internen Notizen, Tag-Änderungen und Agenten-Neuzuweisungen aus, und du willst nicht für jedes davon eine WhatsApp-Nachricht.

Füge der Regel eine Aktion „Trigger Webhook" hinzu:

  • Request-Typ: POST
  • Callback-URL: dein Empfänger, z. B. https://yourapp.example.com/freshdesk-hook
  • Kodierung: JSON
  • Authentifizierung: Freshdesk erlaubt einen eigenen Header – nutze ihn für ein gemeinsames Secret, da der Webhook-Body selbst keine eingebaute Signatur hat

Schritt 2: Die Payload mit Platzhaltern formen

Der Webhook-Body-Editor von Freshdesk unterstützt Ticket-Platzhalter. Beschränke die Payload auf das, was dein Empfänger braucht:

{
  "ticket_id": "{{ticket.id}}",
  "status": "{{ticket.status}}",
  "subject": "{{ticket.subject}}",
  "requester_phone": "{{ticket.requester.mobile}}"
}

Freshdesk speichert Telefonnummern von Kontakten unter mobile oder phone, je nachdem, welches Feld der Anfragende ausgefüllt hat – prüfe in deinem Empfänger beide, da bei vielen Kontakten nur eines von beiden befüllt ist.

Schritt 3: Den Webhook empfangen und die WhatsApp-Nachricht senden

from flask import Flask, request
import os, requests

app = Flask(__name__)

@app.post("/freshdesk-hook")
def freshdesk_hook():
    if request.headers.get("X-Webhook-Secret") != os.environ["FRESHDESK_WEBHOOK_SECRET"]:
        return "", 401

    data = request.json
    phone = data.get("requester_phone")
    if not phone:
        return "", 200

    status = data.get("status")
    subject = data.get("subject")
    ticket_id = data.get("ticket_id")

    if status == "Resolved":
        text = f'Dein Ticket "{subject}" (#{ticket_id}) wurde gelöst. Antworte hier, falls du noch Hilfe brauchst.'
    else:
        text = f'Wir warten auf deine Antwort zu Ticket "{subject}" (#{ticket_id}).'

    requests.post(
        "https://api.textmeflow.eu/v1/messages",
        headers={"Authorization": f'Bearer {os.environ["TEXTMEFLOW_TOKEN"]}'},
        json={"to": phone, "text": text},
    )
    return "", 200

Dieselbe Anfrage funktioniert aus PHP oder Node mit jedem HTTP-Client – siehe die PHP-, Python- und Node-Beispiele, falls Python nicht dein Stack ist.

Schritt 4: Die Telefonnummer zuerst normalisieren

Freshdesk erzwingt im Kontaktdatensatz kein Telefonformat, daher kann mobile 0470 12 34 56, +32470123456 oder einfach leer sein. Die API von TextMeFlow verlangt strikt E.164 und lehnt alles andere mit 400 invalid_recipient ab. Schicke die Nummer vor dem Senden durch einen Normalisierer und überspringe den Versand – rate keine Ländervorwahl –, wenn das Feld leer ist oder offensichtlich keine Telefonnummer enthält. Die Anleitung zur Validierung von Telefonnummern behandelt den Normalisierungsschritt ausführlicher.

Schritt 5: Nicht bei jeder Antwort eine Nachricht senden

Ein Ticket mit langem Hin und Her kann die Bedingung „Status ändert sich" mehrmals pro Stunde auslösen, wenn ein Agent es beim Troubleshooting zwischen Open und Pending umschaltet. Fasse die Regel eng – gelöst oder wirklich wartend auf den Kunden – statt auf jeden Statuswechsel zu reagieren. Die Anti-Spam-Pipeline von TextMeFlow drosselt eine Nummer, die Schübe automatisiert wirkender Nachrichten sendet. Das schützt deine WhatsApp-Nummer, bedeutet aber auch, dass bei einer zu gesprächigen Regel ein Teil der Nachrichten verzögert statt sofort zugestellt wird.

Auch Benachrichtigungen für Agenten

Dieselbe Regelstruktur funktioniert für interne Benachrichtigungen: eine Bedingung auf „SLA läuft in 30 Minuten ab" oder „Ticket mir zugewiesen", die an die eigene WhatsApp-Nummer des Agenten schreibt statt an die des Anfragenden. Dieser Verkehr ist eins zu eins und intern, ohne Einwilligungsfrage – damit ist er eine sichere erste Integration, um deinen Empfänger zu testen, bevor du den Webhook auf Kundennummern richtest.

Starte kostenlos mit TextMeFlow – 50 Nachrichten pro Monat, ohne Zeitlimit, genug, um eine Freshdesk-Automatisierung komplett einzurichten, bevor du dich für einen bezahlten Tarif entscheidest.

Selbst WhatsApp-Nachrichten per API senden?

Für immer gratis bis 50 Nachrichten/Monat. QR scannen und in 5 Minuten die erste Nachricht senden.

Für immer gratis