eSIM

¿Instalar una eSIM es lo mismo que activar un plan?

La instalación agrega una SIM digital al dispositivo; la activación y el inicio de la vigencia del paquete siguen las reglas del servicio seleccionado.

El cliente ve “installed” en el teléfono y “pending” en una app. Esas etiquetas pueden describir observaciones distintas. El dispositivo, la red y el registro de compra no comparten un estado universal.

¿Qué pasos debe entender el cliente?

El proveedor entrega un perfil de SIM digital que contiene la identidad móvil y las credenciales que el dispositivo usa para conectarse. La instalación agrega ese perfil al dispositivo. El plan adquirido determina qué servicio puede usar el cliente.

Es posible que el cliente necesite habilitar el perfil. También puede necesitar seleccionarlo para datos móviles. El cliente sigue además las instrucciones de roaming del plan.

Conectarse a una red con cobertura y usar datos son resultados adicionales. Un pago exitoso establece un resultado de compra; no demuestra que esos pasos en el dispositivo hayan ocurrido.

¿Cuándo comienza el paquete?

La oferta seleccionada define el evento que inicia el paquete y el período de vigencia. Tu app debe mostrar esos términos antes de que el cliente decida cuándo instalar.

Para un cliente que se prepara antes del viaje, separa los pasos disponibles en casa de los que requieren una red con cobertura en el destino.

¿Por qué pueden diferir los estados mostrados?

Gigs muestra un estado de perfil desconocido cuando no dispone de información del ciclo de vida. Tu app debe mantener visible ese estado. La falta de información no demuestra que la instalación haya tenido éxito ni que haya fallado.

En el ciclo de vida del perfil de Gigs, una respuesta de estado puede omitir etapas. Un evento de Gigs sobre un perfil deshabilitado puede llegar con retraso si el dispositivo ha perdido la conexión. Muestra el estado reportado con su hora de observación. Si alguno de los dos no está disponible, mantén esa ausencia visible.

En tu recorrido de instalación, mantén las instrucciones de configuración disponibles hasta que el cliente haya verificado la conexión. Una confirmación de compra por sí sola no puede establecer ese resultado.

En resumen

  1. La instalación describe el perfil del dispositivo.

    Un perfil puede estar presente en un teléfono sin que el servicio de red previsto esté en uso.

  2. La oferta especifica la regla de vigencia.

    La oferta define el evento que inicia el paquete y su periodo de validez.

  3. Una observación ausente no es una instalación fallida.

    Muestra un estado no disponible como desconocido y mantén visibles las horas de observación.

Ponlo en práctica.

Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.

Obtener un resumen de implementación

Construye tu servicio móvil con Bird.

Trae tus mercados, requisitos de plan y recorrido del cliente. Explora la conectividad móvil con Bird y prepara tu primer servicio.

Empieza con un canal.
Añade los demás cuando estés listo.

Una clave API de prueba es tuya de inmediato. El acceso a producción se desbloquea cuando añades un método de pago y verificas un remitente.

¿Usas Claude Code, Cursor o Codex? Copia un prompt de configuración y tu agente instalará el Bird CLI y las habilidades por ti. Elige el tuyo:

Cursor