Variables de entorno (servidor)
Las cuatro keys son necesarias para habilitar el publisher; la quinta es opcional.Cuando falta cualquiera de las cuatro keys requeridas,
getPusherClient() devuelve
null, el publisher degrada a modo log-only y el health probe reporta
el componente como caído.Health probe
El servicio de salud de integraciones emite unGET /channels autenticado y barato
contra la API HTTP de Pusher (checkPusher()), combinado con tráfico de publish
real registrado vía recordIntegrationOutcome("pusher", ...). Better Stack
rastrea el componente como INT-06 en la página de estado.
Solución de problemas
El cliente muestra status: disabled
El cliente muestra status: disabled
NEXT_PUBLIC_PUSHER_KEY está vacía. Configúrala para el entorno (valor público)
y vuelve a desplegar la app para que la variable de tiempo de build quede horneada.La suscripción a un canal privado falla con AuthError
La suscripción a un canal privado falla con AuthError
El endpoint de auth está mal configurado o el llamante carece de
pusher:auth. Verifica
que la app haga proxy a POST /api/v3/realtime/pusher/auth y que el canal
coincida con private-(contract|account)-{uuid}.Los eventos se publican pero nunca se reciben
Los eventos se publican pero nunca se reciben
Confirma que el cluster del cliente coincida con el cluster del servidor
(
INTEGRATION_PUSHER_CLUSTER vs NEXT_PUBLIC_PUSHER_CLUSTER) y que ambos
lados usen la misma app de Pusher.La salud muestra Pusher caído pero el publishing funciona
La salud muestra Pusher caído pero el publishing funciona
Un
4xx nunca cambia el veredicto, pero una capacidad GET /channels ausente o
un error de red sí lo hará. Verifica las credenciales del servidor y la red saliente.Depuración del lado del cliente
usePusherChannel imprime logs de ciclo de vida verbosos cuando ya sea
localStorage.setItem("bbl:pusher:debug", "1") se establece desde la consola del navegador
o se añade ?pusher_debug=1 a la URL.