Documentación
v2.8 Actualizado oct. 2026Documentación de CivicFlow
Configura tu espacio de trabajo, modela los servicios de tu ciudad y despliega CivicFlow en cada departamento, con guías escritas por el equipo que lo construye.
Guías más leídas
Guías breves y prácticas para administradores y responsables de departamento.
- Primeros pasos Inicio rápido De un espacio vacío a tu primera incidencia enrutada en unos 30 minutos. 8 min de lectura
- Guías Configurar categorías y SLA Modela tus servicios y fija plazos de respuesta acordes con los compromisos municipales. 6 min de lectura
- Guías Reglas de enrutamiento Envía cada incidencia al equipo adecuado automáticamente, con alternativas claras. 5 min de lectura
- Guías Despliegue de la app de campo Consigue que las brigadas trabajen desde la app móvil en su primera semana. 4 min de lectura
- Guías Páginas de estado públicas Muestra a los vecinos qué se está arreglando sin exponer datos personales. 3 min de lectura
- Guías CivicFlow AI Prioriza, agrupa y resume incidencias, siempre con el equipo al mando. 5 min de lectura
- Administración SSO y SCIM Inicia sesión con tu proveedor de identidad y mantén las cuentas sincronizadas. 7 min de lectura
- Administración Roles y permisos Da a cada persona exactamente el acceso que necesita su trabajo. 4 min de lectura
- Administración Registros de auditoría Consulta quién hizo qué y cuándo, en cada cambio del espacio. 3 min de lectura
- Administración Conservación de datos Guarda los registros el tiempo que exige la ley, ni un día más. 4 min de lectura
Ninguna guía coincide con tu búsqueda. Prueba con un término más general o usa el menú lateral.
Pasa de un espacio vacío a tu primera incidencia enrutada en unos 30 minutos. Necesitas el rol de Administrador y la CLI de CivicFlow, o puedes seguir los mismos pasos en Ajustes dentro de la aplicación web.
-
La CLI usa la misma API REST que la aplicación web. Inicia sesión con tu cuenta de trabajo; el token se guarda en el llavero del sistema, nunca en un archivo.
Shell Terminal # Install the CivicFlow CLI and sign in to your workspacenpm install --global @civicflow/clicivicflow login --workspace aurora# Signed in as m.lindqvist@aurora.gov (Admin) · EU region -
Las categorías describen qué pueden comunicar los vecinos y qué SLA se aplica. Parte de tu lista actual de avisos: podrás renombrar, fusionar o retirar categorías más adelante sin perder el historial.
JSON categories.json [ { "key": "lighting", "name": "Streetlight outage", "department": "public-works", "sla": { "acknowledge_h": 4, "resolve_h": 48 } }, { "key": "waste", "name": "Missed collection", "department": "sanitation", "sla": { "acknowledge_h": 8, "resolve_h": 24 } }] -
Las reglas se evalúan de arriba abajo en cada incidencia nueva y envían el trabajo a los equipos que hayas creado. Esta envía los avisos de alumbrado del distrito norte a la brigada eléctrica y sube la prioridad de noche.
JSON rules/north-lighting.json { "name": "North lighting → electrical crew", "when": { "category": "lighting", "district": "north" }, "then": [ { "route": "elec-4" }, { "prioritize": "high", "between": ["19:00", "07:00"] } ]} -
Activa el portal web para vecinos y la recepción por correo, y envía un aviso de prueba. Aparecerá en el mapa de operaciones en segundos, ya categorizado y asignado.
Shell Terminal civicflow import categories.json --dry-runcivicflow rules apply rules/north-lighting.jsoncivicflow channels enable web-portal email# Send a test report — it appears on the map in secondscivicflow incidents create --category lighting --at "Linden St & 4th Ave"
Siete objetos describen cómo avanza el trabajo en CivicFlow. Cada pantalla, informe y endpoint de la API se construye con ellos.
- Incidencia
- Un problema concreto comunicado por un vecino, un empleado o una integración, con ubicación, categoría, estado, historial y adjuntos.
- Categoría
- El tipo de problema (p. ej. farola apagada). Define el formulario de aviso, el SLA por defecto y el departamento responsable.
- Cola
- Una lista ordenada de incidencias pendientes para un equipo, según prioridad y vencimiento del SLA.
- Equipo
- Un grupo de personal o una brigada de campo que atiende una cola, con miembros, turnos y zona de servicio.
- SLA
- El plazo objetivo para atender y resolver una incidencia. Las políticas pueden variar por categoría, prioridad, distrito y horario laboral.
- Regla
- Una condición y una acción —enrutar, priorizar, notificar o fusionar— que se evalúa en cada incidencia nueva o actualizada.
- Vecino
- La persona que comunica o sigue una incidencia. Sus datos de contacto son datos personales, protegidos por tu política de conservación.
Un espacio de trabajo corresponde a una ciudad u organización. Elige su región de datos (UE o EE. UU.) al crearlo: no se puede cambiar después, porque cada registro, archivo y copia de seguridad permanece en ella.
- Perfil: nombre oficial, logotipo, zona horaria y horario laboral que usan los relojes de SLA.
- Distritos: importa los límites en GeoJSON o dibújalos en el mapa; cada incidencia recibe su distrito automáticamente.
- Idiomas: activa los idiomas en los que los vecinos pueden enviar avisos. Las categorías y las notificaciones se traducen por idioma.
- Invita a administradores: añade al menos dos para que el acceso nunca dependa de una sola persona.
Guías 6 min de lectura
Modela tus servicios y fija plazos de respuesta acordes con los compromisos municipales.
Cada categoría tiene un formulario de aviso, un departamento responsable y una política de SLA. Mantén la lista corta y comprensible para los vecinos: «La farola no funciona» funciona mejor que un código interno de activo.
Las políticas de SLA combinan un plazo para atender y otro para resolver, contados en horas laborables o naturales. Añade excepciones por prioridad o distrito; por ejemplo, 4 horas en lugar de 48 para peligros urgentes en la calzada.
Los cambios solo se aplican a las incidencias nuevas. Las existentes conservan el SLA con el que se crearon, para que tus informes sigan siendo fieles.
Guías 5 min de lectura
Envía cada incidencia al equipo adecuado automáticamente, con alternativas claras.
Las reglas se evalúan de arriba abajo; gana la primera acción de enrutar que coincida, mientras que las de notificar y priorizar se ejecutan siempre. Las condiciones pueden usar categoría, distrito, palabras clave, tipo de activo, hora del día y la puntuación de prioridad de la IA.
- Termina cada conjunto de reglas con una regla general hacia una cola de clasificación.
- Usa Probar reglas para reproducir las incidencias de la semana pasada antes de publicar.
- Cada cambio de regla se versiona y queda en el registro de auditoría.
Guías 4 min de lectura
Consigue que las brigadas trabajen desde la app móvil en su primera semana.
Empieza con una brigada y una categoría durante una semana y amplía después por distritos. Las brigadas inician sesión con SSO o un código de un solo uso; los dispositivos pueden compartirse entre turnos.
La app de campo funciona sin conexión: las brigadas pueden ver el trabajo asignado, añadir fotos y cerrar incidencias sin cobertura, y los cambios se sincronizan al reconectar. Por defecto se exigen fotos de antes y después para resolver; puedes flexibilizarlo por categoría.
Guías 3 min de lectura
Muestra a los vecinos qué se está arreglando sin exponer datos personales.
Las páginas de estado públicas muestran los niveles de servicio en directo y un mapa anonimizado del trabajo abierto. Nunca se publican nombres, datos de contacto ni fotos de personas; las direcciones exactas se redondean a la manzana más cercana.
Elige qué categorías aparecen, el intervalo de actualización (cada hora por defecto) y tu propio dominio. Las páginas cumplen WCAG 2.1 AA y están disponibles en todos los idiomas activos del espacio.
Guías 5 min de lectura
Prioriza, agrupa y resume incidencias, siempre con el equipo al mando.
CivicFlow AI sugiere una categoría y una prioridad para cada incidencia nueva, agrupa los avisos duplicados en un solo clúster y redacta respuestas para que el personal las revise. Las sugerencias muestran su evidencia y nada llega a un vecino sin la aprobación de una persona.
Los modelos se ejecutan en la región de datos de tu espacio. Tus datos no se usan para entrenar modelos compartidos con otros clientes. Puedes desactivar las funciones de IA por categoría o en todo el espacio.
Administración 7 min de lectura
Inicia sesión con tu proveedor de identidad y mantén las cuentas sincronizadas.
CivicFlow admite SAML 2.0 y OpenID Connect con cualquier proveedor de identidad basado en estándares. Al exigir SSO, el acceso con contraseña se desactiva para todos salvo los administradores de emergencia.
Con SCIM 2.0, los usuarios y grupos se crean, actualizan y desactivan desde tu directorio. Asigna grupos del directorio a roles y equipos de CivicFlow para que los permisos acompañen a las personas cuando cambian de departamento. Disponible en Enterprise.
Administración 4 min de lectura
Da a cada persona exactamente el acceso que necesita su trabajo.
Cinco roles predefinidos cubren a la mayoría de las ciudades:
- Administrador: ajustes del espacio, facturación, usuarios e integraciones.
- Responsable: reglas, SLA e informes de sus departamentos.
- Agente: clasificar, asignar y responder a los vecinos.
- Campo: trabajo asignado en la app de campo.
- Lector: paneles de solo lectura, p. ej. para concejales.
Los permisos pueden limitarse a departamentos o distritos. Los roles personalizados están disponibles en Enterprise.
Administración 3 min de lectura
Consulta quién hizo qué y cuándo, en cada cambio del espacio.
El registro de auditoría guarda inicios de sesión, cambios de permisos, ediciones de reglas y SLA, exportaciones, uso de claves de API y cada cambio en una incidencia. Las entradas solo se añaden y nadie puede editarlas, ni siquiera los administradores.
Filtra por persona, objeto o fecha, exporta a CSV o envía los eventos a tu SIEM. Los registros se conservan 12 meses por defecto y hasta 7 años en Enterprise.
Administración 4 min de lectura
Guarda los registros el tiempo que exige la ley, ni un día más.
Las políticas de conservación deciden cuándo se anonimizan los datos de contacto de los vecinos y cuándo se eliminan las incidencias cerradas. Una configuración habitual anonimiza a los vecinos 12 meses después de la resolución y conserva las incidencias anonimizadas para estadísticas.
Las políticas se ejecutan cada noche y quedan en el registro de auditoría. Las solicitudes de acceso y supresión de los vecinos se gestionan desde su perfil o mediante la API de vecinos.
¿No encuentras lo que buscas?
Nuestro equipo de soporte responde en un día laborable, y antes en Growth y Enterprise. Si algo no va bien, consulta primero la página de estado.