# Configurar ubicaciones, cobertura y widgets de Chat

> Habilita Chat y configura cobertura, experiencia, apariencia, archivos e instalación.

Idioma: es-MX. Guía del producto: https://customer.help/help/es/chat-settings/.

Revisado por Soporte de Producto de Customer Help el 23 de julio de 2026. Verificado para la versión 2026.07.

<span id="portal-chat-settings"></span>

Usa Configuración de Chat para elegir qué ubicaciones ofrecen Chat, establecer los horarios de atención humana y personalizar e instalar el widget orientado al cliente de cada marca.

## Requisitos

- Chat debe estar disponible para el negocio. Si el área Chat no aparece, [contacta a soporte para confirmar la disponibilidad de Chat](/help/es/reference.md#reference-support).
- La empresa necesita una marca guardada y por lo menos una ubicación activa y facturable.
- La facturación debe mostrar **Activo** o **Prueba**. Después de cambiar una ubicación, espera a que su estado confirme el cambio.
- Cada ubicación con Chat debe tener una zona horaria de ciudad o región confirmada, como `America/Mexico_City`, antes de guardar la cobertura programada.

## Habilitar Chat por ubicación

<span id="chat-locations-enabled"></span>
**Ubicaciones con Chat habilitado:** selecciona las ubicaciones en **Ubicaciones de Chat** y luego **Guardar cambios**. Chat está disponible en una ubicación cuando la fila muestra **Habilitado**.

| Estado | Significado |
| --- | --- |
| **Habilitado** | Chat está activo para la ubicación. |
| **Pendiente** | El cambio espera confirmación de facturación. |
| **Es necesario reintentar** | No se pudo confirmar el cambio. La configuración anterior sigue en uso. |
| **Desactivado** | Chat está desactivado para la ubicación. |

La casilla no está disponible si la ubicación está inactiva, no es facturable o la suscripción principal no está activa. Chat cuesta el precio mostrado por cada ubicación habilitada. Deshabilitarlo puede generar un ajuste de facturación prorrateado; no elimina el historial de conversaciones.

## Configurar la cobertura de una ubicación

<span id="chat-coverage-mode"></span>
**Modo de disponibilidad:** expande una ubicación con Chat y elige **Siempre disponible**, **Horario semanal** o **No disponible**.

- **Siempre disponible** considera que hay cobertura humana en todo momento, sujeta a la presencia y capacidad reales de los agentes.
- **Horario semanal** usa ventanas de los días habilitados en la zona horaria efectiva de la ubicación.
- **No disponible** nunca ofrece atención humana en vivo; el widget aplica su comportamiento sin conexión.

Para configurar un horario semanal:

1. <span id="chat-coverage-enabled"></span> **Día habilitado:** activa cada día en el que debe existir cobertura humana. Un día deshabilitado permanece sin cobertura.
2. <span id="chat-coverage-open"></span> **Hora de apertura:** introduce la hora local en la que comienza cada ventana de atención.
3. <span id="chat-coverage-close"></span> **Hora de cierre:** introduce una hora local posterior a la apertura. Se permiten hasta cuatro ventanas por día; deben estar ordenadas y no superponerse. Las ventanas nocturnas no son compatibles, así que divídelas entre dos días del calendario.

Selecciona **Guardar y confirmar**. Si falta una zona horaria, esta acción se deshabilita; corrígela en [Ubicaciones](/help/es/locations.md#location-time-zone-override).

<span id="chat-coverage-copy-to"></span>
**Copiar cobertura a:** copia el horario guardado a otra ubicación. Confirma la zona horaria de destino: copiar `09:00–17:00` establece de 9 a. m. a 5 p. m. en la hora local del destino.

Si un widget todavía muestra un horario anterior por marca, mantenlo actualizado hasta que hayas confirmado la zona horaria y el horario de cobertura de cada ubicación con Chat.

## Abrir el widget de una marca

Cada marca tiene un ID público de widget que permanece igual cuando editas su nombre, ruta o tema. **Vista previa** abre la experiencia sin publicar cambios. **Copiar código** copia el fragmento de instalación. **Editar** abre las seis pestañas de configuración.

Los cambios actualizan inmediatamente la vista previa, pero no llegan a clientes hasta que **Guardar Chat Widget** finaliza correctamente. Si otro Administrador guardó primero, recarga la configuración más reciente y vuelve a aplicar los cambios.

## Campos de experiencia y textos

Los textos se redactan por separado para cada idioma habilitado de la empresa. Si un campo de un idioma secundario queda vacío, se usa el texto redactado en el idioma principal; Customer Help no inventa una traducción.

| Campo | Límite y efecto |
| --- | --- |
| <span id="chat-copy-header-title"></span> **Encabezado de Chat** | Hasta 80 caracteres; es el título en la parte superior del panel. |
| <span id="chat-copy-welcome-title"></span> **Título de bienvenida** | Hasta 100 caracteres; es el mensaje principal antes de iniciar una conversación. |
| <span id="chat-copy-greeting"></span> **Saludo** | Hasta 240 caracteres; presenta el servicio al visitante sin afirmar que hay un agente disponible fuera de cobertura. |
| <span id="chat-copy-online-label"></span> **Mensaje en línea** | Hasta 60 caracteres; muestra el estado de disponibilidad durante la cobertura. |
| <span id="chat-copy-offline-label"></span> **Estado sin conexión** | Hasta 80 caracteres; muestra un estado compacto fuera de la cobertura. |
| <span id="chat-copy-offline-title"></span> **Título de no disponible** | Hasta 100 caracteres; encabeza el panel que aparece fuera de cobertura. |
| <span id="chat-copy-offline-message"></span> **Mensaje de no disponible** | Hasta 240 caracteres; dirige a alternativas. No prometas un plazo que el equipo no pueda cumplir. |
| <span id="chat-copy-composer-placeholder"></span> **Marcador del mensaje** | Hasta 100 caracteres; es la indicación que aparece en el compositor. |
| <span id="chat-copy-launcher-label"></span> **Etiqueta del lanzador** | Hasta 40 caracteres; es el texto que utiliza un lanzador de tipo píldora. |
| <span id="chat-copy-starter-prompts"></span> **Preguntas sugeridas** | Una por línea, hasta 500 caracteres en total y un máximo de seis preguntas. Al seleccionar una se inicia un mensaje del visitante; no cambia el comportamiento de la IA. |
| <span id="chat-copy-privacy-notice"></span> **Nota de privacidad** | Opcional, hasta 300 caracteres. Muestra un aviso breve sobre la recopilación de datos. |
| <span id="chat-experience-visitor-name-mode"></span> **Solicitar el nombre** | **No solicitar**, **Opcional** u **Obligatorio** antes de iniciar. Exigirlo puede reducir los inicios; recopila sólo lo necesario. |
| <span id="chat-experience-privacy-url"></span> **Enlace a la política de privacidad** | URL HTTPS absoluta y opcional de la política de la empresa. Comprueba que se pueda abrir públicamente. |

## Campos de apariencia

| Campo | Valores y consecuencia |
| --- | --- |
| <span id="chat-experience-launcher-style"></span> **Estilo del lanzador** | **Icono** o **Icono y etiqueta**. La segunda opción usa la etiqueta del lanzador y ocupa más espacio en la página. |
| <span id="chat-experience-launcher-label"></span> **Etiqueta del lanzador en apariencia** | Hasta 40 caracteres. Conserva la misma intención localizada que la etiqueta de la pestaña Experiencia. |
| <span id="chat-experience-panel-size"></span> **Tamaño del panel** | **Compacto**, **Estándar** o **Amplio**. Prueba pantallas pequeñas antes de elegir Amplio. |
| <span id="chat-experience-header-style"></span> **Estilo del encabezado** | **Mínimo**, **Color sólido** o **Degradado**. Revisa el contraste del texto y logotipo con el resultado. |
| <span id="chat-appearance-launcher-position"></span> **Posición del lanzador** | Inferior derecha o inferior izquierda. Comprueba que no cubra controles de cookies, accesibilidad o navegación. |
| <span id="chat-experience-color-mode"></span> **Origen de los colores** | **Usar colores de marca** sigue la configuración de la marca; **Colores personalizados** permite que el widget use otra paleta. |
| <span id="chat-experience-primary-color"></span> **Color principal** | Color hexadecimal usado para los elementos principales. Mantén contraste legible y compruébalo fuera de la vista previa. |
| <span id="chat-experience-accent-color"></span> **Color de acento** | Color hexadecimal de énfasis. Evita combinaciones que dependan únicamente del color para comunicar estado. |
| <span id="chat-experience-background-color"></span> **Color de superficie** | Color hexadecimal del fondo del panel; debe mantener contraste con el texto y los controles. |
| <span id="chat-experience-corner-radius"></span> **Redondeo de esquinas** | Número entero entre 8 y 28 píxeles. |
| <span id="chat-experience-show-logo"></span> **Mostrar el logotipo de la marca** | Usa el logotipo ya configurado para esa marca. |
| <span id="chat-experience-show-powered-by"></span> **Mostrar “Con tecnología de Customer Help”** | Está activado de forma predeterminada. Desactivarlo crea un pie sin atribución y no cambia la facturación. |

## Campos de comportamiento

| Campo | Valores y consecuencia |
| --- | --- |
| <span id="chat-behavior-concurrent-chat-limit"></span> **Chats simultáneos por agente** | Número entero entre 1 y 100; el valor predeterminado es 3. Es la cantidad máxima de conversaciones activas asignadas a un agente disponible. |
| <span id="chat-behavior-offline-mode"></span> **Comportamiento sin conexión** | **Mostrar opciones de contacto** impide recopilar mensajes; **Recopilar un mensaje** permite que un visitante inicie una conversación fuera de la cobertura humana. |
| <span id="chat-behavior-transcript-mode"></span> **Transcripciones para visitantes** | **Desactivadas** o **A solicitud del visitante**. La solicitud del visitante está desactivada de forma predeterminada. Un visitante puede pedir una transcripción por correo después de cerrar la conversación. |
| <span id="chat-behavior-visitor-idle-prompt"></span> **Avisar a un visitante inactivo** | **Nunca** (valor predeterminado), 5, 10, 15, 30 o 60 minutos. El tiempo comienza después de la respuesta más reciente de un agente o de la IA, no mientras el equipo o la IA debe responder. Otra respuesta reinicia el tiempo; un mensaje del visitante lo cancela. |
| <span id="chat-behavior-visitor-idle-close"></span> **Cerrar si no confirma** | 1, 2, 5, 10 o 15 minutos después del aviso; el valor predeterminado es 5. El campo queda deshabilitado cuando el aviso es Nunca. El límite continúa durante recargas, conexiones suspendidas y pérdidas temporales de red. El cierre conserva la transcripción según la política normal. |
| <span id="chat-behavior-coverage-timezone"></span> **Zona horaria para horarios anteriores** | Sólo aparece en widgets que todavía usan un horario anterior por marca. Elige la zona horaria correcta de ciudad o región y luego configura la cobertura por ubicación cuando estés listo. |

## Formulario, verificación y mensajes del visitante

- <span id="chat-visitor-open"></span> **Abrir Chat** expande el lanzador, borra su contador no leído visible y marca como leída la actividad más reciente que se muestra. Restaura una conversación guardada disponible en lugar de crear una nueva.
- <span id="chat-visitor-close"></span> **Cerrar Chat** contrae el panel al lanzador y detiene el indicador de escritura del visitante. No termina, elimina ni desasigna la conversación; abrir el panel otra vez regresa a la misma sesión disponible.
- <span id="chat-visitor-location"></span> **Elegir una ubicación** aparece cuando el widget tiene más de una ubicación disponible. La selección es obligatoria y envía la conversación al equipo de esa ubicación; no modifica la ubicación del navegador ni una configuración de la empresa.
- <span id="chat-visitor-name"></span> **Tu nombre** sigue el modo configurado de Solicitar el nombre y admite hasta 80 caracteres. Opcional puede quedar vacío; Obligatorio debe completarse antes de iniciar. El nombre se guarda con la conversación, por lo que el visitante no debe escribir información privada.
- <span id="chat-security-verification"></span> **Verificación de seguridad** es una comprobación antispam única antes de iniciar una conversación nueva. Iniciar chat permanece deshabilitado hasta que finalice. Si vence o se rechaza, complétala otra vez. Si no carga, permite `https://challenges.cloudflare.com` en los filtros de red y contenido, recarga el widget y reintenta una vez.
- <span id="chat-visitor-message"></span> **Mensaje del visitante** requiere texto y admite hasta 4,000 caracteres. Enter envía y Mayús+Enter agrega una línea. Espera el estado de entrega antes de repetir después de una interrupción.
- <span id="chat-visitor-attachment"></span> **Archivo adjunto del visitante** está disponible sólo cuando los adjuntos están habilitados. Las mismas reglas de tipo y tamaño se aplican a visitantes y agentes. No se aceptan archivos vacíos, demasiado grandes o no compatibles, aunque se cambie su extensión.
- <span id="chat-transcript-email"></span> **Correo de transcripción** aparece después del cierre sólo cuando el opt-in del visitante está habilitado. Requiere una dirección válida de hasta 254 caracteres. La solicitud envía como máximo una transcripción automática para esa conversación; verifica la dirección antes de enviarla porque el formulario no cambia la cuenta ni al propietario.
- <span id="chat-visitor-start"></span> **Iniciar chat / Dejar un mensaje** valida ubicación, nombre obligatorio y verificación de seguridad antes de crear la conversación. Dejar un mensaje sigue el comportamiento sin conexión configurado; seleccionar la acción no promete una respuesta humana inmediata.
- <span id="chat-visitor-handoff"></span> **Hablar con un agente / Dejar para un agente** aparece sólo cuando el modo de IA activo permite atención humana. Registra la solicitud y dirige la conversación al equipo elegible; no garantiza disponibilidad inmediata. No pulses repetidamente mientras la primera solicitud está pendiente.
- <span id="chat-transcript-send"></span> **Enviar transcripción por correo** envía la dirección una vez. Espera la confirmación en lugar de repetir la solicitud. Si no se puede confirmar la entrega, [contacta a soporte con la hora, marca y ubicación de la conversación](/help/es/reference.md#reference-support).
- <span id="chat-visitor-new-chat"></span> **Iniciar un chat nuevo** deja la conversación cerrada y vuelve al formulario inicial. No elimina el historial y puede exigir una nueva verificación de seguridad.
- <span id="chat-visitor-retry"></span> **Intentar de nuevo** vuelve a cargar Chat después de un error. Corrige primero los problemas de conexión, origen permitido o bloqueo de contenido; repetir no corrige una configuración incorrecta.
- <span id="chat-visitor-send"></span> **Enviar mensaje** se habilita sólo con texto no vacío en una conversación abierta. Espera el estado Entregado o Fallido antes de decidir si reintentas.
- <span id="chat-visitor-still-here"></span> **Sigo aquí** aparece sólo después del intervalo de inactividad configurado. Seleccionarlo confirma actividad, oculta el aviso y reinicia todo el intervalo sin agregar un mensaje a la transcripción. Enviar un mensaje normal tiene el mismo efecto. Si no ocurre ninguna acción antes de terminar el período mostrado, Chat cierra la conversación y ofrece iniciar otra.

Mientras la IA piensa o transmite una respuesta, Chat muestra su indicador de escritura y no lo sustituye por un aviso de reconexión durante cambios breves del socket. Un aviso de reconexión significa que la entrega en vivo y su período corto de recuperación no están disponibles; si no aparece una respuesta terminada, mantén abierto el panel, confirma que la red permita `wss://widget.customer.help` y reintenta cuando vuelva la conectividad.

## Campos de archivos

<span id="chat-files-enabled"></span>
**Permitir archivos adjuntos** habilita o deshabilita las cargas para visitantes y agentes en conjunto. Se admiten JPG/JPEG, PNG, PDF, HEIC y WebP. Deshabilitar esta opción no elimina los archivos ya conservados en conversaciones.

<span id="chat-files-max-size"></span>
**Tamaño máximo de archivo (MB)** acepta valores de 1 a 25 y tiene un valor predeterminado de 10. Cambiar la extensión de un archivo no cambia su tipo.

## Pestaña Disponibilidad

La mayoría de los widgets administran la cobertura por ubicación. Un widget que todavía usa un horario anterior por marca puede mostrar estos controles:

| Campo | Regla y consecuencia |
| --- | --- |
| <span id="chat-widget-coverage-always-open"></span> **Usar disponibilidad todas las horas** | Hace que el widget esté disponible a toda hora e ignora las filas de días. |
| <span id="chat-widget-coverage-enabled"></span> **Día habilitado** | Incluye ese día de la semana en el horario. Un día deshabilitado no tiene cobertura. |
| <span id="chat-widget-coverage-start"></span> **Hora de inicio** | Inicia la disponibilidad en la zona horaria seleccionada. |
| <span id="chat-widget-coverage-end"></span> **Hora de fin** | Termina la disponibilidad y debe ser posterior a Inicio. Divide un período nocturno entre dos días. |

Mantén estos ajustes actualizados mientras sean visibles. Confirma la zona horaria de cada ubicación y configura la cobertura por ubicación cuando esa opción esté disponible.

<span id="chat-installation-requirements"></span>

## Instalación y orígenes autorizados

Las páginas administradas por Customer Help se autorizan automáticamente.

<span id="chat-installation-allowed-origin"></span>
**Origen permitido:** para un sitio externo, introduce el origen HTTPS exacto, por ejemplo `https://www.example.com`, con esquema, nombre de host y cualquier puerto no estándar, pero sin ruta, consulta, fragmento, comodín, datos de inicio de sesión ni contenido adicional. `https://example.com` y `https://www.example.com` son orígenes distintos.

Instala una sola vez el fragmento copiado, normalmente antes de `</body>`:

```html
<script
  async
  src="https://widget.customer.help/v1/loader.js"
  data-widget-id="chw_public_...">
</script>
```

### Requisitos de la Política de Seguridad de Contenido

Si el sitio externo envía una Política de Seguridad de Contenido (CSP), combina estas fuentes con su política actual. No sustituyas las demás directivas del sitio.

| Directiva del sitio que instala Chat | Fuente requerida | Por qué se necesita |
| --- | --- | --- |
| `script-src` | `https://widget.customer.help` | Carga `/v1/loader.js`. Conserva las fuentes, nonces y hashes que el sitio ya usa. |
| `script-src-elem`, cuando la política la define | `https://widget.customer.help` | Una directiva `script-src-elem` definida controla el elemento `<script>` del cargador en lugar de `script-src`, por lo que también debe incluir el host del widget. |
| `frame-src` | `https://widget.customer.help` | Muestra el panel de Chat. Agrega `frame-src` explícitamente cuando una política restrictiva dependa de `child-src` o `default-src`. |

Un ejemplo mínimo para la página anfitriona es:

```http
Content-Security-Policy: default-src 'self'; script-src 'self' https://widget.customer.help; frame-src https://widget.customer.help
```

Si la política ya define `script-src-elem`, combina el mismo host con esa directiva:

```http
script-src-elem 'self' https://widget.customer.help
```

En una política basada en nonce que use `'strict-dynamic'`, coloca en el cargador el nonce vigente de la respuesta actual del sitio. Genera un nonce nuevo e impredecible para cada respuesta; nunca pegues el marcador ni reutilices un valor fijo:

```html
<script
  nonce="{{NONCE_DE_LA_RESPUESTA_ACTUAL}}"
  async
  src="https://widget.customer.help/v1/loader.js"
  data-widget-id="chw_public_...">
</script>
```

La página anfitriona **no** necesita agregar Customer Help a `connect-src`, `img-src`, `font-src` o `style-src`, y tampoco necesita agregar Cloudflare Turnstile a sus propias directivas `script-src` o `frame-src`. No agregues `'unsafe-inline'` únicamente para Customer Help. Si el sitio envía más de un encabezado CSP obligatorio, cada política aplicable debe permitir el cargador y el panel de Chat; un encabezado permisivo no anula otro restrictivo.

### Lista de permitidos de red y filtros de contenido

La CSP de la página anfitriona y un firewall, gateway web seguro, filtro DNS, extensión de navegador o herramienta de privacidad son controles distintos. Los controles de red usados por los navegadores de visitantes deben permitir:

| Esquema y host | Para qué se usa |
| --- | --- |
| `https://widget.customer.help` | Carga de Chat, mensajes, transcripciones y adjuntos. |
| `wss://widget.customer.help` | Actualizaciones en vivo después de iniciar una conversación. |
| `https://challenges.cloudflare.com` | La verificación única contra spam antes de una conversación nueva. |
| El host HTTPS público del logo de marca configurado, cuando se use | Carga del logo dentro de Chat. |

Chat no solicita permisos de cámara, micrófono ni geolocalización. No autorices un origen comodín ni agregues una clave privada para intentar corregir una instalación bloqueada.

### Verificar la instalación

1. Guarda el origen HTTPS exacto del sitio en **Origen permitido**, incluido cualquier puerto no estándar.
2. Abre una página real en una ventana privada y confirma que aparezcan el lanzador y el panel de Chat. Si el navegador informa un error `403` para el panel de Chat, verifica el Origen permitido exacto de la página; relajar la CSP no autoriza un origen incorrecto.
3. Confirma que termine la verificación de seguridad, inicia una conversación de prueba y envía y recibe un mensaje. Prueba también un adjunto cuando estén habilitados.
4. Regresa a Configuración de Chat y confirma que **Visto por última vez** se actualice para el widget instalado.
5. Interpreta literalmente los errores CSP de la consola: un cargador bloqueado apunta a `script-src` o `script-src-elem`; un panel de Chat bloqueado apunta a `frame-src`; una falla de verificación apunta al acceso a `challenges.cloudflare.com`; y las reconexiones repetidas pueden indicar que `wss://widget.customer.help` está bloqueado. Usa `Content-Security-Policy-Report-Only` para evaluar una política propuesta antes de aplicarla, pero recuerda que una política de sólo reporte no concede acceso bloqueado por una política obligatoria.

Chat recuerda una conversación activa cuando el visitante cierra y vuelve a abrir el panel. Recibe el título y la ruta de la página, pero no las consultas ni los fragmentos de la página. Nunca agregues una contraseña, un secreto ni una clave privada al fragmento. **Visto por última vez** se actualiza después de que una página real en un origen permitido carga correctamente el widget.

## Permisos, facturación y visibilidad al cliente

Sólo los Administradores configuran Chat. Habilitar una ubicación agrega el cargo de Chat mostrado después de la confirmación. Los textos guardados, la apariencia, la cobertura, el comportamiento sin conexión, la disponibilidad de adjuntos y la elección de transcripciones pueden afectar inmediatamente a clientes. Los orígenes permitidos y los IDs de widget se pueden compartir con quienes instalen Chat, pero nunca publiques contraseñas, secretos ni detalles privados de la cuenta.

## Solución de problemas

- **La casilla de la ubicación está deshabilitada:** confirma que la ubicación esté activa y sea facturable, y que la suscripción principal muestre **Activo** o **Prueba**.
- **Guardar y confirmar está deshabilitado:** establece una zona horaria válida para la ubicación.
- **El widget no aparece:** confirma el Origen permitido exacto, el ID copiado, HTTPS, los permisos de CSP y si se actualiza **Visto por última vez**.
- **Pendiente o Es necesario reintentar:** el cambio de facturación no se ha confirmado. Sigue la acción que aparece con el estado sin cambiar repetidamente la casilla.
- **Aparece sin conexión a una hora incorrecta:** verifica la zona horaria, el modo y los horarios de cobertura, la confirmación guardada, la disponibilidad de agentes y cualquier horario anterior que todavía aparezca en Disponibilidad.
- **Conflicto al guardar:** recarga la configuración más reciente del widget, vuelve a aplicar los cambios y guarda una sola vez.
