Límite de frecuencia (reglas de contacto)

Las reglas de contacto son el límite de frecuencia de Joryio: límites de espacio de trabajo sobre cuántas veces puedes «contactar» a cada usuario, por canal y franja temporal. Cuando un usuario alcanza un límite, los envíos posteriores se omiten hasta que se reinicie la franja, sin importar qué campaña o recorrido intente llegar a él.

Abre Configuración → Reglas de contacto en el panel para configurarlas. (Para verlas se requiere el permiso touching_rules:read.)

Anatomía de una regla

Cada tarjeta de canal incluye un interruptor y de 1 a 4 reglas. Cada regla indica:

Máximo de N mensajes por día / semana / mes, aplicable a todos los mensajes o solo a mensajes con determinadas etiquetas.

Las reglas de un canal se aplican con Y: un envío debe estar por debajo del límite de cada regla aplicable, y la primera regla que alcance o supere su límite bloquea el envío.

Alcance de las etiquetas

• Una regla sin etiquetas se aplica a todos los mensajes de ese canal.
• Una regla con etiquetas solo cuenta y limita mensajes que lleven al menos una de esas etiquetas (O dentro de la regla). Las etiquetas proceden del mismo conjunto de todo el espacio de trabajo que usas en campañas, recorridos y plantillas; consulta Etiquetas.

Esto permite políticas por capas, como indica la propia página de configuración: «3 Push/día para #promo Y 10 Push/día en total» son dos límites útiles, no una pareja redundante. Si dos reglas de la misma tarjeta comparten la franja y el alcance de etiquetas, la página las marca como Redundantes: gana la más estricta, así que añade una etiqueta para diferenciarlas o elimina una.

Canales

Canal	Recomendación en producto
Notificaciones Push	Recomendado: 5–10 al día para una interacción óptima.
Mensajes de Email	Recomendado: 3–7 a la semana para evitar quejas de spam.
Mensajes SMS	Recomendado: 1–3 a la semana; SMS es el canal más caro.
Mensajes in-app	Recomendado: 10–20 al día; es el canal menos intrusivo.
Mensajes de WhatsApp	Recomendado: 3–5 al día para cumplir las políticas de WhatsApp.
Mensajes de Viber	Recomendado: 3–5 al día para cumplir las políticas de Viber.
Llamadas de webhook	Recomendado: 30–50 al día, según la integración.

Todos los canales vienen desactivados de forma predeterminada: no se limita nada hasta que actives un canal (o el límite entre canales) y guardes.

El límite entre canales (regla principal)

Sobre las tarjetas por canal está el límite entre canales. Cuando está activado, es un techo para el total de contactos del usuario en todos los canales combinados: un usuario puede estar por debajo de todos los límites por canal y aun así bloquearse porque se alcanzó el techo combinado. Admite las mismas 1–4 reglas con alcance por etiqueta que cualquier canal. Las impresiones in-app también cuentan para este techo.

La barra de resumen de la página lo visualiza: el presupuesto sin etiquetas de cada canal activado se apila en una barra y una línea discontinua marca el techo entre canales. Si los presupuestos por canal suman más que el techo, el exceso se muestra como «limitado»: gana el techo. (Las reglas con etiquetas limitan subconjuntos y no se incluyen en ese resumen).

Qué cuenta como «contacto»

Los límites se cuentan sobre el historial real y registrado de mensajes del usuario, no por campaña:

• Email, SMS, Push, WhatsApp, Viber y webhook - cada mensaje enviado correctamente (el evento message.sent).
• In-app - los mensajes in-app los obtiene tu App en vez de recibirlos por Push, por lo que cuenta la impresión (el evento in_app.displayed).
• Contar entregas fallidas (en Ajustes adicionales, desactivado de forma predeterminada) - al activarlo, los intentos de entrega fallidos (message.failed) también consumen presupuesto en los canales de estilo Push. In-app no tiene evento de fallo, por lo que no se aplica ahí.

Como el recuento lee el flujo de eventos compartido, los contactos de campañas y recorridos se acumulan juntos frente a los mismos límites.

Franjas temporales

«Por día / semana / mes» se mide según la zona horaria del espacio de trabajo (definida en su configuración), no según el reloj del servidor:

• Día - desde medianoche, hora del espacio de trabajo.
• Semana - desde el lunes a las 00:00, hora del espacio de trabajo (semana ISO).
• Mes - desde el día 1 del mes, hora del espacio de trabajo.

Las franjas están ancladas al calendario, no son móviles: al cruzar el límite, el recuento de todos vuelve a cero.

Qué ocurre con un envío bloqueado

Un envío que alcanza un límite se omite, no se retrasa. (A diferencia de las [horas de silencio], que aplazan un mensaje hasta el final de la franja de silencio).

• Campañas - el usuario que supera el límite se omite durante el envío y se registra un evento de plataforma message.skipped con el motivo frequency_cap, para que puedas ver exactamente quién se limitó y por qué. Consulta Eventos de plataforma.
• Recorridos - el nodo de mensaje se omite para ese usuario y el recorrido continúa por su ruta; la omisión se registra de la misma forma. Un mensaje omitido nunca bloquea el resto del recorrido.
• Nodos de webhook - se controlan de forma predeterminada como cualquier mensaje (un webhook suele activar un contacto visible para el usuario en otro sistema). La opción del nodo Llamada al sistema: omitir horas de silencio y límites de frecuencia excluye una llamada pura de sistema a sistema; consulta Nodos de Canvas.
• In-app - a un usuario que alcanzó su límite in-app simplemente no se le muestran mensajes in-app elegibles hasta que se reinicia la franja.

Order of evaluation

Los límites de frecuencia son una de las puertas del proceso de envío. Un mensaje debe superar primero las listas de supresión, las comprobaciones de consentimiento/suscripción y las horas de silencio; después se aplican los límites de frecuencia y, por último, los límites de volumen y velocidad de envío. Por tanto, un límite solo «consume» presupuesto en mensajes que de otro modo se habrían entregado.

Dentro de los propios límites:

1. Solo participan las reglas cuyo alcance de etiquetas coincide con las etiquetas del mensaje.
2. Se comprueba cada regla aplicable por canal y después cada regla aplicable entre canales.
3. La primera regla que alcance o supere su límite bloquea el envío; de lo contrario, continúa.

Controles relacionados que no son límites de frecuencia:

• Listas de supresión - excluyen segmentos por completo, entre canales.
• Límites de volumen y velocidad de envío - regulan el rendimiento (mensajes por minuto, volumen total), no los límites por usuario.

Omitir límites para un mensaje concreto

Las campañas individuales y los nodos de mensaje de los recorridos tienen una opción Ignorar reglas de contacto (límites de frecuencia) que omite los límites del espacio de trabajo solo para ese envío. La propia página de configuración aconseja usarla para alertas de seguridad, recibos transaccionales, avisos legales y cambios de estado de cuenta, no para promociones. En campañas está en el paso de entrega, junto a la excepción de horas de silencio; en el creador de recorridos está en las opciones avanzadas de entrega de cada nodo de mensaje.

Dos aspectos que debes conocer sobre la excepción:

• Omite la comprobación y el recuento de ese mensaje, pero el mensaje sigue entrando en el flujo de eventos como envío real, así que sí consume el presupuesto de otros mensajes en adelante.
• Las listas de supresión siguen aplicándose; la excepción nunca devuelve a un usuario suprimido o dado de baja.

Edición y guardado

Los cambios entran en vigor al pulsar Guardar configuración: las reglas nuevas se aplican a los envíos aproximadamente en un minuto (los ajustes se almacenan brevemente en caché en la infraestructura de envío). Restablecer vuelve a cargar el último estado guardado y descarta las ediciones sin guardar.

Notas de fiabilidad

• Los límites se aplican de forma atómica: dos ejecuciones de recorrido que compiten por enviar el último mensaje permitido al mismo usuario no pueden pasar ambas.
• El sistema es deliberadamente de fallo abierto: si la infraestructura de recuento no está disponible brevemente, los mensajes se entregan en lugar de bloquearse. Un límite de frecuencia nunca detendrá por completo tus envíos por una incidencia puntual de infraestructura.