Skip to main content

​
Horas de silencio: puertas de canal a nivel de organización vs. la ventana de respaldo de campañas

La puerta de horas de silencio de Orbit pertenece al arrendatario: todo lo que hay en esta página es un control que usted configura (o decide dejar desactivado). La única excepción es la ventana federal TCPA de voz para destinatarios estadounidenses, cubierta en su propia sección más abajo. Activar las horas de silencio es su decisión — nada de esto lo exige CAN-SPAM o el RGPD. Esta página es el manual de operaciones de esa puerta. Tres superficies componen su postura:
  1. La puerta de canal a nivel de organización — interruptores por canal en los ajustes de la organización (settings → quiet_hours.<channel>.enabled), escritos a través de PUT /api/v1/settings/general y reflejados en los ajustes de la organización del panel (véase también Postura de cumplimiento).
  2. La ventana de respaldo de campañas — un único par inicio/fin a nivel de organización para envíos drip y journey cuya fila de campaña no lleva una ventana explícita. En el panel: Ajustes → Límites de campaña → Horas de silencio predeterminadas; por la API: GET/PUT /api/v1/campaigns/quiet-hours/settings.
  3. El endpoint de vista previa — GET /api/v1/compliance/quiet-hours/preview, una verificación de solo lectura que responde «¿pasaría ahora mismo este envío a este destinatario?». Ejecútelo antes de cada despliegue; se desarrolla en el manual más abajo.

​
Las dos ventanas

El respaldo de campaña es exactamente lo que su nombre dice — un respaldo, no una segunda puerta. Orden de resolución para un envío de campaña: la ventana propia de la fila de campaña, luego el respaldo de la organización, luego el valor predeterminado de plataforma 21:00 → 09:00 (las horas de silencio van de 21:00 a 9:00 hora local del destinatario). Los dos controles pueden discrepar. Un envío despachado por campaña evalúa la ventana del camino de campaña como una capa; la puerta de canal de la organización — cuando ha activado ese canal — es una capa separada evaluada en el punto de envío. Trate la puerta de la organización como la postura para tráfico 1:1 y el respaldo de campaña como el régimen predeterminado para tráfico masivo. Un envío bloqueado informa next_allowed_at — programe alrededor de la ventana en lugar de reintentar. Los respaldos que puede fijar en cualquiera de las capas solo pueden estrechar la envolvente; nunca ensanchan una puerta de canal que haya activado.

​
Puerta por canal a nivel de organización

La puerta de canal es opt-in por canal. Cada entrada por canal admite: Claves a nivel de organización (se aplican a todos los canales a la vez):

​
Postura predeterminada por canal

Hasta que active un canal, nada se retiene. Cuando active un canal sin especificar horas, entran en juego las horas de la plataforma: El conjunto completo de canales que acepta la puerta: sms, mms, whatsapp, rcs, viber, telegram, voice, email, instagram, messenger, line, apple_messages, fax, push, web_chat.

​
Dos excepciones que mantienen el tráfico esencial fluyendo

  • Consentimiento expreso previo — con consent_overrides_quiet_hours en true (predeterminado), un destinatario con registro de consentimiento explícito atraviesa cualquier canal que no sea de voz. La voz nunca toma esta excepción.
  • Canal de tráfico transaccional — los envíos que quien llama marca como transaccionales (OTP, alertas, notificaciones de cuenta) están exentos de la puerta incluso en un canal activado. La voz tampoco toma esta excepción.
Ponga consent_overrides_quiet_hours en false solo si quiere envíos detenidos sin excepciones de consentimiento.

​
Ventana de respaldo de campañas

Todo llamante autenticado la lee; solo el propietario/administrador la escribe. Lea la ventana de respaldo actual:
platform_default_start / platform_default_end repiten las horas que usan los envíos drip y journey mientras la anulación está desactivada — herédelas o reemplácelas, usted decide. En el panel este formulario es Ajustes → Límites de campaña → Horas de silencio predeterminadas. Fije su propia ventana (ambas horas son obligatorias cuando enabled es true):
Vuelva al valor predeterminado de la plataforma:
Las ventanas nocturnas (p. ej. inicio 22, fin 7) se aceptan en ambas capas — un par start > end cruza la medianoche.

​
Resolución de la zona horaria del destinatario

La puerta trabaja en hora local del destinatario. La resolución de zona horaria sigue esta cadena:
  1. Una sugerencia explícita de recipientTimezone del llamante, cuando se proporciona.
  2. Código de área de EE. UU. → zona horaria IANA, para números +1.
  3. Código de país E.164 → una zona horaria IANA representativa (Europa, Asia, las Américas y mercados operadores comunes).
  4. Para destinatarios de correo electrónico, la zona horaria predeterminada de la organización.
  5. Cuando nada de lo anterior se resuelve — la unknown_timezone_policy de la organización (también configurable en el panel en Ajustes → Voz):
Si el destinatario sí resuelve una zona horaria, un bloqueo normal de canal activado devuelve 422 QUIET_HOURS_BLOCKED (voz: TCPA_DIALING_WINDOW_BLOCKED) con la ventana y next_allowed_at en los detalles del error.

​
Excepción federal TCPA de voz

La voz de campaña y de marcador hacia destinatarios estadounidenses se bloquea de forma estricta fuera de la ventana federal 8:00–21:00 hora local del destinatario — ninguna puerta de organización, ventana de respaldo o indicador de consentimiento la relaja, y un destinatario estadounidense cuya zona horaria no pueda resolverse se bloquea fail-closed. Este es el único control de la plataforma; se aplica solo a voz de campaña y marcador, no a llamadas ad-hoc 1:1 ni a canales de mensajería. Los destinatarios fuera de EE. UU. siguen la puerta normal: la política skip fail-open se aplica a destinatarios fuera de la jurisdicción estadounidense, y su propia puerta del canal de voz (si está activada) se superpone encima. Siempre puede estrechar más allá de la ventana federal — p. ej. una puerta de voz de 09:00–20:00 hora local del destinatario — pero nunca ensancharla. La voz ad-hoc 1:1 desde el panel fuera de la ventana federal marca con un registro de aviso, a menos que haya activado el canal voice en la puerta de la organización, lo que lo convierte en una retención estricta (422 TCPA_DIALING_WINDOW_BLOCKED).

​
El consentimiento anula las horas de silencio

Con consent_overrides_quiet_hours: true (predeterminado), un destinatario para quien guarda consentimiento explícito atraviesa la puerta en canales que no son de voz — la excepción TCPA de «consentimiento expreso previo». Un destinatario permitido sigue siendo alcanzable dentro de sus horas cerradas; un contacto sin registro de consentimiento se retiene hasta que se abra la ventana. Póngalo en false cuando el consentimiento nunca deba relajar su ventana. La puerta ignora por completo el indicador en el canal voice — la voz depende de la ventana federal y de las superposiciones estatales, no de la excepción de consentimiento.

​
Superposiciones estatales mini-TCPA

Algunos estados de EE. UU. superponen una ventana de llamada más estricta o una prohibición por día de la semana sobre las horas federales (la prohibición dominical de Florida, las ventanas de Oklahoma/Mississippi y otras). Las superposiciones se componen con la regla gana la más restrictiva: un envío debe superar la ventana federal y cada superposición estatal aplicable; la superposición puede estrechar pero nunca ensanchar. Los bloqueos de voz se rastrean con estos motivos de fallo:
  • outside_state_window — una superposición estatal estrechó la ventana y esta hora cayó fuera de ella.
  • state_blocked_day — la superposición prohíbe marcar en este día de la semana por completo.
La tabla completa por estado y qué estados del destinatario resuelven en cada superposición está en Ventanas de llamada por estado de EE. UU..

​
Manual de operaciones

Lista de comprobación de despliegue. Antes de activar un canal o empujar una lista amplia:
  1. Previsualice una muestra de destinatarios con GET /api/v1/compliance/quiet-hours/preview?phone=<E.164>&channel=<channel>, añadiendo timezone_override=<IANA> solo cuando su CRM lleva una sugerencia mejor que la que resuelve el número.
  2. Confirme el bloque de la puerta de la organización: GET /api/v1/settings/general y lea el árbol quiet_hours antes del PUT — las escrituras fusionan en el nivel superior, pero la propia clave quiet_hours se reemplaza por completo (véase la sección de escritura más abajo).
  3. Para despliegues masivos, vigile GET /api/v1/settings/compliance-health — sus advertencias clasifican el peor ofensor (remitente más retenido, grupos de errores) para que corrija primero el canal más ruidoso.
Las retenciones son por destinatario, no por arrendatario. Un contacto retenido a las 21:05 hora local bloquea solo los envíos de ese contacto; el resto de su lote sigue admitiendo en paralelo. Un envío 1:1 retenido lanza 422 QUIET_HOURS_BLOCKED con next_allowed_at en los detalles del error — programe en esa marca de tiempo en lugar de reintentar en un bucle. Un envío retenido nunca consume cuota ni reserva de ranura, así que los reintentos se readmiten limpiamente una vez que se abre la ventana. Las escrituras tardan hasta aproximadamente un minuto en llegar a cada punto de envío — los ajustes de la organización se almacenan en caché brevemente en el camino de envío. Las lecturas son inmediatas; verifique la postura fusionada con un GET antes de desplegar.

​
Ejemplos desarrollados

​
Despliegue masivo a las 21:05 — comportamiento de la cola de retención

Empuja una lista de 1.000 destinatarios por la API en un momento en que una parte de su lista queda fuera de su puerta de organización 08:00–21:00 hora local del destinatario. Cada destinatario se resuelve independientemente contra su puerta sms activada:
  • Los destinatarios dentro de la ventana se admiten de inmediato.
  • Los destinatarios retenidos reciben un 422 con next_allowed_at; su trabajador los aparca y continúa el lote. El lote en sí no se pausa — las retenciones son por destinatario.
  • Cuando se reabre la ventana de cada destinatario, vuelva a enviar la fila aparcada; no se quemó ninguna ranura mientras estaba retenido.
Compruebe un destinatario específico sin quemar el intento:
next_allowed_at es una marca de tiempo ISO segura frente al horario de verano — póngala directamente en su planificador.

​
Destinatario de voz de EE. UU. con zona horaria no resuelta — fail-closed

Una marcación de voz de campaña a +15551234567 donde el código de área no resuelve ninguna zona horaria choca con la postura fail-closed de la guarda federal: la marcación se rechaza con 422 TCPA_TIMEZONE_UNKNOWN antes de cualquier cálculo de ventana. Corrija los datos — fije la zona horaria del contacto en el registro o pase recipientTimezone — y vuelva a encolar. La misma entrada no resuelta en el canal sms con unknown_timezone_policy: "deny" termina en 422 QUIET_HOURS_TIMEZONE_UNKNOWN; con la política skip predeterminada pasa en fail-open. La política deny es la predeterminada solo para voz a destinatarios de EE. UU., según la excepción federal de arriba.

​
Anulación por consentimiento dentro de la ventana

Dos contactos, puerta sms activada, 22:30 hora local del destinatario (fuera de su ventana):
Con consent_overrides_quiet_hours: false, ambos se retienen hasta las 08:00 hora local del destinatario. En voice, el indicador no se aplica en absoluto — todo intento de voz se puerta solo con el cálculo de la ventana.

​
Active un canal mediante la API de ajustes de la organización

No hay un endpoint de escritura de horas de silencio dedicado para la puerta de canal; vive dentro del almacén de ajustes de la organización y cada punto de envío lo lee. Actualícelo mediante PUT /api/v1/settings/general (propietario/administrador):
Lea la postura actual de vuelta con GET /api/v1/settings/general y mire el bloque quiet_hours en los settings devueltos.
Fusión y verificación. PUT /settings/general fusiona los ajustes en el nivel superior, por lo que una escritura que contiene solo quiet_hours mantiene intactos sus otros ajustes — pero una escritura en cuya raíz coloca un objeto quiet_hours completo REEMPLAZA esa clave. Si quiere conservar las entradas existentes (por ejemplo una ventana default o las claves hoja almacenadas del respaldo de campaña), lea primero el bloque actual y fúselo antes de escribir.
Las escrituras tardan hasta aproximadamente un minuto en llegar a cada punto de envío — los ajustes de la organización se almacenan en caché brevemente en el camino de envío.

​
Elija una postura

  1. Deje todo desactivado (predeterminado) si opera fuera de jurisdicciones con horas de silencio, o si gestiona los límites en otra parte. Una salvedad: la voz de campaña y marcador de EE. UU. sigue bloqueada de forma estricta — eso no se puede desactivar.
  2. Operador de marketing de EE. UU. — active sms (y voz si marca de forma ad-hoc) en la puerta de la organización; las horas de la plataforma 08:00–21:00 hora local del destinatario se aplican de inmediato. La excepción de consentimiento mantiene a los destinatarios permitidos alcanzables.
  3. Operador UE/APAC con campañas drip — fije el respaldo de campaña a su ventana local (p. ej. 22:00 → 07:00) en Ajustes → Límites de campaña para que todo drip y journey sin ventana propia envíe dentro de su régimen. Añada la puerta de la organización por canal si también quiere retener el tráfico 1:1.

​
Véase también