$destinatarios */ private function registrarElAviso(ApiBlock $bloqueo, array $destinatarios, ?string $error = null): void { try { Notice::registrar( Notice::SUBJECT_API_BLOCK, $bloqueo->id, Notice::KIND_BLOCK_ALERT, (int) $bloqueo->limit_value, 'block:' . $bloqueo->id, $destinatarios, $error, [ 'sujeto' => $bloqueo->sujeto_texto, 'motivo' => $bloqueo->reason, // Si cortaba o solo observaba, que es lo que decide si alguien se quedó // sin servicio — y es lo primero que se pregunta al leer el aviso. 'corta' => (bool) $bloqueo->enforced, 'rechazos' => (int) $bloqueo->hits, ] ); } catch (\Throwable $e) { Log::channel('api')->error('No se pudo registrar el aviso de bloqueo', [ 'api_block_id' => $bloqueo->id, 'error' => $e->getMessage(), ]); } } /** * Manda el aviso de un bloqueo nuevo si toca. * * Nunca lanza: un fallo al avisar no puede tumbar la petición de la API que ha * provocado el bloqueo. */ public function avisar(ApiBlock $bloqueo): void { try { if (!$this->ajustes->avisaDeBloqueos()) { return; } if ($bloqueo->notified_at !== null) { return; } $destinatarios = $this->ajustes->destinatariosDeAvisos(); if ($destinatarios === []) { // Sin destinatarios no hay aviso posible, y eso es un problema de // configuración que hay que poder ver: queda en el log del panel para // que salga en el Dashboard. MonitoringLog::db( 'warning', '16007', 'Hay un bloqueo nuevo (' . $bloqueo->sujeto_texto . ') y no hay ningún ' . 'destinatario configurado para los avisos. Se configura en ' . 'Configuraciones → Configuraciones del Manager.', 'ApiBlock', (string) $bloqueo->id ); return; } Mail::to($destinatarios)->send(new ApiBlockAlert($bloqueo)); $bloqueo->update(['notified_at' => now()]); MonitoringLog::db( 'info', '16008', 'Aviso de bloqueo enviado a ' . implode(', ', $destinatarios) . ': ' . $bloqueo->sujeto_texto, 'ApiBlock', (string) $bloqueo->id ); $this->registrarElAviso($bloqueo, $destinatarios); } catch (\Throwable $e) { // **El fallo también se registra**, y es la mitad del sentido de la pantalla de // Avisos: «los fallidos primero, un aviso que no salió es un cliente sin // avisar». Sin esta fila, un SMTP caído no se vería en ninguna parte hasta que // alguien echara de menos un correo. $this->registrarElAviso($bloqueo, $destinatarios ?? [], $e->getMessage()); // `notified_at` se queda nulo a propósito: el bloqueo sigue pendiente de // avisar y el siguiente rechazo lo reintentará. Log::channel('api')->error('No se pudo enviar el aviso de bloqueo', [ 'api_block_id' => $bloqueo->id, 'sujeto' => $bloqueo->sujeto_texto, 'error' => $e->getMessage(), ]); } } }