Clase 06 · Módulo 09
Configurar y enviar notificaciones push
Configurar y enviar notificaciones push
Qué logras en esta clase
Envías una notificación push real desde tu servidor a tu teléfono, y al tocarla se abre la pantalla que corresponde.
- Configuras las credenciales de Android y de iOS.
- Registras el dispositivo y guardas su token.
- Envías desde una Edge Function de Supabase.
- Limpias los tokens que dejaron de servir.
02
El mapa de la clase
Son seis pasos. Los tres primeros se hacen una vez; los otros tres son código que vive en tu app y en tu servidor.
03
Antes de empezar
- Un development build (módulo 3): en Expo Go no hay push remotas.
- Un teléfono físico, o un emulador de Android con Google Play services.
- Tu proyecto enlazado a EAS, para que exista el
projectId. - Para iPhone: cuenta de Apple Developer de pago y el dispositivo registrado antes del primer build.
04
Paso 1: instalar
- Ejecuta
npx expo install expo-notifications expo-constants. - Agrega
"expo-notifications"a la listapluginsde tu configuración.
expo-notifications maneja permisos, tokens y avisos. expo-constants entrega el identificador de tu proyecto, que hace falta para pedir el token.
05
Opciones del plugin
| Opción | Para qué |
|---|---|
icon | Ícono de Android: PNG blanco sobre fondo transparente |
color | Color con que Android tiñe ese ícono |
defaultChannel | Canal que se usa si el mensaje no indica uno |
sounds | Sonidos propios |
06
Paso 2: credenciales de Android
Android entrega por FCM y Expo necesita tu autorización para enviar.
- Crea un proyecto en Firebase y registra ahí tu app de Android.
- Descarga el archivo de configuración y refiérelo en tu configuración de Expo.
- Genera una clave de cuenta de servicio y súbela a EAS.
Cada pantalla está en la guía «Add Android FCM V1 credentials» de Expo. Síguela tal cual: las consolas cambian seguido.
07
Paso 2: credenciales de iOS
En iOS casi todo lo hace la herramienta. Al ejecutar eas build para iPhone, la CLI de EAS pregunta si quieres activar las notificaciones push y genera la llave de APNs en tu cuenta de Apple.
08
Paso 3: un build nuevo
El plugin y las credenciales cambian la parte nativa. Sin un development build nuevo, nada de lo anterior existe en el teléfono.
09
Paso 4: registrar el dispositivo
El orden importa:
- Crear el canal de Android.
- Pedir el permiso de notificaciones, en contexto.
- Si aceptan, pedir el token con el
projectId. - Guardar el token en tu base, asociado al usuario.
10
Registrar, en código
await Notifications.setNotificationChannelAsync('pedidos', {
name: 'Estado de tus pedidos',
importance: Notifications.AndroidImportance.HIGH,
});
const { granted } = await Notifications.requestPermissionsAsync();
if (!granted) return;
const projectId = Constants.expoConfig?.extra?.eas?.projectId;
const { data: token } =
await Notifications.getExpoPushTokenAsync({ projectId });Después de esto, token se guarda en Supabase.
11
Dónde guardar el token
| Columna en el perfil | Tabla de dispositivos | |
|---|---|---|
| Dispositivos por usuario | Uno | Varios |
| Esfuerzo | Mínimo | Una tabla más |
| Conviene para | Un prototipo | Una app que se publica |
La tabla de dispositivos guarda usuario, token, plataforma y fecha de actualización. Con RLS (módulo 8), cada usuario solo inserta y borra sus propias filas.
12
Cuándo registrar y cuándo borrar
- Registrar: después de iniciar sesión y aceptar el permiso. Si el token ya existe, se actualiza su fecha.
- Borrar: al cerrar sesión y al eliminar la cuenta.
13
Probar antes de programar el envío
Expo tiene una herramienta web en expo.dev/notifications.
- Muestra el token en pantalla o en los registros y cópialo.
- Pégalo en la herramienta, escribe título y cuerpo, y envía.
- Comprueba que llega con la app en segundo plano.
14
Paso 5: el envío vive en el servidor
La app solo registra su token. Decidir a quién avisar y enviar ocurre en el servidor, nunca en el teléfono de otro usuario.
15
La arquitectura de envío
Es el patrón de la guía oficial de Supabase: insertas una fila en una tabla de avisos y la base llama sola a la función. Un cambio de estado en un pedido puede gatillar lo mismo.
16
Qué hace la función
- Recibe los datos de la fila nueva.
- Busca en tu base los tokens del usuario destinatario.
- Envía un
POSTahttps://exp.host/--/api/v2/push/sendcon el mensaje. - Guarda el identificador que devuelve cada recibo de envío, para consultar el comprobante.
La función se despliega con supabase functions deploy y sus secretos se cargan con supabase secrets set.
17
El mensaje
{
"to": "ExponentPushToken[xxxxxxxx]",
"title": "Tu pedido está listo",
"body": "Pasa a retirarlo cuando quieras.",
"channelId": "pedidos",
"data": { "url": "/pedidos/123" }
}to acepta un token o una lista. data no se muestra: viaja hasta tu app para que sepa qué pantalla abrir.
18
Protege el envío
Por defecto, el servicio de Expo no pide autenticación: quien consiga un token podría enviarle mensajes a ese usuario.
- Activa la seguridad reforzada para push en tu cuenta de Expo y crea un token de acceso.
- Guárdalo como secreto de la Edge Function.
- Envíalo en la cabecera
Authorization: Bearer.
Desde ese momento, un pedido sin el token de acceso se rechaza.
19
Límites del servicio al 18-11-2026
| Límite | Valor |
|---|---|
| Mensajes por pedido | 100 |
| Notificaciones por segundo, por proyecto | 600 |
| Tamaño del mensaje | 4.096 bytes |
| Vigencia de un comprobante | 24 horas |
La página consultada no indica un precio para el servicio. Antes de depender de él, revisa las condiciones vigentes en la documentación de envío de Expo.
20
Recibos y comprobantes en la práctica
- La respuesta del envío trae un recibo por mensaje, en el mismo orden.
oksignifica que Expo lo aceptó. - Unos 15 minutos después, consulta los comprobantes en
https://exp.host/--/api/v2/push/getReceiptscon los identificadores guardados. - Procesa los errores de cada comprobante.
21
Errores y qué hacer con cada uno
| Error | Significa | Acción |
|---|---|---|
DeviceNotRegistered | El token ya no existe | Borrarlo de tu base |
MessageTooBig | Supera el tamaño máximo | Achicar data |
MessageRateExceeded | Demasiados avisos a un dispositivo | Reintentar más lento |
InvalidCredentials | Credenciales de FCM o APNs inválidas | Volver a cargarlas en EAS |
Ante fallas de red o del servicio, se reintenta esperando cada vez más. Un mensaje mal formado no se reintenta: se corrige.
22
Paso 6: abrir la pantalla correcta
El usuario puede tocar el aviso con la app abierta, en segundo plano o cerrada. Hay que cubrir los tres casos en el layout raíz de Expo Router (módulo 5):
- Un oyente,
addNotificationResponseReceivedListener, para los toques con la app viva. - Una consulta al arrancar,
getLastNotificationResponse, para cuando el toque abrió la app desde cero.
23
Navegar desde el aviso
const url = respuesta.notification.request.content.data?.url;
if (typeof url === 'string') router.push(url);Es la convención que recomienda Expo Router: el servidor manda la ruta en data.url y la app navega hacia ella.
24
Con la app abierta
setNotificationHandler decide qué pasa cuando llega un aviso con la app en pantalla. En SDK 58 se muestra por defecto.
| Opción | Efecto |
|---|---|
shouldShowBanner | Aparece sobre la pantalla |
shouldShowList | Queda en la bandeja |
shouldPlaySound | Suena |
shouldSetBadge | Actualiza el número del ícono |
Si el usuario ya está mirando ese pedido, tal vez convenga solo refrescar la pantalla.
25
La prueba completa
| Estado de la app | ¿Llega? | ¿Abre la pantalla correcta? |
|---|---|---|
| Abierta | ||
| En segundo plano | ||
| Cerrada | ||
| Sin sesión iniciada |
Repite la tabla en Android y en iPhone. La push está lista cuando las ocho casillas de cada plataforma dicen que sí.
26
Lo que te llevas
- Plugin y credenciales exigen un build nuevo; en Android el canal va antes del token.
- El token se guarda por dispositivo y se borra al cerrar sesión.
- El envío sale de una Edge Function, protegido con un token de acceso.
- Los comprobantes dicen qué tokens borrar.
- El aviso lleva una ruta y la app navega a ella en los tres estados.
27
Hazlo ahora
En 15 minutos, con el development build ya configurado:
- Registra tu teléfono y comprueba que el token quedó en tu tabla.
- Envíate un aviso desde expo.dev/notifications con
{"url": "/"}en los datos. - Tócalo con la app cerrada y verifica que abre esa ruta.
- Cierra sesión y confirma que tu fila de token desapareció.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- Expo: configuración de notificaciones pushdocs.expo.dev ↗
- Expo: enviar notificaciones con el servicio de pushdocs.expo.dev ↗
- Expo: Notifications (referencia)docs.expo.dev ↗
- Supabase: enviar notificaciones push desde una Edge Functionsupabase.com ↗
- Expo: novedades de SDK 58expo.dev ↗
- Expo: EAS Update, qué puede y qué no puede cambiardocs.expo.dev ↗