Avisar a tu sistema cuando pase algo

Pitflo le avisa a tu sistema en el momento en que pasa algo en el taller —entra una orden, se registra un cobro, se timbra una factura—, para que no tenga que estar preguntando.

Antes de empezar#

• Necesitas el permiso de «Integraciones» con alcance de «Toda la empresa» (de fábrica, el Superadministrador y el Administrador) y el plan Empresarial.
• Necesitas una API ya creada y la dirección de tu sistema que va a recibir los avisos. Te la da quien te integra y tiene que empezar con https.
• Solo se avisan eventos de recursos que tu API expone. Para oír los cobros, por ejemplo, tu API tiene que exponer «Cobros».
• Cada API admite hasta 3 webhooks.

Pasos#

1. En el menú, en el grupo «Control», entra a «Integraciones» y abre tu API. Si tienes varias sucursales, elige primero la fila «Todas las sucursales» en el selector de arriba del menú.
2. En el panel «Webhooks», pulsa «Agregar webhook».
3. Escribe la dirección de tu sistema en «URL (https)».
4. En «Avisar cuando…», marca los eventos que quieres oír, por ejemplo «Entra una orden» o «Se registra un cobro». Están agrupados por recurso; «Elegir todos» marca el grupo completo.
5. Pulsa «Agregar webhook».
6. En «Webhook agregado», pulsa «Copiar» y guarda el secreto: se muestra una sola vez. Entrégaselo a quien te integra; con él su sistema comprueba que cada aviso viene de Pitflo.
7. Pulsa «Ya las guardé».

Si apenas vas a generar la API, los mismos dos campos están en el panel «Webhook» del alta. En ese caso el secreto aparece junto al token, en «Tu API quedó lista».

Resultado#

El webhook aparece en la tabla con el estado «Entregando». Desde ese momento, cada vez que pase algo de lo que marcaste, Pitflo lo manda a tu URL, firmado. Si tu sistema no contesta, el aviso se reintenta con esperas cada vez más largas —de un minuto a ocho horas—, hasta seis intentos.

Preguntas frecuentes#

¿Qué pasa si mi sistema se cae varios días? Cada aviso agota sus intentos y queda como no entregado. Si fallan diez seguidos, el webhook se apaga solo: su estado cambia a «Apagado» y te avisamos por correo. Cuando tu sistema vuelva, lo reactivas desde la misma tabla.

El evento que quiero sale apagado. Debajo dice, por ejemplo, «Expón Citas para oír este evento»: tu API no expone ese recurso. Cierra la ventana, marca el recurso en «Qué expone» y vuelve a agregar el webhook.

¿Pitflo avisa cuando borro algo? Sí, para clientes, vehículos y órdenes: «Se da de baja un cliente», «Se da de baja un vehículo», «Se da de baja una orden» y «Se restaura una orden». Sirven para que tu sistema borre también su copia; de los datos que ya se llevó, el responsable sigues siendo tú.

Perdí el secreto del webhook. En la fila del webhook, abre la flecha junto a «Abrir» y elige «Rotar secreto». Sale uno nuevo, y durante 24 horas las entregas van firmadas con los dos para que tu sistema cambie sin perder avisos.