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
- Erstellen oder identifizieren Sie den Slack-Kanal, in dem Benachrichtigungen über Bewertungen angezeigt werden sollen.
- Öffnen Sie api.slack.com/apps und klicken Sie auf Neue App erstellen.
- Wählen Sie Von vorne, geben Sie einen App-Namen ein und wählen Sie Ihren Arbeitsbereich aus.
- Klicken Sie unter Funktionen hinzufügen auf Eingehende Webhooks.
- Aktivieren Sie die Funktion.
- 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.
- 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.
- Klicken Sie auf Neuen Webhook zum Workspace hinzufügen, wählen Sie den Kanal für Bewertungsbenachrichtigungen aus und klicken Sie auf Zulassen.
- Kopieren Sie die Webhook-URL am Ende der Seite. Sie werden sie in Schritt 2 brauchen.
Schritt 2: Laden Sie das Publisher-Plugin hoch
- Navigieren Sie zu Kontoeinstellungen > Kontofunktionen und aktivieren Sie Sommer 2023: Auslösen von serverlosen Funktionen in Apps (frühzeitiger Zugang). Klicken Sie auf Speichern.
- Öffnen Sie diesen Link, um die Slack-Funktion auf Ihr Konto anzuwenden.
- Klicken Sie oben rechts auf Anwenden.
- Geben Sie Ihre Konto-ID ein und klicken Sie auf Weiter.
- Geben Sie die Webhook-URL, die Sie in Schritt 1 kopiert haben, und Ihre Konto-ID ein.
- 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
- Navigieren Sie zu Entwickler > Entwicklerkonsole.
- Klicken Sie auf App hinzufügen, geben Sie einen Namen wie „Slack Reviews Publisher“ ein und klicken Sie auf App erstellen.
- 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.
- Klicken Sie unter dem Tab Webhooks auf Webhook hinzufügen.
- Wählen Sie Bewertungen als Webhook-Typ aus und klicken Sie auf Weiter.
- Geben Sie einen Namen für den Webhook ein, beispielsweise „Slack-Bewertungsbenachrichtigung“.
- Klicken Sie unter URL auf Aufrufen einer Funktion. Wählen Sie slackReviewsPublisher und anschließend die Funktion handleNotification aus.
- 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.