Slack-Kanal

Mit dem Slack-Kanal konnen Ihre Mitarbeiter uber Slack mit Merlin chatten. Geben Sie @Merlin gefolgt von einer Frage in einem Slack-Kanal ein oder senden Sie eine DM, und Merlin antwortet mit Daten aus Ihren verbundenen Diensten.

Verfugbarkeit

Der Slack-Kanal ist ab dem Professional-Plan verfugbar.

So funktioniert es

1. Ein Mitarbeiter tippt @Merlin wie viele offene Rechnungen habe ich? in einem Slack-Kanal
2. Slack sendet die Nachricht an CallMerlin
3. Innerhalb von 5-15 Sekunden antwortet Merlin in einem Thread
4. Merlin hat Zugriff auf dieselben Tools wie bei Webchat, Telefon und Desktop

Voraussetzungen

• Ein Professional-Plan oder hoher
• Ein Slack-Workspace, in dem Sie Apps installieren konnen
• Workspace-Besitzer- oder Admin-Rechte in Slack

Einrichtung

Schritt 1: Slack App erstellen

1. Gehen Sie zu api.slack.com/apps und klicken Sie auf Create New App
2. Wahlen Sie From scratch
3. Benennen Sie die App (z.B. Merlin) und wahlen Sie Ihren Workspace
4. Gehen Sie zu OAuth & Permissions und fugen Sie diese Bot Token Scopes hinzu:
   • app_mentions:read
   • chat:write
   • im:read
   • im:write
   • im:history
   • channels:history
   • users:read
5. Klicken Sie auf Install to Workspace und autorisieren Sie die App
6. Kopieren Sie das Bot User OAuth Token (beginnt mit xoxb-)

Schritt 2: Event Subscriptions einrichten

1. Gehen Sie zu Event Subscriptions in Ihrer Slack App-Konfiguration
2. Schalten Sie Enable Events auf On
3. Fugen Sie die Request URL ein, die Sie im CallMerlin-Dashboard unter Slack-Kanal finden
4. Warten Sie, bis Slack die URL verifiziert (grunes Hakchen)
5. Fugen Sie diese Events unter Subscribe to bot events hinzu:
   • app_mention
   • message.im
6. Klicken Sie auf Save Changes

Schritt 3: Dashboard konfigurieren

1. Gehen Sie zu callmerlin.app → Dashboard → Slack-Kanal
2. Geben Sie das Bot Token ein (aus Schritt 1)
3. Geben Sie das Signing Secret ein (unter Basic Information → App Credentials)
4. Klicken Sie auf Verbindung testen
5. Wahlen Sie eine Standard-PIN (optional)
6. Schalten Sie den Toggle EIN
7. Klicken Sie auf Speichern

Schritt 4: Erste Nachricht senden

1. Gehen Sie zu Slack
2. Laden Sie den Bot in einen Kanal ein: /invite @Merlin
3. Tippen Sie @Merlin hallo
4. Merlin antwortet in einem Thread

Benutzerzuordnung

Jeder Slack-Benutzer wird mit einem PIN-Code verknupft. Die PIN bestimmt, welche Berechtigungen und welches Template Merlin verwendet.

Standard-PIN

Legen Sie eine Standard-PIN fur Slack-Benutzer fest, die noch nicht individuell zugeordnet sind.

Tipp: Erstellen Sie eine PIN mit eingeschrankten Leserechten als Standard.

Kanalfilter

Schranken Sie ein, in welchen Slack-Kanalen Merlin antwortet. Lassen Sie das Feld leer, um Merlin in allen Kanalen verfugbar zu machen.

Abrechnung

Slack-Nachrichten werden als Chatsitzungen abgerechnet:

• Erste Nachricht = 0,5 Minuten
• Folgefragen innerhalb von 15 Minuten = kostenlos (gleiche Sitzung)
• Nach 15 Minuten = neue Sitzung von 0,5 Minuten

Limits

Fehlerbehebung

Merlin antwortet nicht

1. Prufen Sie, ob der Toggle EIN ist
2. Prufen Sie das Bot Token und Signing Secret
3. Prufen Sie, ob Event Subscriptions aktiv sind
4. Prufen Sie, ob Merlin im Kanal eingeladen ist (/invite @Merlin)
5. Prufen Sie, ob der Benutzer eine PIN hat