Ver una entrega real con el buzón de pruebas

Ves un aviso de Pitflo por dentro —el cuerpo, las cabeceras y la firma— sin tener que levantar un servidor primero.

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.
• Esto es material de prueba, no un destino de producción: la URL caduca a las 24 horas y el buzón guarda las últimas 500 entregas.
• El buzón solo recibe. No reenvía nada ni ejecuta nada de lo que llega.

Pasos#

1. En el menú, en el grupo «Control», entra a «Integraciones» y abre tu API.
2. Cambia el conmutador de la barra de «Configuración» a «Probar» y baja al bloque «Buzón de pruebas».
3. Pulsa «Crear URL de prueba». Arriba del bloque tienes el aviso que manda: «Solo para pruebas · la URL caduca 24 h después de crearla.»
4. En el mismo acto se abre el alta del webhook con la URL ya puesta y todos los eventos que esta API puede oír marcados. Quita los que no quieras y pulsa «Agregar webhook».
5. Guarda el secreto que sale en «Webhook agregado» y pulsa «Ya las guardé».
6. Provoca un aviso: mueve una orden en el tablero, o vuelve a «Probar» y usa «Enviar ping». Los tres pasos los dicta la propia pantalla: «Crea la URL de prueba (te abrimos el alta del webhook).», «Guarda el webhook con los eventos que quieras oír.» y «Mueve una orden en el tablero (o manda un ping): la entrega aparece aquí.»
7. La entrega aparece sola, sin recargar: la hora, el evento, su identificador, la pastilla «Firma válida» y los milisegundos que tardó. Pulsa el renglón para abrirlo y ver las cabeceras, el «Origen» —la dirección de internet y cuántos bytes pesó— y el cuerpo completo, con «Copiar el cuerpo recibido».
8. Cuando termines, pulsa «Eliminar el buzón». Confirma en «¿Eliminar el buzón de pruebas?»: «La URL deja de recibir al instante y las entregas guardadas se van con ella.»

Resultado#

Tienes delante lo que tu servidor va a recibir, byte por byte, y con la firma ya verificada por Pitflo. Con eso, quien te integra escribe su lado sabiendo exactamente qué esperar.

Preguntas frecuentes#

¿Puedo dejar esta URL en producción? No. Caduca a las 24 horas y después responde 404: «Esta URL ya caducó: el receptor responde 404. Regenérala para seguir probando.» La URL de tu sistema de verdad se registra igual, en un webhook normal.

¿Qué hacen «Vaciar» y «Regenerar»? «Vaciar» borra las entregas guardadas y deja la misma dirección. «Regenerar» entrega una dirección nueva y mata la anterior; si algún webhook de esta API apunta a la de ahora, antes pregunta y te ofrece «Actualizar ese webhook a la URL nueva» en la misma ventana.

La pantalla dice «Hay más entregas guardadas». El buzón conserva las últimas 500; las más viejas se van saliendo solas.

La pastilla dice «Sin firma». El aviso llegó sin firmar. No es lo mismo que «Firma inválida»: una entrega sin firma no es una falsificada, y por eso son tres estados y no dos. Los avisos que manda Pitflo siempre van firmados.

No veo el botón «Usar esta URL en un webhook nuevo». Es el rescate, no el camino: solo aparece cuando el buzón existe y ningún webhook apunta a él. En el camino normal el alta se abre sola al crear la URL.

¿Quién puede leer lo que llega aquí? Quien administra las integraciones de tu empresa. El buzón no guarda nada que tu empresa no haya emitido: el cuerpo es el mismo que Pitflo mandó, ya recortado a los campos que tu API expone.