Zum Hauptinhalt springen

Integrationsleitfaden: Zendesk

Dieser Leitfaden behandelt Einrichtung, Versandoptionen, eingehende Nachrichten und Fehlerbehebung.

Installation & Einrichtung

App installieren

  1. Gehen Sie zur ClickSend SMS-App im Zendesk Marketplace.

  2. Klicken Sie auf Installieren und wählen Sie dann Ihr Zendesk-Konto aus.

  3. Klicken Sie zur Bestätigung erneut auf Installieren.

Mit ClickSend authentifizieren

  1. Gehen Sie in Zendesk zu Admin Center > Apps und Integrationen > ClickSend SMS.

  2. Geben Sie Ihren ClickSend-Benutzernamen und API-Schlüssel ein (hier zu finden).

  3. Klicken Sie auf Mit ClickSend verbinden.

  4. Sobald eine Verbindung besteht, wird Ihr SMS-Verlauf gefüllt.


Versand von SMS aus Zendesk

Es gibt drei Möglichkeiten, SMS in Zendesk zu versenden:

1. Obere Leiste (Schnell-SMS – Empfohlen)

  • Von jeder Seite in Zendesk zugänglich.

  • Ideal für schnelle, personalisierte Nachrichten an Kontakte.

2. Ticket-Seitenleiste

  • Verwenden Sie dies, wenn Sie an einem Ticket mit einer gespeicherten Telefonnummer arbeiten.

  • Ideal für Kundenservice-Antworten innerhalb von Konversationen.

3. Navigationsleiste (Massen-Messaging)

  • Versenden Sie individuelle oder Massen-SMS an Gruppen oder Organisationen.

  • Hervorragend geeignet für Ankündigungen, Werbeaktionen oder Warnungen.


Eingehende SMS empfangen

  • Antworten erscheinen in Echtzeit auf Ihrem Zendesk-Dashboard.

  • Ungelesene Nachrichten zeigen einen roten Punktindikator.

  • Hinweis: Zendesk zeigt möglicherweise keine Antworten an, wenn Ihr ClickSend-Konto mehr als 10 eingehende Regeln hat. Erfahren Sie mehr über eingehende Regeln.

Tipp: Überprüfen Sie regelmäßig Ihr Dashboard, um zeitnahe Antworten sicherzustellen.


Automatisierte SMS via Webhook + Trigger

Verwenden Sie Zendesk-Trigger, um SMS automatisch zu versenden, wenn Ticket-Aktualisierungen auftreten.

Einen Webhook erstellen

  1. Gehen Sie zu Admin Center > Apps und Integrationen > Webhooks.

  2. Klicken Sie auf Webhook erstellen.

  3. Verwenden Sie die folgenden Einstellungen:

    1. Methode: POST

    2. Format: JSON

    3. Authentifizierung: Basic Auth (ClickSend-Benutzername + API-Schlüssel)

Einen Trigger hinzufügen

  1. Gehen Sie zu Trigger > Trigger hinzufügen.

  2. Wählen Sie eine Kategorie (z. B. Tickets).

  3. Fügen Sie eine Aktion hinzu:

    • Aktiven Webhook benachrichtigen → wählen Sie Ihren ClickSend-Webhook aus.

  4. Fügen Sie dies zum JSON-Body hinzu:

Basic:

{
"messages": [
{
"to": "+61411111111",
"source": "zendesk",
"body": "this is a test message"
}
]
}

Dynamisches Beispiel:

{
"messages": [
{
"to": "{{current_user.phone}}",
"source": "zendesk",
"body": "Hi {{current_user.first_name}}, the {{ticket.brand.name}} status has been changed to {{ticket.status}}."
}
]
}


FAQs

Wie authentifiziere ich mich?

Verwenden Sie Ihren ClickSend-Benutzernamen und API-Schlüssel (nicht Ihr Passwort).

Kann ich die SMS-Zustellung verfolgen?

Ja, der SMS-Status kann über die obere Leiste, Seitenleiste und Navigationsleiste verfolgt werden.

Kann ich Massennachrichten versenden?

Ja, verwenden Sie die Navigationsleiste und wählen Sie eine Gruppe oder Organisation aus.

Funktionieren Antworten mit allen Absendertypen?

Antworten funktionieren mit geteilten oder dedizierten Nummern. Wird nicht mit Alpha-Tags oder Ihrer eigenen Nummer unterstützt.

Kann ich eine Alpha-Tag-Absender-ID verwenden?

Ja, in unterstützten Ländern. Limit: 11 Zeichen, keine Leerzeichen.

Fügen Sie das from-Feld in Ihrem JSON-Body hinzu:

{
"messages": [
{
"to": "+61411111111",
"from": "MyCompany",
"body": "this is a test message"
}
]
}


Fehlerbehebung

  • Authentifizierung

    • Stellen Sie sicher, dass Sie Ihren ClickSend-Benutzernamen und API-Schlüssel verwenden, nicht Ihr Passwort.

  • Eingehende SMS funktioniert nicht?

    • Stellen Sie sicher, dass Sie eine dedizierte Nummer haben.

    • Beschränken Sie die Webhook-Regeln auf unter 10.

  • Konto-Credit

    • Stellen Sie sicher, dass Ihr ClickSend-Konto über ausreichend Credit verfügt. Laden Sie hier auf.

  • Globaler Versand

    • Aktivieren Sie den globalen Versand für Ihre Zielländer. Kontaktieren Sie den Support für Hilfe.

  • Formatierung der Telefonnummer

    • Verwenden Sie das internationale Format (z. B. +1XXXXXXXXXX für die USA).

  • Fehlende Nachrichtenfelder

    • Stellen Sie sicher, dass erforderliche Felder wie Empfängernummer und Nachrichten-Body ausgefüllt sind.

Hat dies deine Frage beantwortet?