Helpium

Enviar notificaciones push para respuestas de agentes

Widget de ChatActualizado 16 de octubre de 2026

Cuando un agente responde a un cliente que chatea dentro de tu aplicación, Helpium puede enviarle una notificación push, incluso cuando la aplicación está cerrada. Tocar la notificación abre la conversación.

Las notificaciones se envían desde tu propia cuenta de Apple y Firebase, por lo que provienen de tu aplicación y mantienes el control de las claves.

Qué se envía

  • Respuestas de agentes humanos. Las respuestas del bot llegan mientras el cliente está en el chat, por lo que no se envían como notificaciones.
  • Las notas internas nunca salen de la bandeja de entrada.
  • Si una respuesta sigue sin ser vista después de 5 minutos, se envía el correo electrónico de respuesta no vista (una configuración de Chat en Vivo).

1. Conectar Apple (iOS)

  1. Ve a developer.apple.com → Certificados, Identificadores y Perfiles → Claves y haz clic en +.
  2. Nombra la clave, marca Apple Push Notifications service (APNs) y regístrala.
  3. Descarga el archivo .p8. Apple te permite descargarlo solo una vez. Toma nota del ID de clave.
  4. Tu ID de equipo está en los detalles de Membresía, en la parte superior derecha del portal de desarrolladores.
  5. En Helpium, ve a Canales → Chat en Vivo → Aplicaciones móviles → iOS → Conectar. Sube el archivo .p8, luego ingresa el ID de clave, ID de equipo y el ID de paquete de tu aplicación.
  6. Elige Producción para las compilaciones de TestFlight y App Store. Elige Sandbox solo para las compilaciones que ejecutes desde Xcode.

2. Conectar Firebase (Android)

  1. En la consola de Firebase, abre tu proyecto → Configuración del proyecto → Cuentas de servicio.
  2. Haz clic en Generar nueva clave privada para descargar el archivo JSON.
  3. En Helpium, ve a Canales → Chat en Vivo → Aplicaciones móviles → Android → Conectar y sube el archivo.

La sección de Aplicaciones móviles muestra cuántos teléfonos están registrados en cada plataforma.

3. Pasar el token push al SDK

iOS: habilita la capacidad de Notificaciones Push en Xcode, luego:

func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
    Helpium.setPushToken(deviceToken)
}

func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse) async {
    Helpium.handlePush(response.notification.request.content.userInfo)
}

Android: en tu FirebaseMessagingService, y en tu actividad de lanzamiento para toques mientras la aplicación estaba cerrada:

@Override
public void onNewToken(@NonNull String token) {
    Helpium.setPushToken(token);
}

// Actividad de lanzamiento
Helpium.handlePush(this, getIntent().getExtras());

El SDK no registra su propio servicio de Firebase, por lo que nunca entra en conflicto con las notificaciones que tu aplicación ya envía. La referencia completa muestra cómo mostrar notificaciones de Helpium mientras la aplicación está abierta.

Solución de problemas

  • No llega nada en iOS: verifica el ID de paquete y que el entorno coincida con la compilación (Sandbox para compilaciones de Xcode).
  • No llega nada en Android: la cuenta de servicio debe pertenecer al mismo proyecto de Firebase que el google-services.json de tu aplicación. En Android 13+, el usuario debe permitir notificaciones.
  • No hay teléfonos listados en Aplicaciones móviles: un teléfono se registra después de que el cliente envía su primer mensaje. Asegúrate de que se llame a setPushToken.

Artículos relacionados