Verwendung des eingehenden Webhook-Chatbots von Zoom

Mit der Incoming Webhook-App ist es möglich, Nachrichten direkt von jedem Zoom-Chatkanal an einen externen Dienst wie Amazon CloudWatch zu senden. Mit der Chat-App können Sie einen eindeutigen Endpunkt zusammen mit einem Verifizierungstoken in jedem von Ihnen gewählten Kanal generieren. Mit diesen Anmeldeinformationen können Sie mit diesen Anmeldeinformationen Nachrichten über HTTP-POST-Anforderungen an einen Zoom-Chatkanal senden.

Voraussetzungen für eingehenden Webhook

• Eigentums- oder Administratorrechte für ein Konto

• Kontotyp: Professional, Business, Educational oder Enterprise

• Die Möglichkeit, HTTP-POST-Anforderungen mit einem Token und einem Endpunkt zu senden, der mit HTTP-POST vertraut ist

• Zoom App Marketplace hat den eingehenden Webhook-Chatbot für die Aufnahme in seinen Marktplatz vorab genehmigt
  Notiz: Sie müssen sich an Ihren Zoom-Administrator wenden, wenn die App nicht vorab genehmigt wurde.

So fügen Sie einen eingehenden Webhook hinzu und konfigurieren ihn

Aus dem Zoom App Marketplace hinzufügen

Notiz: Der eingehende Webhook-Chatbot muss Ihrem Zoom-Konto hinzugefügt und konfiguriert werden, wenn Sie keine Administratorrechte haben

1. Stellen Sie sicher, dass Sie als Administrator Ihres Zoom-Kontos im Zoom App Marketplace angemeldet sind.

2. Die Incoming Webhook-App finden Sie im Suchfeld oben rechts auf Ihrem Bildschirm. Geben Sie einfach den Namen der App in das Feld ein.

3. Sie finden die Incoming Webhook-App in Ihren Suchergebnissen. Klicken Sie auf die App, um sie zu öffnen.
   Notiz: Es wird empfohlen, dass Sie sich an Ihren Zoom-Administrator wenden, wenn die App in Ihrem Konto nicht vorab genehmigt wurde, um sie genehmigen zu lassen.

4. Bitte klicken Sie auf die Schaltfläche Hinzufügen.

5. Wenn Sie bestätigt haben, dass die App die gewünschten Berechtigungen erfordert, klicken Sie auf Autorisieren.
   Ich habe dem Store jetzt eine App für eingehende Webhooks hinzugefügt.

Konfigurieren Sie den eingehenden Webhook-Chatbot

1. Auf den Desktop-Client von Zoom können Sie zugreifen, indem Sie sich anmelden.

2. Sie finden den Chat-Tab auf der linken Seite des Bildschirms.

3. Sie finden eingehende Webhooks im Abschnitt BOTS.
   Wenn Sie Nachrichten in einem bestimmten Chat-Kanal erhalten möchten, können Sie auch zu diesem Kanal gehen.

4. Um eine Verbindung zur Verbindung herzustellen, type /Inc Connect ConnectionName>.
   Als Ergebnis dieser Aktion werden Sie verbunden und erhalten eine 1:1-Chat-Nachricht mit den folgenden Details:

   • Endpunkt

   • Bestätigungstoken

   • Beispiel cURL Anfragen.

5. Mit diesen Informationen können Sie eine POST-Anforderung an den Server senden.
   Notiz: Damit der eingehende Webhook-Chatbot Nachrichten an einen beliebigen Kanal Ihrer Wahl sendet, müssen Sie diese Schritte für jeden gewählten Kanal ausführen.

So senden Sie Nachrichten an den Zoom-Chat

Damit Sie POST-Anforderungen an den Endpunkt der Integration senden können, nachdem Sie Ihre Verbindung erstellt haben, müssen Sie zuerst Ihre Verbindung erstellen. Der Autorisierungsheader sollte das Überprüfungstoken enthalten, wenn Sie es so konfiguriert haben, dass es enthalten ist.
Notiz: Eine POST-Anforderung ist der einzige Anforderungstyp, der vom Endpunkt akzeptiert wird.

Es wird empfohlen, eine Git-Bash (oder ein Äquivalent, das cURL-Befehle ausführen kann) auszuführen, um Ihre Verbindung im Terminal zu testen. Der eingehende Webhook-Chatbot sendet Ihnen eine Nachricht Die cURL-Anforderung basierend auf der Beispiel-cURL in der anfänglichen 1:1-Chat-Nachricht. Sie können die Beispiel-cURL kopieren und in Ihre cURL-Anfrage einfügen. Im angegebenen Kanal sollten Sie sehen, dass eine Testnachricht gesendet wird, nachdem Sie sie gesendet haben. Eine HTTP 200 OK-Antwort zeigt an, dass der Test erfolgreich war.

Die Art der Nachricht und die Komplexität der Nachricht können im eingehenden Webhook-Chatbot festgelegt werden, indem Sie aus den folgenden vier Optionen auswählen:

• Einfaches Format: Es is wichtigSie sollten nicht wissen, dass Sie mit diesem Format Klartext senden können, der von einer erstellten Verbindung kommt. Der Endpunkt kann ohne Parameter verwendet werden, wenn Sie diese Formatierung verwenden möchten. Der Text Ihrer Nachricht sollte eine Zeichenfolge enthalten, die den Inhalt enthält, den Sie senden möchten.

POST <endpoint>
Authorization: <verificationToken>
Body: "This is a test message."

• Felder Format: Das Feldformat dieses Formats ermöglicht eine einfache Formatierung, die in Felder eingegeben werden kann. Ihre Nachricht kann beispielsweise in eine Liste von Feldern formatiert werden, die Sie ausfüllen können. Es ist notwendig, Felder als Format im Abfrageparameter (?format=fields) hinzuzufügen, damit diese Formatierung funktioniert.

POST <endpoint>?format=fields
Authorization: <verificationToken>
Content-Type: application/json
Body:
{
    "Field 1": "bar",
    "Field 2": "qux"
}

• Listenformat: Mit diesem Format können Sie eine einfache formatierte Liste von Artikeln senden. Eine Liste kann verwendet werden, um Ihre Nachricht beispielsweise zu formatieren, wenn Sie möchten, dass sie in diesem Format angezeigt wird. Um diese Formatierung zu verwenden, sollte der Abfrageparameter auf list (?format=list) gesetzt werden, um verwenden dieses Format.

POST <endpoint>?format=list
Authorization: <verificationToken>
Content-Type: application/json
Body:
{
    "Item 1": "Item 1",
    "Item 2": "Item 2"
}

• Vollständiges Format: Mit Hilfe dieses Formats können umfangreiche Nachrichtenformatierungen generiert und auch innerhalb von Zoom-Chat-Nachrichten gesendet werden. Die Verwendung einer solchen Formatierung ermöglicht es Ihnen, Ihre Chatbot-Nachrichten auf verschiedene Weise zu erstellen, z. B. die Verwendung von Kopfzeilen und Unterkopfzeilen, Links, Schaltflächen, Dropdowns, Anhängen und mehr. Um diese Formatierung zu nutzen, fügen Sie den Parameter ?format=full zum Abfrageparameter hinzu, sodass full das Format ist. Um mehr über die unterstützten JSON-Objekte zu erfahren, lesen Sie bitte das folgende Dokument.

So verwenden Sie den eingehenden Webhook-Chatbot

Verfügbare Befehle

• Verbinden: Um Token zu verdienen und eine Verbindung zu erstellen, müssen Sie als erster Schritt Connect ConnectionName> eingeben. Das Token wird dann verwendet, um Nachrichten direkt an Ihren aktuellen Chatkanal zu senden. Es gibt sowohl 1:1-Direktnachrichten als auch Kanäle, die von diesem Chatbot verwendet werden können.

• Regenerieren zuKen: Für weitere Informationen vergewissern Sie sich bitte, dass Sie den Verbindungsnamen kennen, der zum Generieren des Verifizierungstokens verwendet wird.

• Trennen: Wenn Sie die Trennoption /inc verwenden, möchten Sie alle Verbindungen entfernen, die dem angegebenen Namen zugeordnet sind.

• Alle trennen: Der Incoming Webhook Chatbot kann mit dem Befehl /inc disconnect all entfernt werden, um alle Verbindungen zu entfernen.

• Konfigurieren: Für eine Liste der Verbindungen für den aktuellen Chat-Kanal geben Sie /inc configure im Terminal ein.

• Alle konfigurieren: Für eine Liste aller Verbindungen für jeden Kanal geben Sie /inc configure all ein.

So entfernen Sie den eingehenden Webhook-Chatbot

1. Stellen Sie sicher, dass Sie als Administrator Ihres Zoom-Kontos im Zoom App Marketplace angemeldet sind.

2. Um Ihr Konto zu verwalten, klicken Sie auf die Schaltfläche Verwalten in der oberen rechten Ecke Ihres Bildschirms.

3. Wählen Sie im Navigationsmenü oben auf der Seite die Option Apps hinzufügen aus.

4. Wenn Sie rechts neben der eingehenden WebHook-App auf Entfernen klicken, wird die App entfernt.

5. Klicken Sie auf die Schaltfläche Entfernen, nachdem Sie dies bestätigt haben Dialog.
   Notiz: Als Teil dieses Schrittes alle aktiven Verbindungen In Zoom Chat wird ebenfalls entfernt.

Der Zoom-Support kann Ihnen bei Bedarf zusätzliche Hilfestellung leisten.