Configura webhooks para que tu sistema externo reciba notificaciones automáticas en tiempo real cada vez que ocurra un evento en tu taller: nuevos servicios, cambios de estatus o pagos registrados.
Requisito previo: clave API activa
- Ve a Configuración > pestaña Desarrollo.
- Verifica que tienes una clave API activa. Si no, genera una nueva con todos los permisos.
- Copia el token de autenticación.
Acceder a la documentación de webhooks
- Desde la pestaña Desarrollo, haz clic en Ver información completa.
- En la documentación interactiva, selecciona el servidor public-api.mecanica.mx.
- Configura la autenticación con tu token.
- Localiza la sección Webhooks en el menú lateral.
Explorar los endpoints disponibles
Los endpoints de webhooks permiten:
- Listar: ver todos los webhooks activos
- Crear: registrar un nuevo webhook
- Actualizar: modificar la URL o los eventos de un webhook existente
- Eliminar: desactivar un webhook
Al explorar el endpoint de crear webhook, verás los parámetros necesarios: la URL destino y los eventos disponibles.
Crear un webhook de prueba
- Haz clic en Test Request del endpoint Crear webhook.
- Escribe la URL del servidor que recibirá las notificaciones.
- Selecciona los eventos a escuchar (por ejemplo, “nuevo servicio” y “cambio de estatus”).
- Haz clic en Send.
- El sistema confirma la creación del webhook con una respuesta exitosa.
Verificar y gestionar webhooks
- Usa el endpoint Listar webhooks para ver tus webhooks activos.
- Cada registro muestra: URL, eventos configurados y estatus.
- Para modificar un webhook, usa el endpoint Actualizar.
- Para eliminarlo, usa el endpoint Eliminar.
Casos de uso comunes
- Notificar a un sistema externo cuando se crea un nuevo servicio.
- Disparar una acción cuando una orden cambia de estatus.
- Registrar pagos en un sistema contable externo automáticamente.
Video tutorial
Mira el tutorial completo en video para ver el proceso paso a paso.