Crea una integración

SDK de chat móvil

Añade el chat de soporte de Sonny a tu app de iOS, Android o React Native para clientes. Tus clientes pueden contactar con tu equipo desde dentro de tu app, usando tu bandeja de entrada de Sonny de siempre.

¿Buscas la app que usa tu equipo de soporte para responder? Instala la app de agentes de Sonny.

Elige tu SDK

Conecta tu app

  1. En un entorno de Sonny con soporte móvil, abre Canales → Chat en vivo → Apps móviles. Un propietario o administrador crea una clave de app para cada plataforma y cada bundle o ID de aplicación.
  2. Instala el SDK siguiendo el README de su repositorio. Configúralo con el ID de tu sitio y la clave pública de la app para ese destino de compilación. React Native necesita claves de app distintas para iOS y Android.
  3. Muestra el chat como una conversación a pantalla completa o intégralo en tu app. Mantén una sola vista de chat activa a la vez.
  4. Para los clientes con sesión iniciada, crea un JWT de identidad en tu servidor y pásalo al SDK. Llama a reset() al cerrar sesión para iniciar una nueva sesión de visitante.

Las claves de app son identificadores públicos. Los secretos de firma de identidad y las claves de los proveedores de notificaciones se quedan en tu servidor o en los ajustes protegidos de Sonny.

Notificaciones push

Tu app se encarga del permiso de notificaciones y de obtener el token. El SDK acepta un token de APNs en iOS o un token de FCM en Android, y gestiona los toques en las notificaciones de Sonny. La entrega necesita credenciales de tu propia app: una clave de firma de APNs y los IDs de equipo y de clave de Apple, o una cuenta de servicio de FCM para tu proyecto de Firebase. Las credenciales de la app de agentes de Sonny pertenecen a otra app. La entrega de notificaciones push sigue en validación durante esta versión preliminar.

  1. Sube las credenciales del proveedor de tu app en Apps móviles. En APNs, haz coincidir el entorno sandbox o de producción con tu compilación.
  2. Abre la app, permite las notificaciones y pasa su token al SDK. Actualiza la lista de dispositivos en los ajustes y selecciona tu dispositivo de prueba por su hora de registro.
  3. Deja la app en segundo plano y selecciona Enviar push de prueba. Comprueba que llega al dispositivo. El estado en los ajustes muestra si el proveedor la aceptó o un código de error seguro; que se acepte no confirma por sí solo que haya llegado.
  4. Para probar conversaciones, envía una respuesta de un agente o de la IA mientras el visitante está desconectado. Una notificación de respuesta abre esa conversación cuando tu app reenvía el toque a handlePush. La notificación de prueba genérica no abre ninguna conversación.

Informa de un problema o contribuye

Abre una incidencia en el repositorio del SDK que usas. Incluye su versión o commit, las versiones de tu sistema operativo y framework, y una reproducción mínima. Cada repositorio acepta pull requests e incluye pautas para contribuir y para informar de problemas de seguridad. No incluyas datos de clientes, JWT de identidad, tokens de dispositivo ni claves privadas en incidencias públicas.

Documentación relacionada