Erstellen einer Slack Reviews-App

In diesem Artikel erfahren Sie, wie Sie eine App erstellen, die jedes Mal, wenn Ihr Konto eine neue Bewertung erhält, eine Slack-Benachrichtigung sendet. Die Einrichtung umfasst drei Teile: das Erstellen der Slack-App, das Hochladen eines Plugins in Ihrem Yext-Konto und das Erstellen einer Yext-App, die die beiden verbindet.

Anforderungen

• Ein Slack-Workspace, in dem Sie die Berechtigung zum Erstellen von Apps haben oder die Genehmigung Ihres Slack-Administrators
• Ein Yext-Konto mit Zugriff auf Kontofunktionen und die Entwicklerkonsole

Schritt 1: Erstellen Sie eine Slack-App

1. Erstellen oder identifizieren Sie den Slack-Kanal, in dem Benachrichtigungen über Bewertungen angezeigt werden sollen.
2. Öffnen Sie api.slack.com/apps und klicken Sie auf Neue App erstellen.
3. Wählen Sie Von vorne, geben Sie einen App-Namen ein und wählen Sie Ihren Arbeitsbereich aus.
4. Klicken Sie unter Funktionen hinzufügen auf Eingehende Webhooks.
5. Aktivieren Sie die Funktion.
6. Klicken Sie auf Hinzufügen eines neuen Webhooks anfragen und fügen Sie eine Nachricht an Ihren Slack-Administrator hinzu, in der Sie erklären, was der Webhook bewirken wird.
7. Nachdem Ihr Administrator die Anfrage genehmigt hat, kehren Sie zu api.slack.com/apps zurück. Wählen Sie Ihre App aus und kehren Sie zu Eingehende Webhooks zurück.
8. Klicken Sie auf Neuen Webhook zum Workspace hinzufügen, wählen Sie den Kanal für Bewertungsbenachrichtigungen aus und klicken Sie auf Zulassen.
9. Kopieren Sie die Webhook-URL am Ende der Seite. Sie werden sie in Schritt 2 brauchen.

Schritt 2: Laden Sie das Publisher-Plugin hoch

1. Navigieren Sie zu Kontoeinstellungen > Kontofunktionen und aktivieren Sie Sommer 2023: Auslösen von serverlosen Funktionen in Apps (frühzeitiger Zugang). Klicken Sie auf Speichern.
2. Öffnen Sie diesen Link, um die Slack-Funktion auf Ihr Konto anzuwenden.
3. Klicken Sie oben rechts auf Anwenden.
4. Geben Sie Ihre Konto-ID ein und klicken Sie auf Weiter.
5. Geben Sie die Webhook-URL, die Sie in Schritt 1 kopiert haben, und Ihre Konto-ID ein.
6. Klicken Sie auf Speichern, dann auf Weiter und schließlich auf Bestätigen.

Um zu überprüfen, ob das Hochladen erfolgreich war, navigieren Sie zu Entwickler > Administratorkonsole und bestätigen Sie, dass Sie Dateien unter dem Pfad „Plattform > Plugin > slackReviewsPublisher“ sehen können.

Schritt 3: Erstellen Sie eine Yext-App

1. Navigieren Sie zu Entwickler > Entwicklerkonsole.
2. Klicken Sie auf App hinzufügen, geben Sie einen Namen wie „Slack Reviews Publisher“ ein und klicken Sie auf App erstellen.
3. Klicken Sie unter dem Tab API-Zugangsdaten auf Eine neue API-Berechtigung hinzufügen. Wählen Sie Management-API > Bewertungen mit der Berechtigung Schreibgeschützt und klicken Sie auf Speichern.
4. Klicken Sie unter dem Tab Webhooks auf Webhook hinzufügen.
5. Wählen Sie Bewertungen als Webhook-Typ aus und klicken Sie auf Weiter.
6. Geben Sie einen Namen für den Webhook ein, beispielsweise „Slack-Bewertungsbenachrichtigung“.
7. Klicken Sie unter URL auf Aufrufen einer Funktion. Wählen Sie slackReviewsPublisher und anschließend die Funktion handleNotification aus.
8. Klicken Sie auf Abschließen und hinzufügen.

Ihr Slack-Kanal erhält nun jedes Mal eine Benachrichtigung, wenn Ihr Konto eine neue Bewertung erhält.