Soluzione ai problemi relativi ai webhook in Workspace Studio

Hai creato un flusso in Google Workspace Studio, hai aggiunto il passaggio Invia un webhook E la richiesta non raggiunge mai la sua destinazione. Oppure forse il flusso funzionava e ora si verifica un errore. Prima di modificare l'URL alla cieca, vale la pena indagare. A che punto si interrompe l'esecuzione?: accesso alla fase, un'approvazione in sospeso, la configurazione della richiesta o la risposta dal servizio esterno.

Workspace Studio utilizza questo passaggio per inviare un Richiesta HTTP a un indirizzo specificoQuesto può essere utilizzato per notificare uno strumento interno, creare un record in un'altra applicazione o inviare dati a un servizio che non dispone di un connettore diretto. La soluzione dipende dal fatto che il blocco si verifichi all'interno di Google Workspace o sul server che riceve la richiesta.

Verifica se l'amministratore ha abilitato i webhook

Si Invia un webhook Non compare tra i passaggi disponibili; inizia con le autorizzazioni dell'organizzazione. Google indica che questa funzionalità è... disabilitato per impostazione predefinita e che un amministratore deve abilitarlo per l'unità organizzativa pertinente. Il percorso è Console di amministrazione > App > Google Workspace > Workspace Studio > Impostazioni Webhook.

Verifica inoltre che il tuo account abbia accesso alla funzionalità: Google continua a identificare il passaggio di webhook come una funzionalità in anteprima limitataSe non sei un amministratore, comunica all'amministratore dello spazio di lavoro il nome del passaggio mancante, il tuo account e l'unità organizzativa a cui appartieni. Questo gli permetterà di verificare le impostazioni applicabili senza influire sulle autorizzazioni degli altri team.

Esamina l'elenco degli URL consentiti e le relative autorizzazioni.

In alcune edizioni, l'amministratore può limitare le destinazioni esterne utilizzando un Elenco dei domini e degli URL consentitiSe il passaggio esiste ma non riesci a connetterti a un endpoint specifico, verifica che il tuo dominio o URL sia presente nell'elenco. Questa impostazione viene gestita dalle opzioni di importazione e recupero URL di Drive e Documenti.

Questa restrizione Non funziona allo stesso modo in tutte le edizioniLa lista di indirizzi consentiti per i webhook è disponibile nelle edizioni Business Plus, Enterprise Standard e Plus, ed Education Standard e Plus. Nelle edizioni che non offrono questo controllo, l'abilitazione dei webhook consente le connessioni a URL validi senza applicare la lista di indirizzi consentiti. Pertanto, si consiglia di verificare prima la propria edizione e le policy dell'organizzazione.

Il flusso potrebbe anche essere in attesa di un approvazione dell'utenteGoogle considera l'invio di dati a un endpoint esterno come un'azione sensibile e richiede, per impostazione predefinita, una revisione e una conferma. Se l'automazione sembra bloccata, apri Studio e verifica la presenza di richieste di approvazione in sospeso prima di concludere che il server non ha funzionato.

Configura correttamente l'URL, il metodo e i dati inviati.

Apri il flusso in studio.workspace.google.com e selezionare il passaggio Invia un webhook. L'indirizzo dovrebbe essere completo e staticoIl campo accetta un URL che inizia con http:// o https://ma non consente di inserire variabili direttamente nell'URL. HTTPS è l'opzione consigliata per evitare di inviare informazioni non crittografate; non è un requisito del settore.

• Metodo HTTP: Seleziona il metodo previsto dall'API di destinazione. Studio offre i metodi GET, POST, PUT, PATCH e DELETE; POST è quello predefinito.
• Corpo della richiesta: È facoltativo e viene inviato come testo. Per molte API, è consigliabile utilizzare JSON, rispettando le virgolette, le parentesi graffe e i nomi dei campi richiesti dal servizio.
• Variabili: È possibile includere i dati dei passaggi precedenti nel corpo. Verificare il risultato quando una variabile contiene virgolette, interruzioni di riga o altri caratteri che potrebbero invalidare il formato JSON.
• Richieste GET: Studio ignora il corpo della richiesta con questo metodo. Se il servizio richiede dati nel corpo, verifica quale metodo è supportato dalla relativa documentazione.

Fare un esecuzione del test Ricorda che invierà una vera e propria richiesta alla destinazione. Se l'operazione ha esito positivo, la risposta sarà disponibile come variabile di testo per un utilizzo successivo nello stesso flusso.

Utilizza la scheda Attività per individuare il problema

Dopo ogni esecuzione, apri Attività in Workspace Studio. Se la richiesta è andata a buon fine, è possibile rivedere i dati inviati e la risposta ricevuta. In caso di errore, Studio visualizza il codice di errore e URL di destinazione della rispostaQueste informazioni ci permettono di distinguere tra un problema di configurazione nel flusso e un rifiuto causato dal servizio esterno.

Un 400 Ciò di solito indica che il destinatario non accetta la richiesta così come è scritta; ne rivede il metodo e il corpo. In caso di 401 o 403Verifica i requisiti di accesso al servizio e le restrizioni imposte dalla tua organizzazione. 404 Ti chiede di verificare il percorso dell'endpoint. Se un 429Verifica i limiti delle tue richieste; errori 5xx Solitamente indicano un problema con il servizio ricevente. La risposta specifica dall'endpoint è più utile che interpretare il numero isolatamente.

Gli amministratori possono anche consultare il Registri eventi di Workspace Studio per esaminare le richieste webhook. L'accesso a determinati dati, come l'URL richiesto, è limitato perché potrebbero contenere informazioni sensibili.

Non confondere il webhook di Studio con un webhook in entrata di Google Chat.

Il passo Invia un webhook Workspace Studio effettua una richiesta a un URL esterno. webhook in entrata di Google ChatAl contrario, si tratta di un URL creato all'interno di uno spazio affinché un altro sistema possa pubblicare messaggi. Sono elementi separati, anche se è possibile utilizzare l'URL della chat come destinazione per un flusso di Studio.

Se il tuo obiettivo è pubblicare un annuncio su Google Chat, verifica innanzitutto se il passaggio 1 è sufficiente. Pubblicare in uno spazio da Studio. Se devi utilizzare un webhook in entrata, devi crearlo da App e integrazioni dello spazio e mantenerne privato l'URL, che include una chiave e un token. Questi webhook vengono utilizzati per inviare messaggi allo spazio, ma non consentono conversazioni con gli utenti.

Google Chat applica una quota condivisa ai webhook in entrata. una richiesta al secondo e per spazioQuesto limite si applica alla chat; non è un limite generale per la fase "Invia un webhook" in Workspace Studio. Se l'errore si verifica quando si pubblicano molti annunci consecutivamente nello stesso spazio, verificare questa quota insieme alla risposta alla richiesta.

Se gli errori sono intermittenti, verificare le quote di flusso.

Workspace Studio consente di creare fino a 25 flussi per utente, con un massimo di 20 passaggi per flussoInoltre, impone un limite complessivo al numero di esecuzioni durante ogni periodo di 24 ore. Se si raggiunge questo limite, le esecuzioni successive falliranno fino al ripristino del contatore.

Quando il webhook fallisce solo dopo molte attivazioni, controlla Attività Verifica sia i limiti di Studio che quelli del servizio di destinazione. Affinare il trigger, ad esempio limitandolo a mittenti o eventi specifici, può prevenire richieste non necessarie. Se l'errore si verifica al primo avvio, inizia controllando le autorizzazioni, le approvazioni in sospeso e la risposta dell'endpoint.