- «Enviar un webhook» debe estar habilitado por el administrador.
- La URL debe ser estática; HTTPS es recomendable.
- Actividad muestra el error y la respuesta del destino.
- El límite de una petición por segundo corresponde a los webhooks entrantes de Chat.
Has creado un flujo en Google Workspace Studio, has añadido el paso Enviar un webhook y la petición nunca llega a su destino. O quizá el flujo funcionaba y ahora aparece un error. Antes de cambiar la URL a ciegas, conviene averiguar en qué punto se detiene la ejecución: el acceso al paso, una aprobación pendiente, la configuración de la solicitud o la respuesta del servicio externo.
Workspace Studio utiliza este paso para enviar una petición HTTP a una dirección concreta. Puede servir para avisar a una herramienta interna, crear un registro en otra aplicación o enviar datos a un servicio que no tenga un conector directo. La solución depende de si el bloqueo ocurre dentro de Google Workspace o en el servidor que recibe la petición.
Comprueba si el administrador ha habilitado los webhooks
Si Enviar un webhook no aparece entre los pasos disponibles, empieza por los permisos de la organización. Google indica que esta función está desactivada de forma predeterminada y que un administrador debe habilitarla para la unidad organizativa correspondiente. La ruta es Consola del administrador > Apps > Google Workspace > Workspace Studio > Configuración de webhooks.
Comprueba también que tu cuenta tenga acceso a la función: Google sigue identificando el paso de webhooks como una característica en vista previa limitada. Si no eres administrador, facilita a quien gestione Workspace el nombre del paso que falta, tu cuenta y la unidad organizativa a la que perteneces. Así podrá comprobar los ajustes aplicables sin modificar permisos de otros equipos.
Revisa la lista de URLs permitidas y las aprobaciones
En algunas ediciones, el administrador puede limitar los destinos externos mediante una lista de dominios y URLs permitidos. Si el paso existe pero no puede conectar con un endpoint concreto, confirma que su dominio o URL figure en esa lista. El ajuste se gestiona desde las opciones de importación y obtención de URLs de Drive y Documentos.
Esta restricción no funciona igual en todas las ediciones. La lista de permitidos para webhooks está disponible, entre otras, en Business Plus, Enterprise Standard y Plus, y Education Standard y Plus. En las ediciones que no ofrecen este control, activar los webhooks permite conectar con URLs válidas sin aplicar esa lista. Por eso conviene comprobar primero la edición y la política de tu organización.
El flujo también puede estar esperando una aprobación del usuario. Google trata el envío de datos a un endpoint externo como una acción sensible y exige revisar y confirmar el paso de forma predeterminada. Si parece que la automatización se ha quedado parada, abre Studio y consulta las solicitudes de aprobación pendientes antes de concluir que el servidor ha fallado.
Configura correctamente la URL, el método y los datos enviados
Abre el flujo en studio.workspace.google.com y revisa el paso Enviar un webhook. La dirección debe ser completa y estática: el campo admite una URL que empiece por http:// o https://, pero no permite insertar variables en la propia URL. HTTPS es la opción recomendada para evitar enviar información sin cifrar; no es un requisito del campo.
- Método HTTP: selecciona el que espera la API de destino. Studio ofrece GET, POST, PUT, PATCH y DELETE; POST es la opción predeterminada.
- Cuerpo de la petición: es opcional y se envía como texto. Para muchas APIs conviene usar JSON, respetando las comillas, llaves y nombres de los campos que exige el servicio.
- Variables: puedes incluir datos procedentes de pasos anteriores en el cuerpo. Comprueba el resultado cuando una variable contenga comillas, saltos de línea u otros caracteres que puedan romper el formato JSON.
- Solicitudes GET: Studio ignora el cuerpo de la petición con este método. Si el servicio exige datos en el cuerpo, revisa qué método admite su documentación.
Haz una ejecución de prueba y recuerda que enviará una petición real al destino. Si el paso funciona, su respuesta queda disponible como una variable de texto para utilizarla más adelante en el mismo flujo.
Usa la pestaña Actividad para localizar el fallo
Después de cada ejecución, abre Actividad en Workspace Studio. Si la petición se completó, podrás revisar los datos enviados y la respuesta recibida. Si falló, Studio muestra el código de error y la respuesta de la URL de destino. Esa información permite separar un problema de configuración del flujo de un rechazo producido por el servicio externo.
Un 400 suele indicar que el receptor no acepta la solicitud tal como está construida; revisa el método y el cuerpo. Ante un 401 o 403, comprueba los requisitos de acceso del servicio y las restricciones de tu organización. Un 404 invita a verificar la ruta del endpoint. Si aparece un 429, consulta sus límites de peticiones; los errores 5xx suelen señalar un problema del servicio receptor. La respuesta concreta del endpoint es más útil que interpretar el número de forma aislada.
Los administradores también pueden consultar los registros de eventos de Workspace Studio para investigar solicitudes de webhook. El acceso a ciertos datos, como la URL solicitada, está restringido porque pueden contener información sensible.
No confundas el webhook de Studio con uno entrante de Google Chat
El paso Enviar un webhook de Workspace Studio hace una petición hacia una URL externa. Un webhook entrante de Google Chat, en cambio, es una URL creada dentro de un espacio para que otro sistema publique mensajes allí. Son piezas distintas, aunque puedas utilizar la URL de Chat como destino de un flujo de Studio.
Si la finalidad es publicar un aviso en Google Chat, revisa primero si te basta con el paso Publicar en un espacio de Studio. Si necesitas utilizar un webhook entrante, debes crearlo desde Apps e integraciones del espacio y conservar privada su URL, que incluye una clave y un token. Estos webhooks sirven para enviar mensajes al espacio, pero no permiten mantener una conversación con los usuarios.
Google Chat aplica a sus webhooks entrantes una cuota compartida de una solicitud por segundo y por espacio. Ese límite corresponde a Chat; no es un límite general del paso Enviar un webhook de Workspace Studio. Si el error aparece al publicar muchos avisos seguidos en el mismo espacio, revisa esta cuota junto con la respuesta de la petición.
Comprueba las cuotas del flujo si los errores son intermitentes
Workspace Studio permite crear hasta 25 flujos por usuario, con un máximo de 20 pasos por flujo. Además, aplica un límite conjunto de ejecuciones durante cada periodo de 24 horas. Si lo agotas, las nuevas ejecuciones fallarán hasta que el contador se restablezca.
Cuando el webhook solo falla tras muchas activaciones, consulta Actividad y comprueba tanto los límites de Studio como los del servicio de destino. Afinar el activador —por ejemplo, limitarlo a determinados remitentes o eventos— puede evitar peticiones innecesarias. Si el error se produce desde la primera ejecución, empieza por los permisos, la aprobación pendiente y la respuesta del endpoint.
Soy un apasionado de la tecnología que ha convertido sus intereses «frikis» en profesión. Llevo más de 10 años de mi vida utilizando tecnología de vanguardia y trasteando todo tipo de programas por pura curiosidad. Ahora me he especializado en tecnología de ordenador y videojuegos. Esto es por que desde hace más de 5 años que trabajo redactando para varias webs en materia de tecnología y videojuegos, creando artículos que buscan darte la información que necesitas con un lenguaje entendible por todos.
Si tienes cualquier pregunta, mis conocimientos van desde todo lo relacionado con el sistema operativo Windows así como Android para móviles. Y es que mi compromiso es contigo, siempre estoy dispuesto a dedicarte unos minutos y ayudarte a resolver cualquier duda que tengas en este mundo de internet.