De inkomende webhook-chatbot van Zoom gebruiken

Met de Incoming Webhook-app is het mogelijk om vanaf elk Zoom-chatkanaal rechtstreeks berichten te sturen naar een externe dienst, zoals Amazon CloudWatch. Met de chat-app kunt u een uniek eindpunt genereren, samen met een verificatietoken, in elk kanaal dat u kiest. Met deze inloggegevens kunt u met deze inloggegevens berichten via HTTP POST-verzoeken naar een Zoom-chatkanaal sturen.

Vereisten voor inkomende webhook

• Eigendom of beheerdersrechten voor een account

• Accounttype: Professioneel, Zakelijk, Educatief of Enterprise

• De mogelijkheid om HTTP POST-verzoeken te verzenden met behulp van een token en een eindpunt dat bekend is met HTTP POST

• Zoom App Marketplace heeft de Incoming Webhook-chatbot vooraf goedgekeurd voor opname in zijn Marketplace
  Opmerking: U moet contact opnemen met uw Zoom-beheerder als de app niet vooraf is goedgekeurd.

Inkomende webhook toevoegen en configureren

Toevoegen vanuit de Zoom App Marketplace

Opmerking: De Incoming Webhook Chatbot moet worden toegevoegd en geconfigureerd op uw Zoom-account als u geen beheerdersrechten heeft

1. Zorg ervoor dat je bent ingelogd als beheerder van je Zoom-account in de Zoom App Marketplace.

2. De Incoming Webhook-app vind je in het zoekvak rechtsboven in je scherm. Voer gewoon de naam van de app in het vak in.

3. U vindt de Incoming Webhook-app in uw zoekresultaten. Klik op de app om deze te openen.
   Opmerking: Het wordt aanbevolen dat u contact opneemt met uw Zoom-beheerder als de app niet vooraf is goedgekeurd voor uw account om deze te laten goedkeuren.

4. Klik op de knop Toevoegen.

5. Wanneer u hebt bevestigd dat de app de gewenste machtigingen nodig heeft, klikt u op Autoriseren.
   Ik heb nu een app voor inkomende webhooks aan de winkel toegevoegd.

Configureer de inkomende webhook-chatbot

1. De desktopclient van Zoom is toegankelijk door in te loggen.

2. U vindt het tabblad Chatten aan de linkerkant van het scherm.

3. U kunt Inkomende Webhooks vinden onder de sectie BOTS.
   Ook als je berichten wilt ontvangen in een specifiek chatkanaal, kun je naar dat kanaal gaan.

4. To connect to the connection, type /inc connect connectionName>.
   Als gevolg van deze actie wordt u verbonden en ontvangt u een 1:1 chatbericht met daarin de volgende gegevens:

   • Eindpunt

   • Verificatietoken

   • Voorbeeld Krul aanvragen.

5. Met deze informatie kunt u een POST-verzoek naar de server sturen.
   Opmerking: Om de Incoming Webhook-chatbot berichten te laten sturen naar elk kanaal dat u kiest, moet u deze stappen volgen voor elk kanaal dat u kiest.

Berichten verzenden naar Zoom-chat

Om POST-verzoeken naar het eindpunt van de integratie te kunnen sturen nadat u uw verbinding heeft gemaakt, moet u eerst uw verbinding maken. De autorisatieheader moet het verificatietoken bevatten, als u dit hebt geconfigureerd om het op te nemen.
Opmerking: Een POST-verzoek is het enige type verzoek dat door het eindpunt wordt geaccepteerd.

Het wordt aanbevolen om een ​​git-bash uit te voeren (of een equivalent dat cURL-opdrachten kan uitvoeren) om uw verbinding in de terminal te testen. De inkomende webhook-chatbot stuurt je de cURL-verzoek op basis van de voorbeeld-cURL in het eerste 1:1-chatbericht. U kunt de voorbeeld-cURL kopiëren en in uw cURL-verzoek plakken. In het opgegeven kanaal zou je een testbericht moeten zien dat wordt verzonden zodra je het hebt verzonden. Een HTTP 200 OK-antwoord geeft aan dat de test is geslaagd.

Het type bericht en de complexiteit van het bericht kan worden ingesteld in de Incoming Webhook Chatbot door te kiezen uit de vier onderstaande opties:

• Eenvoudig formaat: Het ikis belangrijknt om te weten dat u met dit formaat platte tekst kunt verzenden die afkomstig is van een verbinding die is gemaakt. Het eindpunt kan zonder parameters worden gebruikt als u deze opmaak wilt gebruiken. De hoofdtekst van uw bericht moet een tekenreeks bevatten die de inhoud bevat die u wilt verzenden.

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

• Velden formaat: Het veldformaat van dit formaat maakt eenvoudige opmaak in velden mogelijk. Uw bericht kan bijvoorbeeld worden opgemaakt in een lijst met velden die u kunt invullen. Het is noodzakelijk om velden toe te voegen als formaat in de queryparameter (?format=fields) om deze opmaak te laten werken.

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

• Lijst formaat: Met dit formaat kunt u een eenvoudig opgemaakte lijst met items verzenden. Een lijst kan worden gebruikt om uw bericht op te maken, bijvoorbeeld als u het in dit formaat wilt weergeven. Om deze opmaak te gebruiken, moet de queryparameter worden ingesteld op lijst (?format=lijst). gebruik dit formaat.

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

• Volledig formaat: Met behulp van dit formaat kan ook rijke berichtopmaak worden gegenereerd en verzonden binnen Zoom Chat-berichten. Door dergelijke opmaak te gebruiken, kunt u uw chatbotberichten op verschillende manieren samenstellen, zoals het gebruik van kop- en subkopteksten, links, knoppen, vervolgkeuzemenu’s, bijlagen en meer. Als een manier om deze opmaak te gebruiken, voegt u de parameter ?format=full toe aan de queryparameter zodat full de indeling wordt. Raadpleeg het volgende document voor meer informatie over de ondersteunde JSON-objecten.

Hoe de inkomende webhook-chatbot te gebruiken

Beschikbare commando’s

• Aansluiten: To earn tokens and create a connection, you will need to type /inc connect connectionName> as the first step. Het token wordt vervolgens gebruikt om berichten rechtstreeks naar uw huidige chatkanaal te sturen. Er zijn zowel 1:1 directe berichten als kanalen die door deze chatbot kunnen worden gebruikt.

• Regenereren naarken: Zorg er voor aanvullende informatie voor dat u de verbindingsnaam kent die zal worden gebruikt om het verificatietoken te genereren.

• Loskoppelen: Wanneer u de optie /inc disconnect gebruikt, wilt u alle verbindingen verwijderen die aan de opgegeven naam zijn gekoppeld.

• Koppel alles los: De inkomende webhook-chatbot kan worden verwijderd door het commando /inc disconnect all te gebruiken om alle verbindingen te verwijderen.

• Configureren: Typ /inc configure in de terminal voor een lijst met verbindingen voor het huidige chatkanaal.

• Alles configureren: Typ /inc configure all voor een lijst met alle verbindingen voor elk kanaal.

Hoe de inkomende webhook-chatbot te verwijderen

1. Zorg ervoor dat je bent ingelogd als beheerder van je Zoom-account in de Zoom App Marketplace.

2. Om uw account te beheren, klikt u op de knop Beheren in de rechterbovenhoek van uw scherm.

3. Selecteer de optie Apps toevoegen in het navigatiemenu bovenaan de pagina.

4. Als u rechts van de Incoming WebHook-app op Verwijderen klikt, wordt de app verwijderd.

5. Klik op de knop Verwijderen nadat u de dialoog.
   Opmerking: Als onderdeel van deze stap worden alle actieve verbindingen in Zoom Chat wordt ook verwijderd.

Zoom Support kan u extra hulp bieden als u dat nodig heeft.