Mandar una entrega de prueba a tu sistema

Compruebas que tu URL contesta y que la firma cuadra, sin esperar a que pase algo de verdad en el taller.

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.
• Tu API necesita al menos un webhook encendido. Uno «Apagado» no se puede probar: primero se reactiva.
• Avisa a quien te integra: el aviso de prueba llega a su servidor como cualquier otro, firmado.

Pasos#

1. En el menú, en el grupo «Control», entra a «Integraciones» y abre tu API.
2. La vía corta. En el panel «Webhooks», abre la flecha junto a «Abrir» de su renglón y elige «Mandar prueba». Arriba sale el acuse «Prueba encolada: llegará a tu URL como un ping firmado.»
3. La vía que además te enseña el resultado. Cambia el conmutador de la barra de «Configuración» a «Probar» y baja al bloque «Enviar una entrega de prueba».
4. Si tu API tiene más de un webhook encendido, elige a cuál en «Webhook». Con uno solo no hay nada que elegir: la pantalla enseña su URL. Los apagados no salen en la lista.
5. Pulsa «Enviar ping». Mientras va, dice «Entregando el ping…».
6. Lee el resultado: «Entregado: tu URL respondió 200.» y, debajo, «Entregado a» con la URL, el «id del evento», el «Tiempo de entrega» en milisegundos y «Pitflo-Firma» desmenuzada en «t (epoch)» y «v1 (HMAC)». Con «Copiar la respuesta» te llevas todo eso en JSON.

Resultado#

Sabes que tu URL está viva, cuánto tardó en contestar y con qué firma llegó el aviso. Si tu sistema verifica la firma, esta es la que tiene que cuadrarle.

Preguntas frecuentes#

¿Para qué sirve la firma? Es la prueba de que el aviso viene de Pitflo y de que nadie lo cambió en el camino. Quien programa de tu lado la recalcula y la compara; la pantalla se lo explica en una línea y el detalle completo está en el portal de desarrolladores, al que se llega con «Documentación».

Aparecen cuatro renglones de firma y no dos. Acabas de rotar el secreto de ese webhook. Durante 24 horas cada entrega va firmada con los dos, y la pantalla enseña también «t (secreto anterior)» y «v1 (secreto anterior)» para que tu sistema pueda cambiar sin perder avisos.

El bloque dice que no hay webhooks encendidos. Lo dice tal cual: «Esta API no tiene webhooks encendidos. Agrega uno en Configuración —o crea la URL del buzón de pruebas de abajo— y vuelve.» Es el mensaje de una API sin webhook, o de una cuyo único canal está apagado.

Dice «No se entregó». Tu URL no contestó, contestó con un error, o no es alcanzable desde fuera. Pásale a quien te integra lo que dice el detalle: es lo que necesita para buscarlo de su lado.

Quiero ver una entrega completa, con su cuerpo. El ping solo dice qué contestó tu servidor. Para ver el aviso entero —cuerpo, cabeceras y firma— usa el buzón de pruebas.

¿Una prueba cuenta como entrega? Queda en el panel «Entregas» con el evento ping, para que haya rastro de que se probó. Lo que no hace es sumar a la cuenta de fallos que apaga un canal: una prueba fallida es información para ti, no un paso hacia el apagado automático.