Zum Hauptinhalt springen

Integrationsleitfaden: Zendesk

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

Heute aktualisiert

Installation & Einrichtung

App installieren

  1. Gehen Sie zur ClickSend Telekommunikationsdienst-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 Telekommunikationsdienst.

  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 Telekommunikationsdienst-Verlauf gefüllt.


Versand von Telekommunikationsdiensten aus Zendesk

Es gibt drei Möglichkeiten, einen Telekommunikationsdienst 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 Telekommunikationsdienste oder nutzen Sie den SMS-Massenversand an Gruppen oder Organisationen.

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


E-Mails empfangen: Eingehender Telekommunikationsdienst

  • 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.


Automatisierter Telekommunikationsdienst via Webhook + Auslöser

Verwenden Sie Zendesk-Auslöser, um den Telekommunikationsdienst automatisch zu versenden, wenn Ticket-Aktualisierungen auftreten.

Einen Webhook erstellen

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

  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 Auslöser hinzufügen

  1. Gehen Sie zu Auslöser > Auslöser 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 Zustellung des Telekommunikationsdienstes verfolgen?

Ja, der Status des Telekommunikationsdienstes 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.

  • Eingehender Telekommunikationsdienst funktioniert nicht?

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

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

  • Kontoguthaben

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

  • Globaler Versand

    • Aktivieren Sie den globalen Versand für Ihre Zielländer. Support kontaktieren 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?