Soluție pentru erorile Webhook în Workspace Studio

Ai creat un flux în Google Workspace Studio, ai adăugat pasul Trimiteți un webhook Și cererea nu ajunge niciodată la destinație. Sau poate fluxul funcționa și acum apare o eroare. Înainte de a schimba orbește adresa URL, merită să investigăm. În ce moment se oprește execuția?: acces la pas, o aprobare în așteptare, configurația solicitării sau răspunsul de la serviciul extern.

Workspace Studio folosește acest pas pentru a trimite un Cerere HTTP către o adresă specificăAcest lucru poate fi folosit pentru a notifica un instrument intern, a crea o înregistrare într-o altă aplicație sau a trimite date către un serviciu care nu are un conector direct. Soluția depinde de faptul dacă blocajul apare în Google Workspace sau pe serverul care primește solicitarea.

Verificați dacă administratorul a activat webhook-urile

Si Trimiteți un webhook Nu apare printre pașii disponibili; începeți cu permisiunile organizației. Google indică faptul că această funcție este... dezactivat în mod implicit și că un administrator trebuie să îl activeze pentru unitatea organizațională relevantă. Calea este Consola de administrare > Aplicații > Google Workspace > Workspace Studio > Setări Webhook.

De asemenea, verificați dacă aveți acces la contul dvs. la funcție: Google continuă să identifice transmiterea webhook-urilor ca o funcție în previzualizare limitatăDacă nu ești administrator, furnizează administratorului spațiului de lucru numele pasului lipsă, contul tău și unitatea organizațională din care faci parte. Acest lucru îi va permite să verifice setările aplicabile fără a afecta permisiunile altor echipe.

Examinați lista de adrese URL permise și aprobări

În unele ediții, administratorul poate limita destinațiile externe utilizând un listă de domenii și adrese URL permiseDacă pasul există, dar nu vă puteți conecta la un anumit punct final, confirmați că domeniul sau adresa URL se află pe lista respectivă. Această setare este gestionată din opțiunile de import și recuperare a adreselor URL din Drive și Docs.

Această restricție Nu funcționează la fel în toate edițiileLista de acces permise pentru webhook-uri este disponibilă în ediții precum Business Plus, Enterprise Standard și Plus și Education Standard și Plus. În edițiile care nu oferă acest control, activarea webhook-urilor permite conexiuni la adrese URL valide fără a aplica această listă de acces permisă. Prin urmare, este recomandabil să verificați mai întâi ediția dvs. și politica organizației dvs.

Fluxul poate aștepta, de asemenea, o aprobarea utilizatoruluiGoogle tratează trimiterea datelor către un endpoint extern ca pe o acțiune sensibilă și necesită revizuire și confirmare în mod implicit. Dacă automatizarea pare să fie blocată, deschideți Studio și verificați dacă există solicitări de aprobare în așteptare înainte de a concluziona că serverul a eșuat.

Configurați corect adresa URL, metoda și datele trimise.

Deschideți fluxul în studio.workspace.google.com și bifați pasul Trimiteți un webhook. Adresa ar trebui să fie complet și staticCâmpul acceptă o adresă URL care începe cu http:// o https://dar nu permite inserarea de variabile în URL-ul în sine. HTTPS este opțiunea recomandată pentru a evita trimiterea de informații necriptate; nu este o cerință a câmpului.

• Metoda HTTP: Selectați-o pe cea așteptată de API-ul țintă. Studio oferă GET, POST, PUT, PATCH și DELETE; POST este implicit.
• Corpul cererii: Este opțional și este trimis ca text. Pentru multe API-uri, este recomandabil să se utilizeze JSON, respectând ghilimelele, acoladele și numele câmpurilor cerute de serviciu.
• Variabile: Puteți include date din pașii anteriori în corp. Verificați rezultatul atunci când o variabilă conține ghilimele, sfârșituri de rând sau alte caractere care ar putea încălca formatul JSON.
• Cereri GET: Studio ignoră corpul cererii cu această metodă. Dacă serviciul necesită date în corp, verificați ce metodă este acceptată de documentația sa.

Faceți o execuția testului Și nu uitați că va trimite o cerere reală către destinație. Dacă pasul funcționează, răspunsul său devine disponibil ca variabilă text pentru utilizare ulterioară în același flux.

Folosește fila Activitate pentru a localiza problema

După fiecare execuție, deschideți Activitate în Workspace Studio. Dacă solicitarea a avut succes, puteți revizui datele trimise și răspunsul primit. Dacă a eșuat, Studio afișează cod de eroare și răspuns la adresa URL de destinațieAceste informații ne permit să distingem între o problemă de configurare în flux și o respingere cauzată de serviciul extern.

Un 400 De obicei, acest lucru indică faptul că destinatarul nu acceptă solicitarea așa cum este scrisă; acesta revizuiește metoda și corpul solicitării. În cazul unei 401 sau 403Verificați cerințele de acces ale serviciului și restricțiile organizației dvs. 404 Vă solicită să verificați ruta punctului final. Dacă un 429Verificați limitele solicitărilor; erori 5xx De obicei, acestea indică o problemă cu serviciul receptor. Răspunsul specific de la punctul final este mai util decât interpretarea numărului în mod izolat.

Administratorii pot consulta, de asemenea, Jurnalele de evenimente Workspace Studio pentru a investiga cererile de webhook. Accesul la anumite date, cum ar fi adresa URL solicitată, este restricționat deoarece acestea pot conține informații sensibile.

Nu confundați webhook-ul Studio cu un webhook Google Chat primit.

Pasul Trimiteți un webhook Workspace Studio face o solicitare către o adresă URL externă. webhook-ul Google Chat primitÎn schimb, este o adresă URL creată într-un spațiu pentru ca un alt sistem să posteze mesaje acolo. Sunt elemente separate, chiar dacă poți utiliza adresa URL de chat ca destinație pentru un flux Studio.

Dacă obiectivul tău este să postezi un anunț pe Google Chat, verifică mai întâi dacă pasul 1 este suficient. Publică într-un spațiu din Studio. Dacă trebuie să utilizați un webhook de intrare, trebuie să îl creați din Aplicații și integrări al spațiului și să păstreze adresa URL privată, care include o cheie și un token. Aceste webhook-uri sunt folosite pentru a trimite mesaje către spațiu, dar nu permit conversații cu utilizatorii.

Google Chat aplică o cotă partajată pentru webhook-urile primite. o cerere pe secundă și pe spațiuAceastă limită se aplică Chat-ului; nu este o limită generală pentru pasul Trimitere Webhook din Workspace Studio. Dacă eroarea apare la postarea mai multor anunțuri la rând în același spațiu, verificați această cotă împreună cu răspunsul la solicitare.

Verificați cotele de debit dacă erorile sunt intermitente.

Workspace Studio vă permite să creați până la 25 de fluxuri per utilizator, cu maximum de 20 de pași per fluxÎn plus, aplică o limită combinată asupra numărului de execuții în fiecare perioadă de 24 de ore. Dacă atingeți această limită, execuțiile ulterioare vor eșua până când contorul este resetat.

Când webhook-ul eșuează doar după mai multe activări, verificați Activitate Verificați atât limitele Studio, cât și pe cele ale serviciului țintă. Rafinarea declanșatorului — de exemplu, limitarea acestuia la anumiți expeditori sau evenimente — poate preveni solicitările inutile. Dacă eroarea apare la prima rulare, începeți prin a verifica permisiunile, aprobările în așteptare și răspunsul endpoint-ului.