Dominio personalizado

Usa tu propio hostname, como updates.example.com, para las peticiones de Live Updates API de tu app, mientras Capgo sigue gestionando tus canales, bundles y rollouts.

Los dominios personalizados están disponibles en el plan Enterprise. Los admins de la organización pueden añadir un hostname de Live Updates API en la Console, publicar los registros DNS proporcionados y verificar su estado de activación.

1. Añade tu dominio personalizado

1. Abre la Console de Capgo y selecciona tu organización.
2. Ve a Configuración → Organización → General y busca Dominio personalizado. Necesitas permisos para editar la configuración de la organización y un plan Enterprise activo para añadir un dominio.
3. Introduce un hostname como updates.example.com, sin https://, una ruta o un wildcard.
4. Haz clic Añadir dominio. La Console muestra los registros DNS para publicar y un Pendiente de verificación estado.

Puedes configurar un hostname de API Live Updates por organización. Debes tener acceso para editar sus registros DNS.

Si la opción Dominio personalizado no está disponible, contacta a tu soporte de Enterprise o envía un email a support@capgo.app con tu organización, IDs de la app, hostname deseado y proveedor de DNS. Contacta a soporte antes de la configuración si necesitas una región de residencia de datos específica o un hostname personalizado para la descarga de bundles.

Precaución

Un registro DNS por sí solo no activa un dominio personalizado. También debe configurarse el enrutamiento y el HTTPS. Espera hasta que la Console muestre Activo, o el soporte confirma la activación en configuraciones asistidas, antes de cambiar la configuración de producción.

2. Configurar DNS y verificar HTTPS

En tu proveedor de DNS, añade los registros que aparecen en la Console o que te proporcione el soporte. Copia el tipo de registro, el nombre y el valor exactamente, incluyendo el CNAME y cualquier registro TXT de verificación de propiedad o certificado. Haz clic en un valor de la Console para copiarlo. Si usas Cloudflare DNS, mantén el CNAME solo DNS a menos que el soporte confirme una configuración distinta.

Usa el target proporcionado en lugar de asumir que un CNAME hacia plugin.capgo.app es suficiente. Mantén los registros DNS activos mientras el dominio esté en uso.

Una vez propagado el DNS, haz clic en Refrescar estado. La consola lo muestra Activo solo cuando tanto el hostname como su certificado HTTPS están activos; entonces ofrece Copiar configuración del updater. Para una configuración asistida, solicita confirmación de activación al soporte. También puedes inspeccionar el DNS y verificar la conectividad TLS con:

dig updates.example.com
curl -v https://updates.example.com/updates

Reemplaza updates.example.com con tu hostname aprovisionado. El curl comando verifica la conectividad DNS, TLS y HTTP; una petición GET a /updates no es una comprobación de actualización válida y puede devolver un error API. Verifica el flujo de actualización real con un Native Build de prueba en el paso 4.

3. Configurar el updater

Una vez que el dominio esté activo, copia la configuración del updater desde la Console y combina las tres URLs en capacitor.config.ts. Para un hostname con las rutas estándar de Capgo API, usa:

import type { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'My App',
  webDir: 'dist',
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground',
      updateUrl: 'https://updates.example.com/updates',
      statsUrl: 'https://updates.example.com/stats',
      channelUrl: 'https://updates.example.com/channel_self',
    },
  },
};

export default config;

Reemplaza las URLs de ejemplo con las URLs exactas de la Console o confirmadas por soporte. Mantén la configuración actual de tu app y otras opciones de plugins.

Configuración	Propósito
updateUrl	Busca un bundle disponible.
statsUrl	Reporta estadísticas de actualizaciones.
channelUrl	Handles device channel operations.

Nota

Estos ajustes cambian los endpoints de API. Las descargas de bundles usan las URLs devueltas por el servidor de updates, por lo que cambiar esto no asigna automáticamente un dominio personalizado a las descargas. Confirma los requisitos del hostname con soporte.

4. Sincroniza, prueba y lanza

Sincroniza la configuración en tus proyectos nativos:

npx cap sync

Genera e instala una versión nativa de prueba, luego:

1. Sube un bundle de prueba a un canal de prueba usando tu flujo de trabajo habitual de Capgo.
2. Revisa los logs del dispositivo nativo para verificar que las peticiones de update lleguen a tu hostname personalizado y que el bundle se descargue e instale correctamente.
3. Confirma que las estadísticas de actualización aparezcan en la Console y prueba las operaciones de canal si tu app las utiliza.
4. Lanza una nueva versión nativa de la app mediante tu proceso habitual de distribución en las tiendas.

Precaución

Los cambios en capacitor.config.ts requieren un Native Build. Subir solo un bundle de JavaScript no aplica estos cambios a las instalaciones actuales de iOS y Android. Los usuarios empezarán a usar el dominio personalizado tras instalar la nueva versión nativa.

Las versiones nativas antiguas seguirán usando sus URLs de endpoint configuradas hasta que los usuarios instalen la nueva versión. El hostname por defecto del updater es plugin.capgo.app, el cual gestiona Capgo. Si estás migrando desde otro hostname personalizado que controlas, mantén sus registros DNS y el servicio activo hasta que esos usuarios hayan migrado. Los channels, bundle uploads y rollbacks seguirán usando tu Capgo Console y el flujo de CLI habitual.

Solución de problemas

Para eliminar un dominio, usa Eliminar dominio → Confirmar eliminación en la configuración de la Organization. Primero lanza una versión nativa de la app usando los endpoints de reemplazo y permite que los usuarios migren: las versiones antiguas perderán el acceso a través del hostname eliminado. Elimina el dominio antes de borrar su organización.

• El DNS no resuelve: verifica que el nombre del registro y el target coincidan con los valores de soporte, y comprueba la propagación con tu proveedor de DNS.
• Error de HTTPS: pide a soporte que verifique la activación del hostname y el aprovisionamiento del certificado antes de lanzar el Native Build.
• Las peticiones siguen usando plugin.capgo.app: confirma las tres URLs, ejecuta npx cap sync, reconstruye e instala la nueva versión nativa.
• La descarga del bundle usa otro hostname: la respuesta de la actualización incluye la URL de descarga. Consulta a soporte sobre la entrega de bundles personalizados, o mira Almacenamiento personalizado si prefieres gestionar tú mismo el almacenamiento de los bundles.
• Updates fail despite valid HTTPS: comparte el app ID, el channel, la versión nativa, el timestamp de la petición y los logs nativos con el soporte de Capgo.

Consulta Configuración del Updater para la referencia completa de configuración y Ubicación de datos para los requisitos de los endpoints regionales.