Tools de pqrs
El dominio pqrs es el flujo de peticiones, quejas,
reclamos, sugerencias y denuncias de un cliente: clasificar un
radicado, responderlo, aprobarlo o devolverlo, y el carril aparte
para casos de Recursos Humanos. Cada tool es una cáscara fina sobre
una RPC — la máquina de estados y las validaciones viven en la base
(pqrs.*), nunca acá. Corre con
tu propia sesión, nunca con una clave de servicio:
ctx.db solo expone asUser, así que
ninguna tool puede saltear la RLS de pg-dynamo-<env>.
La bandeja y el detalle (pqrs_list_requests,
pqrs_get_request, pqrs_get_request_events,
pqrs_list_roles) son SECURITY INVOKER: el
gate lo aplica la RLS de la tabla, no un WHERE a mano
en la función. Un caller sin acceso ve una lista vacía o
null, nunca un error — "no existe" y "no tenés acceso"
son indistinguibles, igual que en las transiciones de estado. Antes
de pqrs_initialize_project, la app pqrs
tiene que estar habilitada en el proyecto y el usuario tener acceso
— eso es auth_set_project_app y
auth_set_app_access (ver tools
de auth), los pasos 1-2 del alta de un cliente.
Cada rol ve un carril distinto, y algunos son mutuamente
excluyentes por diseño. Un radicado de Recursos Humanos
(pqrs_route_to_hr) deja de ser visible para el
asistente y para gerencia — son datos laborales, solo el rol
hr los toca. Y quien responde un radicado
(pqrs_answer_request) no puede aprobar su propia
respuesta: pqrs_approve_request es del asistente de
procesos. Ninguna de las 27 de escritura es idempotente en el
sentido de "corrila dos veces sin efecto" — la única excepción es
pqrs_grant_role, que sí tolera otorgar el mismo
(usuario, rol, área) más de una vez sin duplicar ni fallar. La
nueva pqrs_create_smoke_request es aparte: crea un
radicado marcado is_synthetic, invisible para el
semáforo, los indicadores y el rastreo público — pensada para que
un smoke automático ejercite el resto de las transiciones sin
ensuciar datos de cliente, y exige global-admin,
igual que pqrs_initialize_project.
Lectura (20)
Ve solo lo que la RLS (o, en los indicadores, el filtro por
project_id) deja pasar — pedir el proyecto o el
radicado de otro cliente no es un error, es [] o
null.
| Tool | Qué hace | Inputs | Qué permiso hace falta | Ejemplo de prompt |
|---|---|---|---|---|
pqrs_list_catalog |
Los catálogos activos de un proyecto (tipos de solicitud,
causas, áreas, propiedades y perfiles del peticionario) — de
ahí salen los ids que piden
pqrs_classify_request y
pqrs_submit_request. Filtro por
kind opcional.
|
project_id (uuid) ·
kind (enum, opcional)
|
Token scope read. SECURITY INVOKER
— cualquier staff del proyecto.
|
"Dame el catálogo de causas del proyecto Acme." |
pqrs_list_requests |
La bandeja: los radicados visibles para el caller en un
proyecto, con semáforo y días transcurridos ya calculados
(misma definición que los indicadores). Filtros de
status/routing opcionales, sobre lo
que la RLS ya dejó pasar — un asistente ve lo externo, un
responder solo sus áreas, RRHH solo lo suyo.
|
project_id (uuid) ·
status (enum, opcional) ·
routing (enum, opcional)
|
Token scope read. SECURITY INVOKER
— la RLS decide qué filas llegan.
|
"Mostrame los radicados abiertos del proyecto Acme." |
pqrs_get_request |
El expediente completo de UN radicado: datos del solicitante,
descripción, respuesta, semáforo y estado. Si se cerró por
traslado a un tercero trae
close_kind="third_party_transfer" y los datos del
traslado (transfer_third_party,
transfer_informed_detail,
transfer_informed_at). Mismo gate que la
bandeja. Para la bitácora está
pqrs_get_request_events, aparte.
|
request_id (uuid) |
Token scope read. SECURITY INVOKER
— sin acceso, lista vacía, nunca un error.
|
"Mostrame el detalle del radicado X." |
pqrs_get_request_events |
La bitácora de un radicado: quién hizo qué y cuándo, en orden
cronológico. Hereda EXACTAMENTE el gate de
pqrs_get_request — quien no ve el radicado
tampoco ve su bitácora.
|
request_id (uuid) |
Token scope read. SECURITY INVOKER,
mismo gate que pqrs_get_request.
|
"Dame la bitácora de eventos del radicado X." |
pqrs_list_roles |
Quién tiene qué rol (y qué área, si aplica) en el equipo interno de PQRS de un proyecto — visible para cualquier staff, no solo el asistente: que un responder sepa a quién escalar es parte del trabajo. | project_id (uuid) |
Token scope read. SECURITY INVOKER
— cualquier staff del proyecto.
|
"¿Quién es responder del área de Cartera en el proyecto Acme?" |
pqrs_list_project_users |
Los usuarios del proyecto con la app pqrs habilitada
(project_app_users), con su email y nombre — de
acá sale a quién ofrecer en pqrs_grant_role en
vez de pedir un user_id a mano. Solo usuarios
activos (deactivated_at nulo).
|
project_id (uuid) |
Token scope read. Rol asistente de procesos o
global-admin — mismo gate que pqrs_grant_role/
pqrs_list_roles.
|
"¿A quién le puedo asignar un rol de PQRS en el proyecto Acme?" |
pqrs_indicadores_resumen |
Resumen ejecutivo de cumplimiento de un proyecto: total,
abiertas, cerradas, incumplidas, porcentaje de cumplimiento y
promedio de días de respuesta, opcionalmente en una ventana
de fechas. INCUMPLIDA incluye la cerrada fuera de término Y
la abierta y vencida — contar solo la cerrada tarde haría que
el cumplimiento mejorara cuanto menos se cierra. Los
trasladados a un tercero (pqrs_transfer_request)
cuentan en el total y en las cerradas pero NO en el
cumplimiento (ni incumplidas, ni porcentaje, ni promedio);
trasladadas dice cuántos hubo. Sin radicados que
cuenten en la ventana, el porcentaje es null,
no 100. Los tipos que no miden plazo (sugerencias y
felicitaciones, tipos sin investigación) también cuentan en el
total y en las cerradas pero no en el cumplimiento;
total_con_plazo y total_sin_plazo los
separan.
|
project_id (uuid) ·
desde/hasta (fecha, opcional)
|
Token scope read. Ve solo los proyectos del
usuario — el id de otro cliente devuelve ceros, no un error.
|
"¿Cómo va el cumplimiento de PQRS del proyecto Acme este mes?" |
pqrs_indicadores_por_catalogo |
El mismo cumplimiento, cortado por tipo de solicitud, causa,
área, propiedad o perfil del peticionario
(requester_profile) — una fila por ítem del
catálogo, incluidos los que tienen total 0 (omitirlos no deja
distinguir "no hubo" de "no se midió"). Misma definición de
incumplimiento que el resumen. Mide SOLO el cliente externo:
los radicados del carril de RRHH no cuentan acá, y los que no
declararon perfil no suman fila.
|
project_id (uuid) ·
kind (enum) ·
desde/hasta (fecha, opcional)
|
Token scope read. Ve solo los proyectos del
usuario.
|
"Desglosá el cumplimiento por causa del proyecto Acme." |
pqrs_indicadores_por_estado |
Total de radicados por los 8 valores de
pqrs.request_status (received/assigned/in_review/
returned/closed/hr_pending/hr_in_progress/hr_closed),
opcionalmente en una ventana de fechas. Incluye los estados
SIN radicados, con total 0 — completa la familia "total por
estado" que pqrs_indicadores_resumen no cubre
entera (ese da solo abiertas/cerradas).
|
project_id (uuid) ·
desde/hasta (fecha, opcional)
|
Token scope read. Ve solo los proyectos del
usuario.
|
"¿Cuántos radicados hay en cada estado del proyecto Acme?" |
pqrs_indicadores_por_canal |
Conteo, incumplidas, porcentaje de cumplimiento del término y
promedio de días por CANAL DE ORIGEN: canal público (QR o
enlace), teléfono, WhatsApp, correo electrónico, visita y
"panel (canal no registrado)" para los radicados del panel
anteriores al registro del canal. SIEMPRE las 6 filas, con total
0 y porcentaje null si no hubo casos. Mismo criterio
de incumplida que pqrs_indicadores_por_catalogo;
mide SOLO el cliente externo (routing=external) y un
traslado a un tercero suma al total pero no al cumplimiento.
|
project_id (uuid) ·
desde/hasta (fecha, opcional)
|
Token scope read. Ve solo los proyectos del
usuario.
|
"¿Por qué canal llegan más radicados al proyecto Acme y en cuál se cumple menos el término?" |
pqrs_indicadores_cruce_causa |
Matriz de causa contra un segundo eje: property
(propiedad/copropiedad) o month (mes de
recepción). Con eje property incluye TODAS las
propiedades del catálogo, incluso con total 0 en cada causa;
con eje month solo entran los meses que tuvieron
al menos un radicado.
|
project_id (uuid) ·
eje (enum: property|month) ·
desde/hasta (fecha, opcional)
|
Token scope read. Ve solo los proyectos del
usuario.
|
"Cruzá causa contra propiedad para el proyecto Acme." |
pqrs_indicadores_internos |
Conteos del carril INTERNO (colaboradores, routing=hr,
a cargo de Gestión de la Felicidad), aparte de los del cliente
externo: total, abiertas, cerradas, anónimas (sin correo) y total
por estado hr_pending, hr_in_progress y
hr_closed, opcionalmente en una ventana de fechas de
radicación. SIN porcentaje de cumplimiento: el término legal del
PQRS externo no aplica a este carril. Los cuatro indicadores de
arriba miden SOLO el cliente externo
(routing=external).
|
project_id (uuid) ·
desde/hasta (fecha, opcional)
|
Token scope read. Lo ven hr y
global-admin; para cualquier otro rol da ceros (RLS), nunca un
error.
|
"¿Cuántos casos internos de RRHH hay abiertos en el proyecto Acme?" |
pqrs_indicadores_plazo_interno_por_area |
Cumplimiento del PLAZO INTERNO del área (el segundo reloj, no el
término al peticionario), por área: total, incumplidas y
porcentaje, sobre los radicados CON plazo interno recibidos en la
ventana de fechas. Cuenta para el área que tiene el caso HOY (un
caso redirigido cuenta para el área nueva). INCUMPLIDA incluye la
abierta y vencida en plazo interno. Lista el catálogo de áreas
COMPLETO: un área sin casos sale con total 0 y porcentaje
null, no 100. No cambia ninguna cifra de
pqrs_indicadores_resumen.
|
project_id (uuid) ·
desde/hasta (fecha, opcional)
|
Token scope read. Ve solo los proyectos del
usuario — el id de otro cliente devuelve cero filas, no un
error.
|
"¿Qué áreas están incumpliendo su plazo interno en el proyecto Acme?" |
pqrs_list_alert_recipients |
Los destinatarios configurados hoy para las alertas internas de un proyecto (quién recibe aviso por rol o área). | project_id (uuid) |
Token scope read. SECURITY INVOKER
— cualquier staff del proyecto.
|
"¿Quién recibe las alertas de PQRS del proyecto Acme?" |
pqrs_list_intake_channels |
Los canales de intake configurados en un proyecto (incluido el QR client-side de cada uno). | project_id (uuid) |
Token scope read. SECURITY INVOKER
— cualquier staff del proyecto.
|
"Dame los canales de intake activos del proyecto Acme." |
pqrs_list_policy_documents |
Historial de versiones de la Política de Tratamiento de Datos publicadas para el proyecto — quién subió cada una, cuándo, su sha256 y cuál es la vigente hoy. La carga del PDF es binaria y no tiene tool: la hace un humano desde el panel (Configuración → Política de datos). | project_id (uuid) |
Token scope read. SECURITY INVOKER
— la RLS de pqrs.policy_documents (is_staff) es
el gate, mismo criterio que
pqrs_list_alert_recipients.
|
"¿Qué versiones de la política de datos tiene publicadas el proyecto Acme?" |
pqrs_list_sla_policies |
Las políticas de SLA VIGENTES de un proyecto: días de
término, si se cuentan en calendario o hábiles, con qué
calendario de festivos, umbrales de alerta. Un proyecto
puede tener MÁS de una vigente a la vez — la general (sin
tipo de solicitud) y una por cada tipo que la sobreescriba —
las dos salen, nunca una sola oculta a la otra. Es la
lectura que faltaba junto a
pqrs_upsert_sla_policy, que solo publica.
|
project_id (uuid) |
Token scope read. SECURITY INVOKER
— la RLS pqrs.is_staff es el gate, solo el
staff del proyecto ve esta lista.
|
"¿Qué política de SLA tiene vigente el proyecto Acme?" |
pqrs_list_form_fields |
Los campos del formulario público de un proyecto:
field_key, etiqueta, ayuda, si es obligatorio,
si es visible y su orden. Es la lectura que hace falta ANTES
de pqrs_update_form_field para mostrar el
estado actual.
|
project_id (uuid) |
Token scope read. SECURITY INVOKER
— la RLS pqrs.is_staff es el gate, staff del
proyecto ve los campos.
|
"¿Qué campos tiene el formulario público del proyecto Acme?" |
pqrs_list_channel_form_fields |
Los campos del formulario de UN canal de intake con su
obligatoriedad: la del proyecto, el override del canal
(null = hereda), la efectiva que exige el radicado y
si el campo es intocable para la audiencia del canal. Es la
lectura que hace falta ANTES de
pqrs_set_channel_form_field.
|
project_id (uuid) ·
channel_id (uuid)
|
Token scope read. Rol
asistente de procesos, o global-admin.
|
"¿Qué campos del formulario son obligatorios en el canal de la sede Norte del proyecto Acme?" |
pqrs_get_requester_profile_config |
Estado del campo "perfil del peticionario" del formulario
público: si se pide (enabled), si es obligatorio
(required), qué perfil se envía automáticamente al
carril de RRHH (hr_profile_id, null =
ninguno), si el carril de RRHH está habilitado, cuántos perfiles
activos hay en el catálogo y cuántos correos del rol
hr recibirían un caso enrutado
(hr_destinatarios: 0 con una regla puesta = nadie se
entera). Es la lectura que hace falta ANTES de
pqrs_set_requester_profile_config.
|
project_id (uuid) |
Token scope read. Rol
asistente de procesos, o global-admin.
|
"¿Está encendido el perfil del peticionario en el formulario del proyecto Acme y adónde enruta?" |
Escritura (27)
Todas actúan sobre un radicado (o el proyecto entero, la primera) ya
existente y devuelven el estado resultante. Confirmá el ambiente con
dynamo_session_status (ver tools de
ops) antes de cualquiera de estas.
| Tool | Qué hace | Inputs | Qué permiso hace falta | Ejemplo de prompt |
|---|---|---|---|---|
pqrs_initialize_project |
Pone en marcha PQRS en un proyecto ya habilitado: materializa
los 5 tipos de solicitud, los campos del formulario público,
las plantillas de correo, un SLA por defecto de 15 días
calendario y los destinatarios de alertas por rol. Paso 3 del
alta de un cliente (1-2 son de auth).
Idempotente y NO destructiva: si el proyecto
ya estaba inicializado devuelve initialized:false
y no toca nada — no sirve para resetear la configuración que
el cliente editó después.
|
project_id (uuid) |
Token scope write. Gate real:
global-admin ONLY.
|
"Inicializá PQRS en el proyecto Acme." |
pqrs_classify_request |
Clasifica un radicado nuevo: le asigna causa y área
responsable, y lo pasa de received a
assigned — recién ahí es visible para el área.
La causa y el área tienen que ser del mismo
proyecto del radicado; de otro cliente se rechaza
aunque seas asistente legítimo. Solo desde
received: un radicado ya clasificado no se
re-clasifica.
|
request_id (uuid) ·
cause_id (uuid) ·
area_id (uuid)
|
Token scope write. Rol
asistente de procesos del proyecto.
|
"Clasificá el radicado X con causa 'Facturación' y área 'Cartera'." |
pqrs_close_by_notification |
Cierra NOTIFICANDO un radicado de un tipo que NO requiere
investigación (sugerencia y felicitación por defecto;
configurable por proyecto con
requires_investigation en
pqrs_upsert_catalog_item): lo pasa de
received o assigned a
closed SIN respuesta formal ni aprobación, y avisa
al solicitante y a los responders del área. Si el radicado
todavía no está clasificado (received),
area_id es obligatorio y cause_id
opcional; en assigned se usa el área ya asignada y
ambos se ignoran. Un radicado de un tipo con plazo (petición,
queja, reclamo) se RECHAZA sin tocar nada: se cierra por el flujo
de respuesta y aprobación. Estos radicados quedan fuera del
indicador de cumplimiento pero cuentan en el total. No se
reabre.
|
request_id (uuid) ·
area_id (uuid, opcional) ·
cause_id (uuid, opcional)
|
Token scope write. Rol
asistente de procesos del proyecto.
|
"Cerrá notificando la sugerencia X y asignala al área de Cartera." |
pqrs_route_to_hr |
Marca un radicado como presentado por un colaborador de la
organización y lo saca del flujo de cliente externo hacia el
carril de Recursos Humanos (hr_pending). Solo
desde received. A partir de ahí deja de ser
visible para el asistente y para gerencia. Exige que el
carril esté habilitado en el proyecto
(settings.hr_lane_enabled).
|
request_id (uuid) |
Token scope write. Rol
asistente de procesos del proyecto.
|
"Este radicado lo presentó un empleado, mandalo al carril de RRHH." |
pqrs_transfer_request |
Cierra un radicado que NO es del alcance de la organización
trasladándolo a un tercero (otra entidad o empresa), y deja
registro de a quién se trasladó y de qué se le informó al
peticionario. Solo radicados externos en
received, assigned o
returned (uno en in_review se
devuelve primero). Queda closed con
close_kind="third_party_transfer": entra al
total y a las cerradas pero NO al cumplimiento del plazo, y
suma en trasladadas de
pqrs_indicadores_resumen. El peticionario recibe
el aviso por correo y lo ve en su link de seguimiento. No se
reabre.
|
request_id (uuid) ·
third_party (texto, no vacío) ·
informed_detail (texto, no vacío)
|
Token scope write. Rol
asistente de procesos del proyecto — no el
responder del área.
|
"El radicado X no es de nuestra competencia: trasladalo a la Superintendencia e informale al peticionario a dónde fue." |
pqrs_answer_request |
Registra la respuesta de un área a un radicado. Por defecto
NO cierra: queda en in_review esperando la
aprobación del asistente (ciclo de dos pasos) — si el
proyecto tiene settings.requires_approval:false,
cierra directo. Válida desde assigned o
returned. La respuesta no puede estar vacía.
|
request_id (uuid) ·
answer (texto, no vacío)
|
Token scope write. Rol
responder DEL ÁREA de ese radicado — no
alcanza con ser responder del proyecto.
|
"Respondé el radicado X: 'Se realizó el ajuste solicitado en la próxima facturación.'" |
pqrs_approve_request |
Aprueba la respuesta de un área y cierra el
radicado. Quien respondió no puede aprobar su propia
respuesta. Solo desde in_review. Al cerrar
calcula los días de respuesta con la política de SLA
congelada en el radicado (no la vigente
hoy) y, si se pasó del término, registra el incumplimiento
— cerrar no lo borra.
|
request_id (uuid) |
Token scope write. Rol
asistente de procesos del proyecto.
|
"Aprobá la respuesta del radicado X." |
pqrs_return_request |
Devuelve una respuesta al área responsable para que la
corrija, con el motivo. Solo desde in_review.
El motivo es obligatorio y no puede ser
espacios en blanco. El radicado vuelve a
returned; el semáforo NO se reinicia — los días
siguen corriendo desde la recepción original.
|
request_id (uuid) ·
reason (texto, no vacío)
|
Token scope write. Rol
asistente de procesos del proyecto.
|
"Devolvé la respuesta del radicado X, falta adjuntar el soporte." |
pqrs_reassign_request |
Reasigna un radicado ya clasificado a OTRA área del mismo
proyecto, con el motivo. Solo desde assigned o
returned. El motivo es obligatorio
y queda en la bitácora junto con el área anterior y la nueva.
El área destino tiene que ser un área activa del proyecto y
distinta de la actual. El estado NO cambia y el plazo NO se
reinicia — los días siguen corriendo desde la recepción
original. Se avisa a los responders del área nueva y a los
asistentes; el responder saliente deja de ver el radicado.
|
request_id (uuid) ·
area_id (uuid) ·
reason (texto, no vacío)
|
Token scope write. Rol
responder del área que hoy tiene el radicado,
o asistente de procesos. Gerencia no: es de
solo lectura.
|
"Pasá el radicado X al área de Cartera, lo clasificamos mal en Facturación." |
pqrs_update_hr_case |
Actualiza el estado de un radicado del carril de Recursos
Humanos. Estados válidos: hr_pending,
hr_in_progress, hr_closed. No
aplica a radicados de cliente externo.
|
request_id (uuid) ·
status (enum: hr_pending |
hr_in_progress | hr_closed)
|
Token scope write. Rol hr —
ni el asistente ni gerencia ven estos radicados.
|
"Pasá el caso de RRHH X a 'en progreso'." |
pqrs_submit_request |
Radica una PQRS EN NOMBRE de un tercero desde el panel: llegó
por teléfono, WhatsApp, correo electrónico o en una visita y
el equipo la carga — distinto del canal anónimo del
ciudadano, sin captcha/throttle/dedupe porque el caller YA
está autenticado. Mismo consecutivo y mismo término que el
canal público. Exige el canal de origen
(origin_channel), la declaración de que el
solicitante autorizó el tratamiento de sus datos
(submitter_authorized), una política de datos
publicada en el proyecto, el tipo de solicitud, los campos
obligatorios configurados del formulario y una política de SLA
vigente. Registra el canal, quién radicó y la versión de la
política. Devuelve el consecutivo y el
tracking_token del radicado nuevo.
|
project_id (uuid) ·
submitter_name · submitter_email ·
submitter_phone (opcional) ·
description ·
request_type_id (uuid) ·
origin_channel (enum: phone|whatsapp|email|visit) ·
submitter_authorized (siempre true) ·
property_id (uuid, opcional) ·
property_text (texto, hasta 200, opcional) ·
extra_fields (objeto de texto, opcional)
|
Token scope write. Rol
asistente de procesos o
comercial (solo radica) del proyecto.
|
"Radicá una PQRS a nombre de Juan Pérez (juan@correo.com): 'no me llegó la factura de agosto'." |
pqrs_grant_role |
Da de alta a un usuario en el equipo interno de PQRS de un
proyecto (asistente, responder de un área, gerencia, RRHH o
comercial: solo radica, sin área).
Un responder EXIGE área; los demás roles la rechazan — el
área tiene que ser del MISMO proyecto. IDEMPOTENTE: otorgar
el mismo (usuario, rol, área) dos veces no duplica ni falla.
Esto da acceso al DOMINIO pqrs — la app en sí
(project_app_users) la habilita
auth_set_app_access, aparte.
|
project_id (uuid) · user_id (uuid) ·
role (enum: assistant|responder|management|hr|commercial) ·
area_id (uuid, opcional)
|
Token scope write. Rol
asistente de procesos del proyecto, o
global-admin.
|
"Agregá a María como responder del área de Cartera en el proyecto Acme." |
pqrs_create_smoke_request |
Crea un radicado SINTÉTICO en un proyecto, para que el smoke
automático pueda ejercitar las transiciones sin ensuciar los
datos del cliente. La marca is_synthetic es
INMUTABLE: excluye el radicado del semáforo, los
indicadores, las alertas de SLA y el rastreo público desde
el instante en que se crea, y nunca dispara correo. Se
descarta a las 24 horas. Devuelve el id del radicado, que es
la única forma de consultarlo — por token no es visible.
|
project_id (uuid) |
Token scope write. Gate real:
global-admin ONLY — mismo criterio que
pqrs_initialize_project.
|
"Creá un radicado sintético en el proyecto de pruebas para el smoke." |
pqrs_revoke_role |
Retira a un usuario del equipo interno de PQRS de un
proyecto (incluido comercial) — cierra el trío junto a
grant_role/list_roles.
|
project_id (uuid) · user_id (uuid) |
Token scope write. Rol
asistente de procesos del proyecto, o
global-admin.
|
"Sacá a Juan del equipo de PQRS del proyecto Acme." |
pqrs_upsert_catalog_item |
Crea o edita un ítem del catálogo (tipo de solicitud, causa,
área, propiedad o perfil del peticionario) de un proyecto —
desde el panel, sin SQL manual. Idempotente por (proyecto, kind,
code). requires_investigation (solo
request_type): false = el tipo se cierra
notificando (pqrs_close_by_notification) y queda
fuera del indicador de cumplimiento; omitido conserva el valor
vigente (un tipo nuevo nace en true). No afecta
radicados ya creados.
|
project_id (uuid) ·
kind (enum: request_type|cause|area|property|requester_profile) ·
code · label ·
sort_order (int, opcional) ·
is_active (booleano, opcional) ·
requires_investigation (booleano, opcional)
|
Token scope write. Rol
asistente de procesos del proyecto, o
global-admin.
|
"Agregá la causa 'Facturación duplicada' al catálogo del proyecto Acme." |
pqrs_deactivate_catalog_item |
Da de baja (lógica, no borra) un ítem del catálogo de un proyecto. | project_id (uuid) · item_id (uuid) |
Token scope write. Rol
asistente de procesos del proyecto, o
global-admin.
|
"Desactivá la causa 'Otros' del catálogo del proyecto Acme." |
pqrs_upsert_sla_policy |
Define la política de SLA de un proyecto: términos al
peticionario en días calendario o hábiles, con umbrales de
alerta. Publica una versión NUEVA: los radicados ya abiertos
conservan su fecha de vencimiento. Opcionalmente un plazo
INTERNO del área (segundo reloj) con
internal_term_days y sus internal_*:
van todos o ninguno, y OMITIRLOS publica una versión SIN plazo
interno (es versión nueva, no merge) — para cambiar solo el
término al peticionario, leé la vigente con
pqrs_list_sla_policies y reenviá sus internos. El
plazo interno no cuenta para el cumplimiento al peticionario.
|
project_id (uuid) · name ·
term_days (int) ·
day_basis (enum: calendar|business) ·
alert_offsets (array de int) ·
offset_basis (enum: elapsed|before_due) ·
request_type_id (uuid, opcional) ·
holiday_calendar (opcional) ·
internal_term_days,
internal_day_basis,
internal_alert_offsets,
internal_offset_basis,
internal_start (enum: assigned|received) (opcionales)
|
Token scope write. Rol
asistente de procesos del proyecto, o
global-admin.
|
"Cambiá el SLA de PQRS del proyecto Acme a 20 días." |
pqrs_set_alert_recipients |
Reemplaza la lista COMPLETA de destinatarios de alerta
interna de un proyecto — no agrega, pisa. clock
elige DE QUÉ RELOJ es la lista: requester (default,
término al peticionario) o internal (plazo interno
del área); reemplaza solo la lista de ese reloj y la del otro
queda intacta.
|
project_id (uuid) ·
recipients (array) ·
clock (enum: requester|internal, opcional)
|
Token scope write. Rol
asistente de procesos del proyecto, o
global-admin.
|
"Poné a estas 3 personas como destinatarias de alerta en el proyecto Acme." |
pqrs_upsert_email_template |
Crea o edita una plantilla de correo del proyecto (las que
salen a clientes/staff en cada transición), incluidos los dos
avisos del cierre sin investigación (submitter_notice
al ciudadano, internal_notice al área) y la alerta
del plazo interno (internal_term_alert).
|
project_id (uuid) · template_key
(enum) · asunto/cuerpo (texto)
|
Token scope write. Rol
asistente de procesos del proyecto, o
global-admin.
|
"Editá el correo de cierre de radicado del proyecto Acme." |
pqrs_update_settings |
Actualiza los settings generales de PQRS de un proyecto. | project_id (uuid) · settings propios |
Token scope write. Rol
asistente de procesos del proyecto, o
global-admin.
|
"Actualizá la configuración general de PQRS del proyecto Acme." |
pqrs_create_intake_channel |
Crea un canal de intake nuevo para un proyecto, con su QR
client-side — no idempotente, cada llamada crea un canal
distinto. audience es external (por
defecto: cliente externo, nombre y correo siempre
obligatorios) o internal (colaboradores: nombre,
correo y celular opcionales; lo radicado entra directo al
carril de RRHH y no cuenta en los indicadores del cliente
externo). Un canal internal exige
hr_lane_enabled en el proyecto y no puede existir
sin captcha, ni siquiera para un global-admin. La audiencia no
se cambia después: se revoca el canal y se crea otro.
|
project_id (uuid) ·
label (texto) ·
property_id (uuid, opcional) ·
requires_captcha (booleano, opcional) ·
audience (enum: external|internal, opcional)
|
Token scope write. Rol
asistente de procesos del proyecto, o
global-admin.
|
"Creá un canal de intake nuevo para recepción presencial en el proyecto Acme." |
pqrs_revoke_intake_channel |
Revoca un canal de intake de un proyecto. | project_id (uuid) · channel_id (uuid) |
Token scope write. Rol
asistente de procesos del proyecto, o
global-admin.
|
"Revocá el canal de intake viejo del proyecto Acme." |
pqrs_update_form_field |
Edita la etiqueta, el texto de ayuda y la obligatoriedad de
un campo del formulario público. NUNCA cambia
field_key, sort_order ni
is_visible — solo texto y obligatoriedad. Los 4
campos que sostienen el resto del dominio
(description, accepts_policy,
submitter_email, request_type) no
se pueden volver opcionales: el servidor rechaza el intento
aunque seas global-admin. help es de TRES
ESTADOS: omitido no toca la ayuda actual, "" la
borra, texto la reemplaza. Sin required, la
obligatoriedad actual no se toca.
|
project_id (uuid) · code (texto) ·
label (1-120 caracteres) ·
help (opcional, hasta 300 caracteres) ·
required (booleano, opcional)
|
Token scope write. Rol
asistente de procesos del proyecto, o
global-admin.
|
"Marcá como obligatorio el campo de teléfono del formulario público del proyecto Acme." |
pqrs_set_channel_form_field |
Fija la obligatoriedad de un campo del formulario en UN canal
de intake, por encima de la del proyecto
(pqrs_update_form_field). required
true/false fija el override del canal;
null lo borra y el canal vuelve a heredar lo del
proyecto. Etiqueta, ayuda y visibilidad siguen siendo del
proyecto. En un canal external nombre y correo
nunca se vuelven opcionales; en uno internal,
description, request_type y
accepts_policy tampoco: el servidor rechaza el
intento aunque seas global-admin. El canal tiene que ser del
mismo proyecto y no estar revocado. Devuelve la fila efectiva
del campo.
|
project_id (uuid) ·
channel_id (uuid) ·
field_key (texto) ·
required (booleano o null)
|
Token scope write. Rol
asistente de procesos del proyecto, o
global-admin.
|
"En el canal interno del proyecto Acme, hacé opcional el campo de celular." |
pqrs_set_requester_profile_config |
Enciende o apaga el campo "perfil del peticionario" del
formulario público y fija qué perfil va SOLO al carril de RRHH
(Gestión de la Felicidad). ESTADO COMPLETO, no parcial: cada
llamada fija el campo Y la regla, así que omitir
hr_profile_id BORRA la regla. Para enrutar a los
colaboradores, hr_profile_id es el id del ítem
"colaborador" del catálogo requester_profile
(pqrs_list_catalog). Encender exige al menos un
perfil activo (se cargan con
pqrs_upsert_catalog_item, kind
requester_profile); la regla exige el carril de RRHH
habilitado; apagar exige hr_profile_id vacío. El
campo nace obligatorio; pqrs_update_form_field puede
volverlo opcional. Queda auditado. Leé el estado antes con
pqrs_get_requester_profile_config.
|
project_id (uuid) ·
enabled (booleano) ·
hr_profile_id (uuid o null, opcional)
|
Token scope write. Rol
asistente de procesos del proyecto, o
global-admin.
|
"Encendé el perfil del peticionario en el proyecto Acme y mandá los colaboradores a RRHH." |
pqrs_return_hr_to_external |
Devuelve al canal externo un radicado del carril de RRHH que no
es un caso laboral (típicamente un peticionario que se declaró
"colaborador" por error y el sistema lo enrutó solo). Solo desde
hr_pending o hr_in_progress.
El motivo es obligatorio (hasta 1000
caracteres) y queda en la bitácora con quién lo devolvió. El
radicado vuelve a received para que el asistente lo
clasifique, y el asistente recibe el aviso. El plazo NO se
reinicia: los días siguen corriendo desde la recepción original.
Después de devolverlo, quien solo tiene el rol
hr deja de ver el caso.
|
request_id (uuid) ·
reason (texto, no vacío)
|
Token scope write. Rol hr — ni el
asistente ni gerencia pueden hacerlo.
|
"Este caso de RRHH no es laboral, devolvelo al canal externo: lo radicaron por error como colaborador." |
Para errores concretos de estas tools: Troubleshooting.
Para correr los MCPs en stdio localmente en vez del
gateway: Para desarrolladores.