Utilizzo del webhook in uscita con Zoom

Per utilizzare la funzione di chat di Zoom, devi configurare un’app di chat chiamata In uscita Webhook che consente di inviare informazioni e ricevere notifiche agli endpoint specificati.

Prerequisiti per utilizzando In uscita Webhook

• Dovresti avere familiarità con il processo di invio di richieste HTTP POST utilizzando un token e un endpoint

• In Zoom App Marketplace, la chat Webhook in uscita è stata pre-approvata per l’inclusione
  Nota: Il tuo amministratore Zoom sarà in grado di assisterti se l’app non è stata pre-approvata.

Come installare Webhook in uscita dal Marketplace delle app Zoom

1. Accedi con il tuo account Zoom per accedere a Zoom App Marketplace.

2. Cerca Webhook in uscita nella casella di ricerca in alto a destra dello schermo per individuare l’app sul tuo dispositivo.

3. Trova l’app Webhook in uscita nei risultati della ricerca e fai clic su di essa per aprirla.

4. Aggiungi l’articolo al carrello.

5. Fai clic su Autorizza dopo aver verificato che l’app necessita delle autorizzazioni necessarie.
   L’app Zoom Chat ti avviserà una volta completato il processo inviandoti una notifica.
   Nota: il client desktop Zoom installerà automaticamente l’app di chat Webhook in uscita per te se l’ha installata l’amministratore In il server Zoom.

Come utilizzare l’app Webhook in uscita

Configura l’app Webhook in uscita

1. È possibile accedere al client desktop di Zoom effettuando l’accesso.

2. Troverai la scheda Chat sul lato sinistro dello schermo.

3. Situato sotto BOTS sul lato sinistro della pagina, troverai il chatbot che gestisce i webhook in entrata.
   È anche possibile accedere al canale di chat di tua scelta.

4. Invia un messaggio digitando connect e inviandolo. Se sei passato a un canale diverso da In uscita, dovrai digitare il comando /trigger connect se sei passato a un altro canale.
   Verrà visualizzato un messaggio di successo della connessione inviato dall’app di chat e ti verrà fornito un collegamento per configurare il webhook.

5. Il link è reperibile cliccando qui.
   All’apertura della pagina Web, ti verranno presentate una serie di impostazioni che possono essere modificate:

   • Nome canale: il canale in cui avvierai il comando “connetti” sarà questo.

   • Trigger Word(s): Seleziona i comandi che desideri che i tuoi endpoint ricevano dalla riga di comando. Ad esempio: il payload è impostato per inviarti un messaggio che dice “trigger Fare create ticket” che contiene la parola “create ticket”.

   • URL(s): per riceverli dovrai inserire i comandi della tua parola chiave (uno per riga).

   • Token: ci sarà un token incorporato nel payload del tuo endpoint che verrà inviato da Zoom. Per verificare se la richiesta ha avuto origine dalla tua chat Zoom, puoi utilizzare questo metodo.

   • URL di richiamata: in questo scenario, i trigger verranno rispediti al canale di chat Zoom per rispondere a loro. Il token insieme a questo deve essere utilizzato insieme l’uno con l’altro

6. Per favore clicca sul Pulsante Salva.

Invia messaggi personalizzati a Zoom Chat

Se il tuo sistema viene attivato, invierà un messaggio formattato all’utente tramite la chat di Zoom in risposta al trigger. Un messaggio nell’app di chat può essere di nove tipi, tra cui un messaggio, un’azione, un campo, una selezione, un allegato o una sezione.

Oltre a scegliere il tipo di messaggio che desideri inviare, puoi anche specificare lo stile e la funzionalità del tuo messaggio. Ti invitiamo a leggere il nostro articolo sulla personalizzazione dei messaggi sul Marketplace per ulteriori informazioni.

Comandi disponibili

Elenca tutti i comandi disponibili

Un elenco di comandi è disponibile digitando help nel canale chat Webhook in uscita 1:1 o digitando /trigger help nel canale Zoom Chat.

Nuovo Connessione

Se preferisci utilizzare Zoom Chat, digita /trigger connect nel gruppo Zoom Chat desiderato per generare una nuova connessione tramite il canale di chat Webhook in uscita 1:1 o /connection nel gruppo Zoom Chat desiderato. Creare la configurazione facendo clic sul collegamento.

Visualizzazione Configurazioni

Configure (all) è il comando da digitare nel canale chat 1:1 Outgoing Webhook oppure /trigger configure (all) da digitare nel canale Zoom Chat se si desidera ricevere un elenco delle proprie configurazioni insieme al link da modificare ognuno.

Fare Comando

Nel canale di chat Webhook in uscita 1:1, puoi digitare do + (le parole trigger configurate) + (Maiusc+Invio) + (il testo desiderato) o /trigger do + (le parole trigger configurate) + (Maiusc+Invio) + (Il tuo testo desiderato) per inviare un messaggio e avere il payload inviato agli URL configurati digitando do + (le parole trigger configurate) + (Maiusc+Invio) + (il testo desiderato). I dati verranno inviati dall’applicazione di chat.

Disconnetti

Nel canale chat Webhook in uscita 1:1, digitare disconnect o /trigger disconnect nel canale Zoom Chat che si desidera rimuovere abbonamento To rimuovere l’abbonamento per il canale di chat corrente nel canale di chat Webhook in uscita 1:1. Per confermare, fare clic sul pulsante OK.

Disconnettere tutti gli abbonamenti

Per rimuovere l’iscrizione per il canale di chat corrente, digita /trigger disconnettere tutto nel canale Zoom Chat desiderato o /trigger disconnettere tutto nel canale di chat Webhook in uscita 1:1 per annullare l’iscrizione a quel canale. Per confermare, fare clic sul pulsante OK.

Come disinstallare l’app di chat Webhook in uscita

1. È possibile accedere a Zoom Marketplace dopo aver effettuato l’accesso al proprio account Zoom.

2. Nei risultati di ricerca per Webhook in uscita, seleziona l’app e fai clic su di essa, oppure in loroNella sezione Age dell’elenco delle app, fare clic sul collegamento Aggiungi app all’interno dell’app.

3. Nella sezione Webhook in uscita, fai clic sul pulsante Rimuovi.

4. Fare clic sul pulsante Rimuovi dopo aver confermato la finestra di dialogo.

Il team di supporto di Zoom è disponibile per fornire ulteriore assistenza se necessario.