Cómo configurar redireccionamientos en Zendesk Guide: Guía completa 2026

Cuando elimina o mueve artículos en Zendesk Guide, se queda con enlaces rotos. Cualquiera que haga clic en esas URL antiguas llega a una página de error 404. Eso es malo para la experiencia del usuario y peor para el SEO. A los motores de búsqueda no les gustan los enlaces muertos, y tampoco a sus clientes.

¿La buena noticia? Zendesk ahora le ofrece dos formas de manejar esto. Puede usar la API de Reglas de Redireccionamiento (el enfoque adecuado del lado del servidor) o recurrir a las redirecciones de JavaScript si necesita una solución rápida. Esta guía lo guía a través de ambos métodos para que pueda elegir lo que funcione para su situación.

Si las limitaciones de redireccionamiento de Zendesk le resultan frustrantes, podría valer la pena explorar alternativas. Construimos eesel AI para manejar la gestión del conocimiento sin este tipo de soluciones alternativas. Nuestro compañero de equipo de IA aprende de su documentación existente y maneja las redirecciones automáticamente cuando cambia el contenido. Pero primero concentrémonos en hacer que Zendesk funcione para usted.

Lo que necesitará

Antes de comenzar a configurar las redirecciones, asegúrese de tener:

• Permisos de administrador de Guide: necesita acceso para personalizar el tema de su centro de ayuda o usar la API
• Para el método API: Un token API configurado en su cuenta de Zendesk (Centro de administración → Aplicaciones e integraciones → API → API de Zendesk)
• Para el método JavaScript: Acceso para editar el código de su tema (Administrador de Knowledge → Personalizar diseño)
• Comprensión básica de la estructura de su URL: Las URL de Zendesk siguen el patrón /hc/{locale}/articles/{id}-{slug}

Analicemos ambos enfoques.

Método 1: Uso de la API de Reglas de Redireccionamiento

Zendesk introdujo la API de Reglas de Redireccionamiento en octubre de 2024. Este es el enfoque recomendado para manejar las redirecciones porque utiliza códigos de estado HTTP adecuados que los motores de búsqueda entienden.

Descripción general de la API de Reglas de Redireccionamiento

La API le brinda redirecciones del lado del servidor con códigos de estado HTTP adecuados (301, 302, 303, 307 o 308). Esto importa porque los motores de búsqueda tratan las redirecciones del lado del servidor de manera diferente a las redirecciones de JavaScript. Una redirección 301 le dice a Google "esta página se ha movido permanentemente", lo que preserva su valor SEO.

Cosas clave que debe saber:

• Puede crear hasta 50,000 reglas de redireccionamiento por marca
• Disponible en todos los planes de Guide excepto en el plan heredado Guide Lite
• Requiere permisos de administrador de Guide
• Funciona para artículos, secciones, categorías y publicaciones de la comunidad

Paso 1: Crear una regla de redireccionamiento a través de la API

Para crear una redirección, envíe una solicitud POST a /api/v2/guide/redirect_rules. Aquí está la estructura JSON que necesita:

{
  "redirect_rule": {
    "redirect_from": "/hc/en-us/articles/123456",
    "redirect_status": 301,
    "redirect_to": "https://yoursubdomain.zendesk.com/hc/en-us/articles/789012"
  }
}

Notas importantes sobre los campos:

• redirect_from: La ruta desde la que se va a redirigir, comenzando con /. Omita el slug (el texto después del ID del artículo); solo use el ID
• redirect_status: Use 301 para redirecciones permanentes (lo mejor para SEO), 302 para temporales
• redirect_to: La URL o ruta completa a la que se va a redirigir, comenzando con https://, http:// o /

Aquí hay un ejemplo de curl:

curl https://yoursubdomain.zendesk.com/api/v2/guide/redirect_rules \
  -X POST \
  -d '{ "redirect_rule": { "redirect_from": "/hc/en-us/articles/123456", "redirect_to": "https://yoursubdomain.zendesk.com/hc/en-us/articles/789012", "redirect_status": 301 } }' \
  -H "Content-Type: application/json" \
  -v -u your_email@company.com/token:your_api_token

Paso 2: Pruebe su redireccionamiento

Después de crear una redirección, pruébela inmediatamente:

1. Abra una ventana del navegador de incógnito
2. Navegue a la URL antigua
3. Verifique que se redirija a la nueva URL
4. Verifique las herramientas de desarrollador del navegador (pestaña Red) para confirmar el código de estado 301

Si la redirección no funciona, verifique que el artículo de origen esté realmente eliminado. La redirección solo se activa para las URL que devuelven un error 404.

Paso 3: Gestión de redirecciones existentes

Para ver todas sus redirecciones, use el punto final de la lista:

curl https://yoursubdomain.zendesk.com/api/v2/guide/redirect_rules \
  -v -u your_email@company.com/token:your_api_token

La API utiliza la paginación del cursor. Si tiene muchas redirecciones, obtendrá un after_cursor en la respuesta. Úselo para buscar la página siguiente:

curl "https://yoursubdomain.zendesk.com/api/v2/guide/redirect_rules?page[after_cursor]=Y3Vyc29yIHR3bw==" \
  -v -u your_email@company.com/token:your_api_token

Para actualizar una redirección, simplemente publique nuevamente con la misma ruta redirect_from. El nuevo redirect_to y redirect_status sobrescribirán la regla existente.

Para eliminar una redirección, necesitará su ID. Primero encuéntrelo en la lista, luego:

curl https://yoursubdomain.zendesk.com/api/v2/guide/redirect_rules/01GFXGBX7YZ9ASWTCVMASTK8ZS \
  -X DELETE \
  -v -u your_email@company.com/token:your_api_token

Método 2: Solución alternativa de redireccionamiento de JavaScript

Si no tiene acceso a la API o necesita una solución rápida para solo algunos artículos, las redirecciones de JavaScript son una opción. Solo conozca las desventajas por adelantado.

Cuándo usar redirecciones de JavaScript

Este enfoque funciona mejor cuando:

• Necesita redirigir una pequeña cantidad de artículos (menos de 20)
• No tiene recursos de desarrollador para implementar la API
• Está realizando cambios temporales y planea usar la API más adelante

¿La trampa? Las redirecciones de JavaScript ocurren después de que se carga la página. Es posible que los motores de búsqueda no los sigan de manera tan confiable como las redirecciones del lado del servidor. Zendesk señala explícitamente que estos "pueden afectar las clasificaciones de búsqueda de Google" y "no son adecuados para la implementación a largo plazo o a gran escala".

Paso 1: Acceda al código de su tema

1. Vaya a Administrador de Knowledge en su panel de administración de Zendesk
2. Haga clic en Personalizar diseño (el icono del pincel)
3. Haga clic en Personalizar en su tema activo
4. Haga clic en Editar código
5. Busque y haga clic en script.js en la lista de archivos

Paso 2: Agregar código de redireccionamiento

Agregue este código cerca de la parte superior de su archivo script.js, antes de cualquier otra función:

// Map old article IDs to new article IDs
var oldIds = ["217352077", "216552968"];
var newIds = ["216553098", "216552958"];

for (var i = 0; i < oldIds.length; i++){
  if (window.location.href.indexOf(oldIds[i]) > -1) {
    window.location.href = 'https://yoursubdomain.zendesk.com/hc/en-us/articles/' + newIds[i];
  }
}

Reemplace los ID en las matrices oldIds y newIds con sus ID de artículo reales. Manténgalos entre comillas y asegúrese de que las posiciones coincidan (el primer ID antiguo se redirige al primer ID nuevo, y así sucesivamente).

Para redirecciones de reserva de idioma (enviar usuarios a su idioma predeterminado cuando no existe una traducción):

var notDefaultLanguage = window.location.href.indexOf('/en-us/') == -1;
var isArticle = window.location.href.indexOf('/articles/') > -1;
var isErrorPage = document.getElementsByClassName("error-page").length > 0;

if ( isArticle && notDefaultLanguage && isErrorPage ) {
    var newURL = window.location.href.replace(/(.*\/hc\/)([\w-]+)(\/.*)/, "$1en-us$3");
    window.location.href = newURL;
}

Reemplace en-us con el código de su idioma predeterminado si es diferente.

Paso 3: Publicar y probar

1. Haga clic en Publicar para guardar sus cambios
2. Pruebe en una ventana de incógnito en varios navegadores
3. Verifique el comportamiento móvil: las redirecciones deberían funcionar igual en el móvil
4. Borre la caché de su navegador si las redirecciones no aparecen inmediatamente

Escenarios comunes de redireccionamiento

Redireccionamiento de artículos eliminados a equivalentes nuevos

El caso de uso más común: eliminó un artículo antiguo y escribió uno nuevo que cubre el mismo tema. Use el método API con una redirección 301 para preservar el valor SEO.

Para redirecciones masivas (como después de una reorganización importante del contenido), programe las llamadas API. Aquí hay un ejemplo de Python:

import requests

redirects = [
    ("/hc/en-us/articles/111", "/hc/en-us/articles/222"),
    ("/hc/en-us/articles/333", "/hc/en-us/articles/444"),
]

for old_path, new_path in redirects:
    payload = {
        "redirect_rule": {
            "redirect_from": old_path,
            "redirect_status": 301,
            "redirect_to": f"https://yoursubdomain.zendesk.com{new_path}"
        }
    }
    response = requests.post(
        "https://yoursubdomain.zendesk.com/api/v2/guide/redirect_rules",
        json=payload,
        auth=("your_email@company.com/token", "your_api_token")
    )
    print(f"Redirected {old_path}: {response.status_code}")

Gestión de contenido no traducido

Si admite varios idiomas pero no traduce todos los artículos, configure redirecciones de reserva. Cuando un usuario intenta acceder a un artículo en francés que solo existe en inglés, rediríjalo a la versión en inglés en lugar de mostrar un 404.

El ejemplo de JavaScript en el Paso 2 anterior maneja esto. Para una solución del lado del servidor que utiliza la API, necesitaría crear redirecciones individuales para cada artículo no traducido.

Redirecciones de migración

¿Se muda de otra plataforma a Zendesk? Es probable que tenga diferentes patrones de URL. Por ejemplo:

• Antiguo: /support/solutions/articles/1234
• Nuevo: /hc/en-us/articles/5678

Cree redirecciones para cada URL antigua que apunte a su nuevo equivalente de Zendesk. Tenga en cuenta que las URL que comienzan con /knowledge/ (como las URL de la base de conocimientos de HubSpot) no funcionarán como fuentes de redireccionamiento en Zendesk; esa ruta está reservada.

Solución de problemas comunes

Las redirecciones no funcionan en absoluto

Verifique que el artículo de origen esté realmente eliminado. La redirección solo se activa para errores 404. Los artículos archivados o no publicados no activarán las redirecciones.

Parámetros de consulta que interrumpen las redirecciones

Si sus URL incluyen parámetros de seguimiento (como ?utm_source=email), es posible que la redirección no coincida. La API coincide solo con la ruta, por lo que los parámetros no deberían importar, pero pruebe para confirmar.

Complicaciones del proxy de Cloudflare

Si usa Cloudflare con el mapeo de host de Zendesk, puede tener problemas. Cuando "naranja nube" (proxy) su registro CNAME que apunta a Zendesk, Cloudflare para SaaS se activa y enruta el tráfico directamente a Zendesk, sin pasar por sus reglas de redireccionamiento. Las soluciones incluyen el uso de reglas de origen o un nombre de host proxy separado.

Conflictos de mapeo de host

Si ha mapeado un dominio personalizado a su centro de ayuda, asegúrese de que sus redirecciones usen el dominio correcto. Las redirecciones funcionan tanto para los subdominios de Zendesk como para los dominios mapeados por host.

Problemas de almacenamiento en caché

Después de publicar los cambios de tema para las redirecciones de JavaScript, borre la caché de su navegador. Para las redirecciones API, los cambios son inmediatos, pero el almacenamiento en caché de CDN podría retrasar la visibilidad.

Mejores prácticas de SEO para redirecciones de Zendesk Guide

Cuándo usar redirecciones 301 vs 302

Use 301 (Movido permanentemente) cuando:

• Un artículo se elimina y reemplaza permanentemente
• Está migrando contenido de otra plataforma
• La URL antigua nunca más se usará

Use 302 (Encontrado) cuando:

• La redirección es temporal
• Está realizando pruebas A/B de diferentes versiones de artículos
• El contenido original podría regresar

Evitar cadenas de redireccionamiento

No cree cadenas como: Artículo A → Artículo B → Artículo C. Google puede dejar de seguir después de algunos saltos. Siempre redirija al destino final.

Actualización de enlaces internos frente a la dependencia de redirecciones

Las redirecciones son una red de seguridad, no una estrategia. Actualice sus enlaces internos para que apunten directamente a las nuevas URL. Esto reduce la carga del servidor y garantiza que los usuarios obtengan la experiencia más rápida.

Monitoreo de errores 404

Configure Google Search Console para su centro de ayuda. Consulte el informe de cobertura con regularidad para ver si hay errores 404. Cada uno es una redirección potencial que necesita crear.

Alternativa: Considere eesel AI para la gestión del centro de ayuda

Si está dedicando una cantidad significativa de tiempo a administrar las redirecciones de Zendesk, luchando con el código del tema o sorteando las limitaciones de la plataforma, hay una mejor manera.

Construimos eesel AI como un compañero de equipo de IA para el servicio al cliente. A diferencia de los centros de ayuda tradicionales que requieren la gestión manual de redireccionamientos, eesel aprende de su documentación existente (Confluence, Google Docs, Notion, tickets anteriores) y maneja los cambios de contenido automáticamente.

Cuando actualiza o mueve contenido, la IA de eesel comprende las relaciones y muestra la información correcta sin la configuración manual de redireccionamientos. Define reglas de escalamiento en inglés sencillo ("Si la solicitud de reembolso supera los 30 días, rechace cortésmente") y eesel se encarga del resto.

Nuestros clientes suelen ver tasas de resolución autónoma de hasta el 81% para el soporte de primera línea. Si las limitaciones de redireccionamiento de Zendesk son parte de una frustración más amplia con la plataforma, pruebe eesel gratis y vea cómo difiere un enfoque nativo de la IA.

Comience a administrar sus redirecciones de Zendesk Guide de manera efectiva

Ahora tiene dos opciones sólidas para manejar las redirecciones en Zendesk Guide. Para uso en producción, la API de Reglas de Redireccionamiento es la clara ganadora. Le brinda redirecciones 301 adecuadas que preservan el valor SEO y se escalan a 50,000 reglas por marca.

Para soluciones rápidas o necesidades a pequeña escala, las redirecciones de JavaScript funcionan en caso de apuro. Solo recuerde las desventajas de SEO y la advertencia de Zendesk de que no son adecuadas para un uso a largo plazo.

Si la gestión de redireccionamientos es solo un elemento en una lista creciente de limitaciones de Zendesk, podría ser el momento de considerar si la plataforma aún se adapta a sus necesidades. Las alternativas modernas de IA como eesel AI manejan estos problemas automáticamente, lo que le permite concentrarse en brindar excelentes experiencias al cliente en lugar de mantener las reglas de redireccionamiento.