Reactivar un aviso que se apagó solo

Vuelves a encender el canal de avisos que Pitflo apagó por su cuenta, después de arreglar lo que fallaba de tu lado.

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.
• Un webhook se apaga solo cuando fallan diez entregas seguidas. Cuando pasa, Pitflo manda correo a quien administra las integraciones.
• Reactivar no arregla tu servidor: si la URL sigue sin contestar, el canal se vuelve a apagar.

Pasos#

1. En el menú, en el grupo «Control», entra a «Integraciones», abre tu API y baja al panel «Entregas». Ahí está la evidencia: qué evento salió, qué «Código» contestó tu sistema y en qué «Intento» murió.
2. Pásale ese dato a quien te integra y espera a que corrija su lado. Lo que Pitflo no puede hacer por ti es que tu URL conteste.
3. En el panel «Webhooks», su renglón está marcado «Apagado», con la razón debajo: «Fallaron 10 entregas seguidas; se apagó solo el … y te avisamos por correo. Corrige tu URL y reactívalo.» Abre la flecha junto a «Abrir» y elige «Reactivar».
4. Sale el acuse «Webhook reactivado» y el estado vuelve a «Entregando».
5. Comprueba antes de irte: abre otra vez la flecha junto a «Abrir» y elige «Mandar prueba». Si tu URL contesta, ya está.

Resultado#

El canal vuelve a entregar y la cuenta de fallos arranca de cero: hacen falta otras diez entregas muertas seguidas para que se apague de nuevo. Los avisos que murieron mientras estuvo apagado no se vuelven a mandar.

Preguntas frecuentes#

¿Por qué se apaga solo? Para no estar tocando durante días la puerta de un servidor que no abre. Cada aviso ya reintenta seis veces —de un minuto a ocho horas— antes de darse por muerto; diez muertos seguidos son señal de que el problema no se va a arreglar con más intentos.

No encuentro «Reactivar» en el menú. Solo aparece en un webhook apagado. En uno que está entregando, el menú trae «Mandar prueba», «Rotar secreto», «Editar» y la baja.

Reactivé y se volvió a apagar. Tu URL sigue sin contestar bien. Revisa de nuevo el «Código» en «Entregas»: un 404 dice que la dirección ya no existe, un 500 que tu servidor truena, y una raya que ni siquiera hubo respuesta. Si la dirección cambió, usa «Editar» en vez de reactivar.

¿Puedo recuperar los avisos que se perdieron? No. Cuando tu sistema vuelva, ponlo al día consultando la API con el filtro updated_since: trae solo lo que cambió desde la fecha que le pidas.

Ya no quiero ese canal. Abre la flecha junto a «Abrir» y da de baja el webhook. La pantalla avisa: «Deja de recibir eventos en {url} y su historial de entregas se va con él. Libera uno de los tres cupos.»