- \n
- Qu\u00e9 resuelve<\/strong>: te permite recibir en tiempo real, en tu propio sistema, los datos de cada contacto u orden de trabajo, sin cargarlos a mano ni depender de una plataforma intermedia.<\/li>\n\n\n\n
- D\u00f3nde encaja<\/strong>: es la primera de las integraciones disponibles en Sistema<\/span><\/span><\/i>Integraciones<\/span><\/span><\/span>, junto a Zapier<\/strong>, Make<\/strong>, WooCommerce<\/strong>, Amazon S3<\/strong> y SMTP<\/strong>. A diferencia de Make<\/strong> y Zapier<\/strong> \u2014que crean sus webhooks autom\u00e1ticamente desde sus propias plataformas\u2014, la pesta\u00f1a Webhooks<\/strong> te permite dar de alta un webhook manualmente desde Gestioo<\/strong>, apuntando a una URL propia.<\/li>\n\n\n\n
- P\u00fablico objetivo<\/strong>: usuarios Superadministrador<\/strong> con conocimientos t\u00e9cnicos (o con el apoyo de quien desarrolle el sistema que recibir\u00e1 los datos), responsables de configurar las integraciones de Gestioo<\/strong>.<\/li>\n<\/ul>\n\n\n\n
Qu\u00e9 es un webhook<\/h3>\n\n\n\n
Un webhook<\/strong> es un aviso autom\u00e1tico que un sistema env\u00eda a otro cuando ocurre un evento. En lugar de que tu sistema tenga que preguntarle a Gestioo<\/strong> cada tantos minutos \u00ab\u00bfpas\u00f3 algo nuevo?\u00bb, es Gestioo<\/strong> quien avisa en el instante en que el evento ocurre, enviando los datos a una URL que t\u00fa preparaste para recibirlos.<\/p>\n\n\n\n
Esa URL se conoce como endpoint<\/strong>: es una direcci\u00f3n web de tu propio sistema, capaz de recibir una petici\u00f3n POST<\/strong> con la informaci\u00f3n del evento en formato JSON<\/strong>. Cuando el evento se dispara, Gestioo<\/strong> entrega ah\u00ed todos los datos, y tu sistema decide qu\u00e9 hacer con ellos (guardarlos, avisar a tu equipo, actualizar un tablero, etc.).<\/p>\n\n\n
<\/i><\/span>Comentario<\/span><\/div>\u00bfTodav\u00eda no tienes un endpoint propio?<\/strong> Puedes usar un servicio gratuito como webhook.site<\/a> para obtener una URL temporal, dar de alta el webhook apuntando a ella y ver en pantalla exactamente qu\u00e9 datos env\u00eda Gestioo<\/strong> antes de conectar tu sistema definitivo.<\/div><\/div><\/p>\n\n\n\nCon qu\u00e9 m\u00f3dulos de Gestioo\u00ae<\/small><\/sub><\/b> se relaciona y qu\u00e9 informaci\u00f3n obtienes<\/h3>\n\n\n\n
La integraci\u00f3n con Webhooks funciona en un solo sentido: Gestioo<\/strong> env\u00eda datos hacia tu URL cada vez que ocurre alguno de estos eventos. Se relaciona con dos m\u00f3dulos de Gestioo<\/strong>:<\/p>\n\n\n\n
Agenda de contactos<\/strong><\/p>\n\n\n\n
- \n
- Contacto – Creado<\/strong>: se dispara cada vez que das de alta un contacto nuevo en la agenda. Env\u00eda el contacto completo: nombre, apellidos, N\u00ba de identificaci\u00f3n, todos los tel\u00e9fonos y correos electr\u00f3nicos cargados (indicando cu\u00e1l es el predeterminado), direcci\u00f3n, localidad y fechas.<\/li>\n\n\n\n
- Contacto – Actualizado<\/strong>: se dispara cada vez que editas un contacto existente en la agenda, y tambi\u00e9n cuando el propio cliente actualiza sus datos desde el portal de autogesti\u00f3n (\u00e1rea de clientes). Env\u00eda la misma informaci\u00f3n completa del contacto, ya actualizada.<\/li>\n<\/ul>\n\n\n\n
\u00d3rdenes de trabajo (Taller)<\/strong><\/p>\n\n\n\n
- \n
- Orden de Trabajo – Creada<\/strong>: se dispara al crear una nueva orden de trabajo. Env\u00eda los datos completos de la orden: c\u00f3digo y numeraci\u00f3n, datos del cliente (nombre, direcci\u00f3n, N\u00ba de identificaci\u00f3n, tel\u00e9fonos y correos), datos del equipo (marca, modelo, serie), \u00e1rea, estado y responsable asignado, presupuesto y productos\/servicios cargados, notas, im\u00e1genes adjuntas, accesorios entregados por el cliente e importe total.<\/li>\n\n\n\n
- Orden de Trabajo – Finalizada<\/strong>: se dispara cuando la orden se entrega y factura desde el punto de venta. Env\u00eda la misma informaci\u00f3n completa de la orden, en el momento de la entrega.<\/li>\n\n\n\n
- Orden de Trabajo – Estado\/Responsable Cambiado<\/strong>: se dispara cuando cambia el \u00e1rea\/estado o el responsable asignado de una orden activa. Env\u00eda la informaci\u00f3n completa de la orden, actualizada al momento del cambio.<\/li>\n<\/ul>\n\n\n
<\/i><\/span>Ejemplo<\/span><\/div>Cada evento llega a tu endpoint como una petici\u00f3n POST<\/strong> con el cuerpo en JSON<\/strong>. Por ejemplo, el evento Orden de Trabajo – Creada<\/strong> entrega un objetoorden<\/code> con todos sus campos (orden_codigo<\/code>,cliente_nombre<\/code>,importe_total<\/code>,presupuesto_productos<\/code>, etc.), de forma que tu sistema pueda leerlo directamente y, por ejemplo, registrar cada orden nueva en tu propia base de datos.<\/div><\/div><\/p>\n\n\n\nCon estos cinco eventos como disparadores, algunos usos habituales de la integraci\u00f3n son:<\/p>\n\n\n\n
- \n
- Registrar cada contacto o cada orden nueva en tu propio sistema o base de datos.<\/li>\n\n\n\n
- Alimentar un tablero interno de seguimiento de \u00f3rdenes a medida.<\/li>\n\n\n\n
- Enviar los datos a una herramienta de automatizaci\u00f3n autoalojada (como n8n) o a cualquier endpoint que expongas.<\/li>\n\n\n\n
- Disparar procesos propios en tu infraestructura cada vez que cambia el estado de una orden.<\/li>\n<\/ul>\n\n\n<\/i><\/span>Comentario<\/span><\/div>La informaci\u00f3n que env\u00eda cada evento es id\u00e9ntica a la que reciben Make<\/strong> y Zapier<\/strong>: son el mismo mecanismo de webhooks por debajo. La diferencia es que aqu\u00ed t\u00fa aportas la URL de destino en lugar de que la genere una plataforma externa.<\/div><\/div><\/p>\n\n\n\n
Requisitos previos<\/h2>\n\n\n\n
- \n
- Un endpoint propio<\/strong>: una URL accesible por internet, capaz de recibir peticiones POST<\/strong> con cuerpo JSON<\/strong>. Puede ser tu propio servidor, una funci\u00f3n en la nube o una URL de prueba (por ejemplo, webhook.site<\/a>).<\/li>\n\n\n\n
- Permisos \/ rol en Gestioo<\/strong>: para acceder a Sistema<\/span><\/span><\/i>Integraciones<\/span><\/span><\/span> necesitas un rol con nivel de acceso equivalente al de Superadministrador<\/strong> (el mismo requerido para el resto de las integraciones de esta pantalla).<\/li>\n\n\n\n
- Acceso a Gestioo<\/strong>: consulta Acceso y perfil de usuario<\/a> si todav\u00eda no iniciaste sesi\u00f3n.<\/li>\n<\/ul>\n\n\n\n
Acceso<\/h2>\n\n\n
<\/i>Men\u00fa principal<\/span><\/span><\/i>Sistema<\/span><\/span><\/i>Integraciones<\/span><\/span><\/span><\/p>\n\n\n\n
- \n
- En el men\u00fa principal, haz <\/i> clic<\/span> en Sistema<\/strong>.<\/li>\n\n\n\n
- Haz <\/i> clic<\/span> en Integraciones<\/strong>.<\/li>\n\n\n\n
- El panel de integraciones abre en la pesta\u00f1a Webhooks<\/strong>, que es la primera y viene seleccionada por defecto.<\/li>\n<\/ol>\n\n\n\n
![\"\"](\"https:\/\/academy.gestioo.com\/taller\/wp-content\/uploads\/2026\/07\/image-113.png\")
<\/figure>\n\n\n\nInterfaz<\/h2>\n\n\n\n
Dentro de la pantalla de integraciones encontrar\u00e1s:<\/p>\n\n\n\n
![\"\"](\"https:\/\/academy.gestioo.com\/taller\/wp-content\/uploads\/2026\/07\/image-114.png\")
<\/figure>\n\n\n\nA \u2014 Keymaster (compartido por todas las integraciones)<\/strong><\/p>\n\n\n\n
- \n
- Campo Keymaster<\/strong> (solo lectura, con bot\u00f3n Copiar<\/strong>): la clave que identifica a tu cuenta de Gestioo<\/strong>. La usan las integraciones que se conectan por API (Zapier<\/strong>, Make<\/strong> y WooCommerce<\/strong>). Para dar de alta un webhook manualmente en esta pesta\u00f1a no necesitas el Keymaster<\/strong>: solo un Tipo<\/strong> y una URL<\/strong>.<\/li>\n<\/ul>\n\n\n\n
B \u2014 Pesta\u00f1a Webhooks<\/strong><\/p>\n\n\n\n
- \n
- Encabezado con la descripci\u00f3n de la integraci\u00f3n.<\/li>\n\n\n\n
- Bot\u00f3n Actualizar<\/strong> (icono de sincronizaci\u00f3n): refresca la lista de webhooks dados de alta.<\/li>\n\n\n\n
- Bot\u00f3n Crear<\/strong> (+<\/strong>): abre la ventana para dar de alta un nuevo webhook manualmente.<\/li>\n<\/ul>\n\n\n
<\/i><\/span>Comentario<\/span><\/div>Con bot\u00f3n de creaci\u00f3n manual:<\/strong> a diferencia de las pesta\u00f1as Make<\/strong> y Zapier<\/strong> \u2014donde los webhooks se crean solos desde esas plataformas\u2014, la pesta\u00f1a Webhooks<\/strong> s\u00ed tiene un bot\u00f3n +<\/strong> para dar de alta un webhook apuntando a tu propia URL (ver Dar de alta un webhook).<\/div><\/div><\/p>\n\n\n\nC \u2014 Lista de webhooks<\/strong><\/p>\n\n\n\n
- \n
- Tipo<\/strong>: el evento suscripto (por ejemplo, Orden de Trabajo – Creada<\/strong> o Contacto – Actualizado<\/strong>).<\/li>\n\n\n\n
- URL<\/strong>: la direcci\u00f3n de tu endpoint a la que Gestioo<\/strong> env\u00eda los datos de ese evento.<\/li>\n\n\n\n
- Estado<\/strong>: indica si el webhook est\u00e1 Activo<\/strong>.<\/li>\n\n\n\n
- Acciones por fila:\n
- \n
- Probar<\/strong> (icono + texto): env\u00eda datos de ejemplo a la URL para comprobar que tu endpoint los recibe.<\/li>\n\n\n\n
- Icono de papelera (Eliminar<\/strong>): da de baja ese webhook.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
Funciones y tareas<\/h2>\n\n\n\n
Dar de alta un webhook<\/h3>\n\n\n\n
- \n
- En la pesta\u00f1a Webhooks<\/strong>, haz <\/i> clic<\/span> en el bot\u00f3n +<\/strong> (Crear<\/strong>).<\/li>\n\n\n\n
- En la ventana que se abre, despliega la lista Tipo<\/strong> y elige el evento que quieres recibir: Orden de Trabajo – Creada<\/strong>, Orden de Trabajo – Finalizada<\/strong>, Orden de Trabajo – Estado\/Responsable Cambiado<\/strong>, Contacto – Creado<\/strong> o Contacto – Actualizado<\/strong>.<\/li>\n\n\n\n
- En el campo URL<\/strong>, pega la direcci\u00f3n de tu endpoint (debe empezar por
http:\/\/<\/code> ohttps:\/\/<\/code>).<\/li>\n\n\n\n- Haz <\/i> clic<\/span> en Guardar<\/strong>.<\/li>\n\n\n\n
- Repite el proceso por cada evento que quieras recibir.<\/li>\n<\/ol>\n\n\n\n
<\/figure>\n\n\n\nEl webhook queda Activo<\/strong> de inmediato y aparece en la lista. A partir de ese momento, cada vez que ocurra ese evento en tu taller, Gestioo<\/strong> enviar\u00e1 los datos a tu URL.<\/p>\n\n\n
<\/i><\/span>Alerta<\/span><\/div>Ten en cuenta:<\/strong> solo puede existir un webhook activo por tipo de evento en todo el sistema, sin importar la plataforma. Si ya tienes, por ejemplo, Orden de Trabajo – Creada<\/strong> enlazado con Make o con Zapier, al intentar crearlo aqu\u00ed ver\u00e1s el aviso \u00abYa existe una Integraci\u00f3n del tipo seleccionado. Verifique las pesta\u00f1as de las distintas integraciones.\u00bb<\/div><\/div><\/p>\n\n\n\nProbar un webhook<\/h3>\n\n\n\n
Antes de depender del webhook en producci\u00f3n, conviene confirmar que tu endpoint recibe correctamente los datos.<\/p>\n\n\n\n
- \n
- En la lista de webhooks, ubica la fila del webhook que quieres probar.<\/li>\n\n\n\n
- Haz <\/i> clic<\/span> en Probar<\/strong>.<\/li>\n\n\n\n
- Gestioo<\/strong> env\u00eda a tu URL una petici\u00f3n POST<\/strong> con datos de ejemplo del tipo correspondiente (una orden o un contacto de prueba) y muestra el mensaje Test realizado con \u00e9xito<\/strong>.<\/li>\n\n\n\n
- Revisa en tu endpoint que la informaci\u00f3n lleg\u00f3 con el formato esperado.<\/li>\n<\/ol>\n\n\n
- Gestioo<\/strong> env\u00eda a tu URL una petici\u00f3n POST<\/strong> con datos de ejemplo del tipo correspondiente (una orden o un contacto de prueba) y muestra el mensaje Test realizado con \u00e9xito<\/strong>.<\/li>\n\n\n\n
- En la ventana que se abre, despliega la lista Tipo<\/strong> y elige el evento que quieres recibir: Orden de Trabajo – Creada<\/strong>, Orden de Trabajo – Finalizada<\/strong>, Orden de Trabajo – Estado\/Responsable Cambiado<\/strong>, Contacto – Creado<\/strong> o Contacto – Actualizado<\/strong>.<\/li>\n\n\n\n
- Icono de papelera (Eliminar<\/strong>): da de baja ese webhook.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
- URL<\/strong>: la direcci\u00f3n de tu endpoint a la que Gestioo<\/strong> env\u00eda los datos de ese evento.<\/li>\n\n\n\n
- Bot\u00f3n Crear<\/strong> (+<\/strong>): abre la ventana para dar de alta un nuevo webhook manualmente.<\/li>\n<\/ul>\n\n\n
- Haz <\/i> clic<\/span> en Integraciones<\/strong>.<\/li>\n\n\n\n
- Permisos \/ rol en Gestioo<\/strong>: para acceder a Sistema<\/span><\/span><\/i>Integraciones<\/span><\/span><\/span> necesitas un rol con nivel de acceso equivalente al de Superadministrador<\/strong> (el mismo requerido para el resto de las integraciones de esta pantalla).<\/li>\n\n\n\n
- Un endpoint propio<\/strong>: una URL accesible por internet, capaz de recibir peticiones POST<\/strong> con cuerpo JSON<\/strong>. Puede ser tu propio servidor, una funci\u00f3n en la nube o una URL de prueba (por ejemplo, webhook.site<\/a>).<\/li>\n\n\n\n
- Orden de Trabajo – Finalizada<\/strong>: se dispara cuando la orden se entrega y factura desde el punto de venta. Env\u00eda la misma informaci\u00f3n completa de la orden, en el momento de la entrega.<\/li>\n\n\n\n
- Contacto – Actualizado<\/strong>: se dispara cada vez que editas un contacto existente en la agenda, y tambi\u00e9n cuando el propio cliente actualiza sus datos desde el portal de autogesti\u00f3n (\u00e1rea de clientes). Env\u00eda la misma informaci\u00f3n completa del contacto, ya actualizada.<\/li>\n<\/ul>\n\n\n\n
- D\u00f3nde encaja<\/strong>: es la primera de las integraciones disponibles en Sistema<\/span><\/span><\/i>Integraciones<\/span><\/span><\/span>, junto a Zapier<\/strong>, Make<\/strong>, WooCommerce<\/strong>, Amazon S3<\/strong> y SMTP<\/strong>. A diferencia de Make<\/strong> y Zapier<\/strong> \u2014que crean sus webhooks autom\u00e1ticamente desde sus propias plataformas\u2014, la pesta\u00f1a Webhooks<\/strong> te permite dar de alta un webhook manualmente desde Gestioo<\/strong>, apuntando a una URL propia.<\/li>\n\n\n\n