Volver al inicio

Documentación de Semsei

Documentación de Semsei Platform

Guía paso a paso para configurar marca, crear páginas con IA, conectar dominios, publicar en CMS y solucionar problemas comunes.

Nueva guía: empieza por marca y fuentes antes de generar páginas. Ese orden evita la mayoría de errores de contenido y publicación.

01 · Base del workspace

Primeros pasos

Empieza creando el proyecto correcto. En Semsei, el proyecto o workspace agrupa marca, fuentes, dominios, integraciones y páginas generadas.

Paso a paso

  1. 1

    Crea tu cuenta desde la landing o entra al dashboard si ya tienes sesión.

  2. 2

    Ve a Páginas o Dominios y usa Crear proyecto cuando no exista un workspace.

  3. 3

    Nombra el proyecto con la marca o sitio que vas a posicionar, no con una campaña temporal.

  4. 4

    Antes de generar contenido, configura marca, fuentes de búsqueda y defaults de generación.

Checklist antes de continuar

  • ✓Un proyecto por marca, sitio o dominio principal.
  • ✓No mezcles Shopify, WordPress y dominio propio en el mismo workspace si representan sitios distintos.
  • ✓Si tu plan limita proyectos o páginas, revisa billing antes de generar en volumen.

Dónde se puede perder el usuario

  • !Crear páginas antes de definir marca provoca textos genéricos.
  • !Usar un nombre interno de proyecto confunde autores, dominios y publicaciones.

02 · Contexto para la IA

Cómo configurar tu manual de marca

La configuración de marca es esencial: Semsei la inyecta en los prompts para que los contenidos respeten voz, colores, enlaces, autoría y restricciones.

Qué lee la IA de tu marca

Semsei usa nombre, sitio principal, logo, paleta, tipografías, tono, audiencia, manual, postura autoral y prohibiciones para construir el contexto de generación.

Paso a paso

  1. 1

    Entra a Settings y selecciona el workspace correcto en el selector superior.

  2. 2

    Abre la pestaña Marca y completa nombre, tagline, sitio principal y URL de logo.

  3. 3

    Configura colores de marca, colores de enlaces, botones y tipografías si el contenido debe renderizar con estilo propio.

  4. 4

    Escribe tono de voz, audiencia objetivo, postura autoral y prohibiciones de contenido.

  5. 5

    Sube el manual de marca en PDF o documento compatible y usa Analizar manual para extraer reglas automáticamente.

  6. 6

    Guarda y revisa que el sitio principal sea el destino real de CTAs e internal links.

Checklist antes de continuar

  • ✓Nombre de marca y sitio principal están completos.
  • ✓El tono indica cómo escribir, no solo adjetivos sueltos.
  • ✓Las prohibiciones dicen qué NO debe asumir la IA.
  • ✓El author/default author representa a la marca o experto correcto.

Dónde se puede perder el usuario

  • !Subir un manual y no presionar Analizar manual.
  • !Poner un sitio principal incorrecto: la IA enlazará CTAs hacia ese dominio.
  • !No definir prohibiciones cuando el sector tiene temas sensibles o regulados.

03 · Referencias de mercado

Fuentes de búsqueda y sitios de referencia

Las fuentes ayudan a Semsei a priorizar información, estilo y contexto de nicho antes de recurrir a conocimiento general.

Paso a paso

  1. 1

    En Settings selecciona el workspace y abre Fuentes.

  2. 2

    Agrega nombre, URL y categoría de cada fuente relevante.

  3. 3

    Incluye competidores, blogs de referencia, sitios técnicos y fuentes oficiales del sector.

  4. 4

    Mantén activas solo las fuentes que realmente quieres usar para generación.

Checklist antes de continuar

  • ✓Cada fuente tiene URL pública completa con https://.
  • ✓La categoría ayuda a diferenciar tecnología, salud, finanzas, arquitectura u otro nicho.
  • ✓No agregues sitios que contradigan el posicionamiento de marca.

Dónde se puede perder el usuario

  • !Agregar demasiadas fuentes diluye el criterio editorial.
  • !Usar sitios irrelevantes puede producir contenido fuera de intención de búsqueda.

04 · Reglas por defecto

Defaults de generación

Los defaults reducen errores repetidos cuando generas páginas en volumen: layout, idioma, fuentes y publicación automática.

Paso a paso

  1. 1

    En Settings abre Workspace para el proyecto elegido.

  2. 2

    Elige layout por defecto: classic, modern o card.

  3. 3

    Define idioma: Español, English o ambos.

  4. 4

    Activa Usar fuentes de búsqueda si quieres que Semsei priorice las referencias configuradas.

  5. 5

    Activa Publicar después de generar solo cuando la integración ya esté probada.

Checklist antes de continuar

  • ✓El idioma coincide con el mercado al que apunta el dominio.
  • ✓La publicación automática está apagada si aún revisas contenido manualmente.
  • ✓El layout fue probado con una página real antes de generar 100 páginas.

Dónde se puede perder el usuario

  • !Generar ambos idiomas duplica la cantidad de páginas consumidas.
  • !Publicar automáticamente antes de validar marca e integración puede enviar drafts incorrectos al CMS.

05 · Generación de contenido

Crear páginas con AI

La generación con IA crea páginas SEO en lote usando el tema, cantidad, workspace, integración, idioma y preferencias del proyecto.

Paso a paso

  1. 1

    Ve a Páginas y presiona Crear o Generar con IA.

  2. 2

    Elige el modo AI si quieres que Semsei proponga y cree páginas desde un tema.

  3. 3

    Escribe un tema claro: producto, audiencia, país, problema o intención de búsqueda.

  4. 4

    Selecciona cantidad. Usa 1 o 5 para validar; escala a 10, 100 o más cuando el flujo esté probado.

  5. 5

    Elige workspace e integración destino si quieres publicar en WordPress o Shopify.

  6. 6

    Decide si quieres descargar CSV en lugar de crear páginas dentro del dashboard.

Checklist antes de continuar

  • ✓El tema no es demasiado genérico.
  • ✓El workspace tiene manual de marca guardado.
  • ✓Hay límites de billing disponibles para la cantidad solicitada.

Dónde se puede perder el usuario

  • !Pedir muchas páginas con una intención mal definida multiplica errores.
  • !No seleccionar integración produce páginas locales que luego debes publicar manualmente.

06 · Revisión editorial

Editar y revisar páginas

Después de generar, revisa título, slug, contenido, FAQ, imagen, metadatos de Shopify y fuentes consultadas antes de publicar.

Paso a paso

  1. 1

    Abre Páginas y filtra por proyecto, estado o scheduled content.

  2. 2

    Entra a editar la página que quieres revisar.

  3. 3

    Valida título y slug: deben ser legibles, únicos y alineados con la intención.

  4. 4

    Revisa cuerpo, secciones, FAQ, imagen destacada y fuentes consultadas.

  5. 5

    Si el destino es Shopify, selecciona blog, autor, excerpt, tags y template suffix.

  6. 6

    Guarda antes de publicar o enviar a WordPress/Shopify.

Checklist antes de continuar

  • ✓Slug sin espacios ni caracteres raros.
  • ✓La FAQ responde dudas reales, no repite el contenido.
  • ✓Las fuentes consultadas no revelan referencias que no quieres mostrar.

Dónde se puede perder el usuario

  • !Cambiar el slug después de publicar puede romper URLs ya indexadas.
  • !Olvidar tags o excerpt en Shopify reduce calidad editorial del blog.

07 · SEO técnico

Conectar un dominio y Google Search Console

Los dominios propios permiten publicar páginas bajo el host que quieres posicionar y enviar sitemap a buscadores.

Dónde se puede perder el usuario

La mayoría de fallos ocurren por host DNS incorrecto, dominio duplicado en Vercel, permisos faltantes en GSC o sitemap enviado antes de verificar DNS.

Paso a paso

  1. 1

    Ve a Dominios, selecciona el proyecto y escribe el dominio sin path.

  2. 2

    Elige plataforma DNS: Vercel, Hostinger, Namecheap, Cloudflare, GoDaddy u otra compatible.

  3. 3

    Crea el registro DNS indicado por Semsei y espera propagación.

  4. 4

    Usa Verificar estado hasta que el dominio aparezca como verificado.

  5. 5

    Invita semsei@semsei-497915.iam.gserviceaccount.com en Google Search Console.

  6. 6

    Envía sitemap desde el checklist SEO y revisa Search Analytics de 28 días.

Checklist antes de continuar

  • ✓El dominio corresponde al proyecto correcto.
  • ✓El TXT/CNAME se agregó en la zona DNS correcta, no en otro proveedor.
  • ✓Google Search Console tiene permisos para la service account de Semsei.

Dónde se puede perder el usuario

  • !Agregar www en un sitio y verificar el apex, o al revés.
  • !Esperar indexación inmediata: Google puede tardar incluso con sitemap enviado.

08 · CMS

Integración WordPress

WordPress usa la REST API y un Application Password para crear posts desde Semsei.

Paso a paso

  1. 1

    En WordPress entra a Users, abre el usuario publicador y crea un Application Password.

  2. 2

    En Semsei ve a Integraciones, abre WordPress y selecciona el workspace.

  3. 3

    Ingresa URL del sitio, username y Application Password.

  4. 4

    Conecta y verifica que Semsei detecte el sitio conectado.

  5. 5

    Actualiza autor si necesitas sincronizar el author por defecto.

  6. 6

    Genera o edita una página y usa publicar/enviar a WordPress.

Checklist antes de continuar

  • ✓La URL es el dominio público de WordPress, no /wp-admin.
  • ✓El usuario tiene permisos para crear posts.
  • ✓La REST API no está bloqueada por firewall o plugins de seguridad.

Dónde se puede perder el usuario

  • !Usar la contraseña normal en vez de Application Password.
  • !Copiar el password con espacios al inicio o final.
  • !Conectar un usuario sin rol de editor/autor/publicador.

09 · Commerce

Integración Shopify

Shopify se conecta con OAuth/plugin y API keys para publicar artículos en el blog correcto de la tienda.

Paso a paso

  1. 1

    En Integraciones abre Shopify y selecciona el workspace.

  2. 2

    Conecta la tienda por OAuth o configura el plugin con la API key generada.

  3. 3

    Copia la API key cuando Semsei la muestre; solo aparece una vez.

  4. 4

    Verifica que el estado indique store connected.

  5. 5

    Al editar una página, selecciona blog, author, excerpt, tags y template suffix si aplica.

  6. 6

    Publica y abre la URL de Shopify para confirmar el artículo.

Checklist antes de continuar

  • ✓La tienda conectada corresponde al workspace activo.
  • ✓Hay al menos un blog disponible en Shopify.
  • ✓La API key no fue revocada antes de publicar.

Dónde se puede perder el usuario

  • !Perder la API key sin copiarla obliga a generar una nueva.
  • !No seleccionar blog crea dudas sobre dónde quedó el artículo.
  • !Permisos incompletos de lectura/escritura impiden cargar blogs o publicar.

10 · Salida a producción

Publicación y previews

Una página puede existir en Semsei, verse en preview, publicarse en dominio propio o enviarse a WordPress/Shopify.

Paso a paso

  1. 1

    Usa preview para revisar contenido sin depender del dominio del cliente.

  2. 2

    Publica en dominio propio cuando el proyecto ya tenga dominio verificado.

  3. 3

    Publica en WordPress o Shopify cuando la integración esté conectada y probada.

  4. 4

    Si usas drafts, revisa dentro del CMS antes de hacer público el post.

  5. 5

    Después de publicar, valida URL pública, canonical, sitemap y schema.

Checklist antes de continuar

  • ✓La URL final pertenece al dominio que quieres posicionar.
  • ✓El canonical no apunta a localhost, app-qa ni preview interno.
  • ✓El sitemap incluye la nueva página publicada.

Dónde se puede perder el usuario

  • !Confundir preview interno con URL indexable.
  • !Publicar antes de verificar dominio o integración.

11 · Diagnóstico

Troubleshooting

Usa esta sección cuando el usuario se pierda: identifica el síntoma, revisa la causa probable y corrige la configuración mínima.

Paso a paso

  1. 1

    Google no indexa: revisa robots, canonical, sitemap, enlaces internos y envío en Search Console.

  2. 2

    Sitemap no aparece: confirma dominio verificado, sitemap generado y referencia en robots.txt.

  3. 3

    Dominio no verifica: revisa host DNS, valor TXT/CNAME y proveedor correcto.

  4. 4

    WordPress falla: valida Application Password, usuario, REST API y plugins de seguridad.

  5. 5

    Shopify falla: revisa OAuth, API key, permisos, blogs disponibles y tienda conectada.

  6. 6

    AI fuera de marca: revisa manual de marca, tono, prohibiciones y fuentes de búsqueda.

Checklist antes de continuar

  • ✓Reproduce el error con una página o integración concreta.
  • ✓Cambia una variable a la vez para no mezclar causas.
  • ✓Después de corregir, vuelve a publicar o reenviar sitemap si aplica.

Dónde se puede perder el usuario

  • !Asumir que un problema de indexación es de IA cuando suele ser DNS, canonical o sitemap.
  • !Reintentar publicación sin corregir permisos de CMS.

12 · Respuestas rápidas

Preguntas frecuentes

Respuestas cortas para decisiones comunes durante setup, generación, publicación e indexación.

Paso a paso

  1. 1

    ¿Qué configuro primero? Marca, fuentes y defaults antes de generar páginas.

  2. 2

    ¿Cuándo conecto dominio? Antes de publicar contenido que quieras indexar en Google.

  3. 3

    ¿Cuándo uso CSV? Cuando quieres revisar o mover ideas de páginas fuera del dashboard.

  4. 4

    ¿Por qué mi contenido suena genérico? Normalmente falta manual de marca, tono o fuentes de referencia.