Sentinel

Troubleshooting

Si algo se rompe, empezá por acá. Cubre los 5 issues más reportados; si el tuyo no está, abrí ticket a support@hivium.app con request_id.

WhatsApp QR no escanea

Síntomas: escaneás el QR y queda spinning, o el modal cierra sin éxito.

  1. Cerrá el modal y volvé a generar el QR (validez ~60s).
  2. Asegurate de que en el teléfono no haya > 4 dispositivos vinculados (WhatsApp limita 4). Eliminá viejos desde el menú de WhatsApp.
  3. Si el QR no aparece, reiniciá la instancia Evolution: en /settings/integrations → WhatsApp → Re-pair. Eso destruye la instancia vieja y crea una nueva.
  4. Si nada funciona, posible problema de red en el worker Evolution. Chequeá status page.

Daily Brief no llega

  1. Unsubscribe state: si te diste de baja del email una vez, Sentinel respeta ese opt-out — incluso para Daily Brief interno. Reactivá en /settings/notifications.
  2. Timezone del workspace: chequeá que matchee la real en /settings/workspace. Si está en UTC y vos en GMT-3, el brief llega 3h tarde.
  3. Deliverability: revisá spam folder. Si caen ahí repetidamente, agregá noreply@notifications.hivium.app a contactos.
  4. Slack channel: si configurado como Slack y no llega, el bot puede no estar invitado al canal. Mandá /invite @Sentinel en el canal.
  5. Anti-spam: si no hubo actividad en las últimas 24h, el brief se skipea por diseño. No es bug.

Hivium OAuth falla

  1. Revisá el tenant_id: tiene que ser el mismo entre la app de Marketplace y el sub-account que estás conectando.
  2. Redirect URL exacta: https://sentinel.hivium.app/api/integrations/ghl/oauth/callback — incluyendo schema y sin trailing slash extra.
  3. Permisos del usuario en Hivium: tiene que ser Agency Admin o Sub-Account owner con permiso de instalar apps.
  4. Error invalid_grant: la app cambió el secret o el authorization code expiró (válido 60s). Reintentá desde cero.

API responde 429

Excediste rate limit (60 req/min default). Respuesta incluye header Retry-After: <seconds>.

Agent run failed

  1. Abrí /agents/<slug>/runs/<id>. El campo error tiene el motivo:
    • cost_cap_exceeded — el workspace pegó el cap mensual de LLM USD. Subilo en /settings/billing.
    • consent_missing — outbound bloqueado por TCPA/CAN-SPAM (no es bug).
    • provider_error — el LLM provider devolvió error. Reintento automático ya intentado; si persiste, chequeá status.
    • kb_unavailable — el KB Indexer todavía está montando. Reintento manual en 5 min.
    • timeout — la corrida superó 90s. Reducí contexto o subí modelo.
  2. Tabla raw: workspace_agent_runs (visible en plan Multi-office con SQL viewer).

¿Seguís bloqueado?

Abrí ticket a support@hivium.app con: request_id (visible en el panel del run o en respuestas API), workspace slug, y un screenshot. SLA respuesta: 24h en business hours; 4h en plan Multi-office.