Un canal muestra «failed»
Cuando un canal muestra «Necesita atención» en la página
Channels, o una entrada CHANNELS.PUBLISH vuelve con un
nivel de error, recorre esta página para encontrar la
causa y arreglarla.
El mensaje de error subyacente es la pista más rápida — empieza leyéndolo, después coteja con las secciones de abajo.
Encontrar el mensaje de error
Un fallo de canal normalmente dispara un aviso de Conexión en tu icono de campana — ábrelo para ver el error subyacente y una acción de Reconectar de un solo clic. Si la campana no tiene nada para ese canal, abre la ejecución más reciente de la campaña desde el panel y mira el paso Channels en el detalle de la ejecución; cada resultado por canal lleva la razón en su propia fila.
Si la fila tiene contexto extra (una vista expandida muestra una traza de pila o respuesta cruda del proveedor), esa es la pista más útil — es lo que la propia API del canal nos devolvió.
Error: OAuth / autorización
Mensajes como: invalid_grant, Token expired,
Unauthorized, Access token revoked, 401.
Aplica a: LinkedIn (o cualquier futuro canal OAuth).
Por qué: cambiaste tu contraseña de LinkedIn, revocaste Structura de las apps autorizadas de LinkedIn, o el token expiró naturalmente.
Arreglo:
- Abre Structura → Channels.
- Haz clic en la tarjeta de LinkedIn.
- Haz clic en Reconectar. Recorre el flujo OAuth.
Mira LinkedIn y Desconectar o reconectar.
Error: URL de webhook inválida
Mensajes como: 404, Webhook not found,
invalid_token (Slack).
Aplica a: Slack, Discord.
Por qué: el webhook se borró en Slack/Discord — o el canal se archivó, o un admin revocó la app, o alguien regeneró el webhook.
Arreglo:
- En Slack/Discord, crea un nuevo incoming webhook en el canal de destino. Mira la página de Slack o Discord para los pasos exactos.
- Copia la nueva URL.
- En Structura, abre el panel de instalación del canal y haz clic en Reconectar. Pega la nueva URL.
Error: limitado por tasa
Mensajes como: 429, rate limit exceeded,
Too many requests.
Aplica a: cualquier canal, pero más común para LinkedIn si publicas muchas entradas en una ventana corta.
Por qué: la API del canal nos está limitando por volumen reciente.
Arreglo:
- Espera — la mayoría de límites de tasa se aclaran en minutos a una hora.
- Si es persistente, comprueba si estás corriendo una ráfaga inusual (p. ej. publicando un backlog). Reduce la cadencia.
- Los envíos no se reintentan automáticamente, así que las entradas perdidas durante la limitación no se pondrán al día solas; comparte manualmente si importan.
Error: payload demasiado grande
Mensajes como: Payload exceeds limit,
Image too large, 413.
Aplica a: canales que envían la imagen destacada — Discord, Telegram, Slack (menos común).
Por qué: la imagen destacada de la entrada excede el límite de tamaño de archivo o píxeles del canal.
Arreglo:
- Usa imágenes destacadas más pequeñas. Los ajustes de Visuals integrados en Structura pueden ponerse a una ratio de aspecto menor, o usa JPEG/WebP (más pequeño que PNG) en Structura → Ajustes → Visuals → Format Encoding.
- Si una entrada ya publicada falló al enviar por esta razón, el texto del mensaje probablemente sí pasó — comprueba el canal.
Error: específico de Telegram
Mensajes:
chat not found— ID de chat erróneo, o el bot no es miembro de ese chat/canal. Para canales, el bot debe ser administrador.Forbidden: bot can't initiate conversation with a user— para chats privados, debes mandar mensaje al bot primero. Manda al bot un mensaje en Telegram, después reintenta.Unauthorized— token del bot erróneo.
Arreglo: mira Telegram para cómo verificar el token y la ID de chat, y cómo reconectar con valores corregidos.
Error: específico de IndexNow
Mensajes:
Key file mismatch— el archivo<key>.txten la raíz de tu sitio no coincide con la clave bajo la que estamos enviando. O re-sube el archivo correcto, o regenera la clave en el panel de instalación y sube un archivo nuevo.Key file not reachable— no pudimos obtener el archivo por HTTP. Comprueba que esté en la raíz web (no en/wp-content/), accesible sin auth, y devolviendo 200.
Mira IndexNow.
Error: el correo no se envió
Mensajes: wp_mail failed, SMTP error.
Aplica a: Correo al propietario.
Por qué: el correo saliente de WordPress no está configurado correctamente en este sitio.
Arreglo: mira la sección «Asegúrate de que WordPress puede enviar correo de verdad» de Correo al propietario.
Error: todo lo demás
Algunos fallos de canal son transitorios — un breve corte
en el canal, un parpadeo de red. Si el mensaje de error es
genérico (500, Unknown error, timeout) y aislado:
- Espera una hora.
- Mira si la siguiente entrada programada se envía con éxito.
- Si lo hace, fue un problema transitorio — no hay acción necesaria más allá de compartir manualmente la entrada perdida si quieres.
- Si los fallos persisten, trátalo como un problema de credencial y reconecta.
Cuando el canal funciona pero el mensaje se ve mal
Si el envío tuvo éxito según el detalle de la ejecución pero el mensaje se ve raro en Slack/Discord/LinkedIn (título truncado, imagen rota, sin previsualización de enlace):
- Las previsualizaciones de enlace en LinkedIn vienen de
las etiquetas Open Graph de tu entrada. Si tu tema o
plugin SEO no las emite, LinkedIn no renderizará una
previsualización. Comprueba con una herramienta como
https://www.opengraph.xyz. - Los embeds de Slack/Discord pueden verse afectados por detalles del contenido de la entrada. Si el problema es reproducible, mándanos una URL de ejemplo.
Si estás atascado
Contacta con soporte con:
- El nombre del canal.
- El texto del error del aviso (o del paso Channels del detalle de la ejecución).
- La hora aproximada del envío fallido.