Conectar un dominio propio a tu tienda Neges
Aprende a publicar tu tienda con un dominio como maquinas3b.cl, copiar la configuración DNS y revisar su estado desde el backoffice.
Un dominio propio hace que tu tienda se vea como parte directa de tu marca. En vez de usar solo una URL tipo tienda.neges.cl, puedes publicar la tienda en un dominio como maquinas3b.cl y revisar la configuración desde Neges.
Antes de empezar
Ten a mano el dominio raiz que quieres usar, por ejemplo maquinas3b.cl. Tambien necesitaras acceso al panel donde administras los DNS de ese dominio: NIC, Cloudflare, GoDaddy u otro proveedor.
No necesitas conocer Vercel ni Strapi para usar este flujo. Neges te mostrará la configuración DNS que debes copiar y el estado del dominio.
En Neges debes tener rol administrador sobre la empresa. Si ves la empresa pero no aparece el bloque Dominios o el botón Editar, pide a un administrador que revise tu rol.
Dominio raiz, www y subdominios
Para una tienda Neges en NIC.cl, lo recomendado es conectar el dominio raiz, por ejemplo maquinas3b.cl. No ingreses https://, rutas, puertos ni barras. Si pegas una URL como https://maquinas3b.cl/, Neges la limpiara y guardara maquinas3b.cl.
No necesitas conectar www.maquinas3b.cl como dominio separado si quieres que la tienda viva en maquinas3b.cl. Al conectar el dominio raiz, Neges prepara la configuracion para que Vercel atienda el dominio principal y maneje www como redireccion o alias segun el proyecto.
Conectar un subdominio como tienda.maquinas3b.cl solo tiene sentido si quieres mantener el dominio raiz para otro sitio, por ejemplo un sitio corporativo externo. En ese caso Neges mostrara un registro CNAME en vez de servidores DNS de NIC.cl.
Qué escribir en Neges
| Quieres publicar | Escribe en Neges | Qué configura el proveedor |
|---|---|---|
| La tienda principal en maquinas3b.cl | maquinas3b.cl | NIC.cl delega el dominio a ns1.vercel-dns.com y ns2.vercel-dns.com. |
| La tienda principal, aunque pegaste una URL completa | https://maquinas3b.cl/ | Neges limpia la URL y guarda maquinas3b.cl. |
| Sólo un subdominio, manteniendo el dominio raiz para otro sitio | tienda.maquinas3b.cl | El proveedor DNS actual crea un CNAME para tienda. |
| El dominio con www como URL pública principal | No recomendado para este flujo | Conecta el dominio raiz y deja www como redireccion al principal. |
Conectar el dominio paso a paso
Abre Empresa
Desde el backoffice, entra a Empresa y abre la empresa que tiene la tienda online.
Abre el bloque Dominios
En el detalle de la empresa, busca el bloque Dominios y presiona Editar. Esta pantalla muestra los dominios conectados, su estado y la configuración DNS que debes copiar.
Escribe el dominio que quieres conectar
Ingresa el dominio raiz, sin https://, sin www, sin rutas y sin puertos. Para una tienda en maquinas3b.cl, escribe maquinas3b.cl.
Tip: Si pegas una URL completa, Neges conservara solo el dominio raiz. Revisa el valor antes de conectar.Copia la configuración DNS
Neges muestra la configuración DNS dentro de la tarjeta del dominio. En NIC.cl normalmente verás los servidores de nombre que debes copiar, por ejemplo Servidor 1 y Servidor 2. En otros proveedores puedes ver registros A, CNAME o TXT.
Agrega los registros en tu proveedor DNS
Abre el panel del proveedor del dominio y carga cada valor exactamente como aparece en Neges. Si usas NIC.cl con dominio raiz, reemplaza los servidores DNS por los servidores que aparecen en la tarjeta.
Vuelve a Neges y revisa el estado
Cuando guardes los cambios DNS, vuelve a la pantalla Dominio de tienda y presiona Revisar estado. Si el DNS todavía no propaga, espera unos minutos y vuelve a intentarlo.
Déjalo como dominio principal
Cuando el estado cambie a Activo, confirma que el dominio tenga la etiqueta Principal. Si tienes más de un dominio activo, usa Usar principal en el dominio que quieras publicar como URL definitiva.
Prueba la tienda
Abre el dominio raiz en una ventana privada y revisa home, producto, checkout y retorno de pago. Luego prueba www para confirmar que redirige o atiende el mismo sitio.
Flujo real del dominio
Este diagrama es la fuente de verdad del flujo. Separa el alta del dominio, la configuracion DNS, la verificacion manual o automatica y la resolucion del tenant cuando un cliente abre la tienda.
Contexto técnico para soporte y Codex
| Pieza | Responsabilidad | Dato clave |
|---|---|---|
| Backoffice Angular | Normaliza la entrada, llama endpoints de dominios y muestra DNS, auditoria, diagnostico y health de verificacion. | POST /api/me/tenants/:tenantId/domains y POST /domains/:domainId/verify. |
| Strapi tenant-domain | Valida hostnames, crea el dominio en Vercel, calcula expectedDnsRecords, guarda tenant_domains y resuelve dominios activos para storefront. | normalizedHostname es unico mientras el dominio no este disabled. |
| tenant_domains.metadata.audit | Guarda quien conecto, verifico, marco principal o desconecto el dominio. | Permite distinguir cambios manuales de revision automatica. |
| dnsDiagnostics | Compara los NS que Neges espera con la delegacion real consultada en DNS publico/NIC.cl. | Si NIC.cl delega a otro valor, el backoffice muestra el valor actual y el esperado. |
| Cron de verificacion | Revisa periodicamente dominios pendientes si esta habilitado en configuracion productiva. | DOMAIN_VERIFICATION_CRON_ENABLED y DOMAIN_VERIFICATION_MIN_AGE_MINUTES controlan el comportamiento. |
| neges-store | Recibe el Host real, reenvia X-Store-Host a Strapi y renderiza la tienda con tenant, canonicalHost, favicon y marca. | Para custom domains, Strapi resuelve por tenant_domains antes de intentar subdominios neges.cl. |
Qué valida cada parte
| Validación | Quién la hace | Qué confirma |
|---|---|---|
| Formato del dominio | Backoffice y Strapi | Que el valor sea un hostname válido y que una URL pegada quede limpia antes de guardar. |
| Dominio en Vercel | Strapi con Vercel API | Que el dominio exista en el proyecto Store y que Vercel entregue la configuración esperada. |
| Delegación DNS real | Strapi consultando DNS público/NIC.cl | Que NIC.cl actualmente delegue a ns1.vercel-dns.com y ns2.vercel-dns.com. |
| Revisar estado | Botón del backoffice | Ejecuta una verificación manual contra Vercel aunque la revisión automática no haya corrido todavía. |
| Revisión automática | Proceso periódico de Strapi | Reintenta dominios pendientes sin que el administrador tenga que presionar el botón. |
| Resolución de tenant | neges-store y Strapi | Que el Host recibido corresponda a un tenant-domain activo y principal o redireccionable. |
Cómo leer los estados
| Estado | Qué significa | Qué hacer |
|---|---|---|
| DNS pendiente | El dominio ya fue creado en Neges, pero Vercel todavía no ve los registros correctos. | Compara los valores del bloque DNS con tu proveedor. Luego presiona Revisar estado. |
| Verificación pendiente | Vercel necesita confirmar propiedad con un registro TXT. | Copia el TXT exactamente como aparece y vuelve a revisar después de la propagación. |
| Activo | El dominio ya apunta correctamente a la tienda. | Márcalo como principal si quieres usarlo como URL pública definitiva. |
| Error | La automatización no pudo completar la revisión o Vercel devolvió un problema. | Lee el mensaje mostrado en la tarjeta y corrige DNS o solicita soporte. |
Buenas prácticas para evitar fricción
- Usa un dominio que controles y que no esté conectado a otra tienda.
- Conecta maquinas3b.cl, no www.maquinas3b.cl, salvo que explicitamente quieras publicar solo un subdominio.
- Si conectas maquinas3b.cl, usa www.maquinas3b.cl solo como redireccion al dominio principal.
- En NIC.cl, usa los servidores DNS que muestra Neges cuando el bloque indique Servidor 1 y Servidor 2.
- Evita mezclar el dominio de la tienda con el dominio de la API. La API productiva sigue siendo api.neges.cl.
- No cambies DNS varias veces seguidas. Espera propagación antes de diagnosticar.
- Si usas Cloudflare u otro proxy, deja el registro sin proxy mientras revisas el dominio.
- Prueba el checkout después de activar el dominio principal, porque los retornos de pago usan esa URL.
Errores frecuentes
| Mensaje o síntoma | Causa probable | Solución |
|---|---|---|
| El dominio aparece como pendiente por mucho tiempo | El DNS todavía no propagó o NIC.cl sigue delegando a servidores distintos. | Compara el diagnóstico visible en Neges. Si muestra "NIC.cl actualmente delega a X", corrige los servidores en NIC.cl. |
| NIC.cl está correcto, pero el navegador muestra NXDOMAIN | El resolvedor local o el navegador todavía tiene caché DNS anterior. | Prueba con ventana privada, cambia de red o valida con dig/WhatsMyDNS antes de cambiar nuevamente la configuración. |
| El dominio ya está conectado | Ese host ya pertenece a otro tenant o quedó creado previamente. | Elimina el dominio del tenant anterior o solicita soporte para revisar la asignación. |
| La tienda abre, pero muestra otra marca | El dominio apunta al proyecto, pero Strapi no encuentra o no tiene activo el tenant-domain correcto. | Verifica que el dominio esté activo dentro de la empresa correcta. |
| El backoffice dice Activo, pero la tienda no carga | Vercel ya verificó el dominio, pero puede faltar propagación local, certificado SSL o resolución del tenant por Host. | Prueba https://maquinas3b.cl y https://www.maquinas3b.cl, revisa que el dominio sea Principal y solicita soporte si persiste. |
| El pago vuelve al subdominio Neges | Aún no hay dominio propio activo marcado como principal. | Marca el dominio activo como principal antes de probar el pago. |
Checklist al terminar
- El dominio está creado en la pantalla Dominio de tienda.
- La configuración DNS visible en Neges está cargada en el proveedor.
- El estado del dominio aparece como Activo.
- El dominio activo está marcado como Principal.
- Home, producto, checkout y retorno de pago abren desde el dominio propio.
- El subdominio Neges sigue funcionando como respaldo operativo.
Recursos relacionados
¿Te fue útil este contenido?
Tu feedback nos ayuda a mejorar la documentación de Neges.
¿No encuentras lo que buscas?
Conversa con nuestro equipo de soporte en español. Respondemos por WhatsApp, correo o ticket en menos de 24 horas hábiles.