Chat en tu app para iOS y Android: el SDK móvil
En esta página
El SDK móvil de Deskwoot lleva tu chat en vivo a tu propia app para iOS y Android como una pantalla nativa, no como una página web. Tus clientes le escriben a tu equipo y a tu bot de IA desde la app, y tu equipo responde en Deskwoot como siempre. Cuando la app está cerrada, las respuestas llegan al teléfono del cliente como notificaciones push. Tu desarrollador integra el SDK en la app con ayuda de la documentación para desarrolladores. Tú haces 2 cosas en Deskwoot, las dos en tu bandeja de entrada de chat en vivo, en Chat en tu app para iOS y Android: copias el token del widget para tu desarrollador y guardas tu clave de Apple y tu cuenta de servicio de Firebase para que Deskwoot pueda enviar las notificaciones push.
Qué reciben tus clientes en tu app
Es el mismo chat que en tu sitio web. La app lee la misma configuración de la bandeja de entrada (tu color de marca, tus textos, tu equipo, tu bot de IA y tu centro de ayuda) y muestra el diseño que elegiste para la bandeja: Sencillo, Bienvenida o Directo. Las conversaciones de la app llegan a esa bandeja de entrada, y tu equipo las responde como cualquier otro chat.
- El chat es una pantalla nativa de tu app en iPhone, iPad y Android, no una página web. Solo el texto de un artículo de ayuda se muestra en una web view.
- Tus clientes le escriben a tu equipo y a tu bot de IA, buscan en tu centro de ayuda y leen las respuestas sin salir de la app. Pueden enviar fotos y archivos, y también fotos tomadas con la cámara si tu app permite la cámara.
- El chat habla los 10 idiomas para visitantes del chat de tu sitio web. Usa el idioma fijo de la bandeja de entrada si configuraste uno; si no, el idioma de tu app; si no, inglés. Por defecto se ve claro u oscuro como tu app.
- Cuando llega una respuesta con la app abierta y el chat cerrado, sube una pequeña tarjeta en la parte inferior de la app con la foto y el nombre de quien escribió y 2 líneas de la respuesta. Un toque abre la conversación. Tu desarrollador puede desactivar la tarjeta.
- La app sabe cuántas respuestas el cliente todavía no leyó, por ejemplo para mostrar un contador en tu botón de ayuda. También puede mostrar sobre la app el botón redondo de chat de tu sitio web, pero ese botón queda oculto hasta que tu desarrollador lo active.
- Cuando la app está cerrada, las respuestas llegan como notificaciones push, una vez que las configures (paso 2 más abajo).
Tu app decide dónde se abre el chat: en su página de inicio, en la conversación más reciente del cliente, en una conversación nueva con un texto que tú eliges ya escrito (el cliente puede cambiarlo y lo envía él mismo) o directamente en tu centro de ayuda. La mayoría de las apps lo abren desde su propio botón de ayuda.
Qué necesitas
- Una bandeja de entrada de chat en vivo en Deskwoot. La app usa su token del widget. Con el token de la bandeja de entrada de tu sitio web, los chats de la app y los del sitio llegan a la misma bandeja. Para separarlos, crea una segunda bandeja de entrada de chat en vivo para la app.
- Tu propia app para iPhone y iPad (iOS 15 o posterior), para Android (Android 5.0 o posterior) o para los dos. El SDK es nativo: Swift en iOS, Kotlin o Java en Android. Funcionan tanto las apps de Android hechas con Views como las hechas con Jetpack Compose. No hay paquete para React Native ni para Flutter (consulta las preguntas más abajo).
- Un desarrollador que integre el SDK en tu app. Todo lo que necesita está en la documentación para desarrolladores.
- Para notificaciones push en iPhone: una cuenta de Apple Developer en la que puedas crear claves. Apple lo permite al Account Holder y a los Admins.
- Para notificaciones push en Android: acceso al proyecto de Firebase de tu app para Android. La app necesita Firebase Cloud Messaging.
- En Deskwoot, el permiso para administrar bandejas de entrada. Lo tienen los administradores y los agentes cuyo rol personalizado incluye Administrar bandejas de entrada.
Puedes usarlo con cualquier plan de Deskwoot. Deskwoot no revisa ningún plan para el SDK ni para las notificaciones push, y todos los planes incluyen bandejas de entrada de chat en vivo.
Paso 1: Dale a tu desarrollador el token del widget
- Ve a Configuración > Bandejas de entrada y abre la bandeja de entrada de chat en vivo que va a usar la app.
- En Configuración y privacidad, haz clic en Chat en tu app para iOS y Android.
- Arriba, en Token del widget, haz clic en Copiar y envíale el token a tu desarrollador. La app se lo pasa a Deskwoot al iniciar, con una sola llamada:
Deskwoot.setup. - Al final del panel, Cómo agregar el SDK a tu app abre la documentación para desarrolladores. Envíale ese enlace a tu desarrollador también: deskwoot.com/es/docs/mobile.
Eso es todo lo que necesita el chat: funciona en la app también sin notificaciones push. Las notificaciones push (paso 2) suman las respuestas que llegan mientras la app está cerrada.
Paso 2: Configura las notificaciones push
Las notificaciones push requieren trabajo de los dos lados. Tu desarrollador prepara la app como lo explica la documentación para desarrolladores en Notificaciones push. Tú guardas las credenciales con las que envía Deskwoot: una clave de autenticación de APNs de Apple para los iPhone y una cuenta de servicio de Firebase para los teléfonos Android. Después, el servidor de Deskwoot envía cada push con tus propias cuentas de Apple y Google. El SDK de la app nunca se comunica con Apple ni con Google.
Puedes configurar iOS, Android o los dos. Cada bloque del panel tiene su propio botón Guardar. Al hacer clic, Deskwoot primero les pregunta a Apple o a Google si aceptan lo que escribiste, y solo lo guarda si lo aceptan. Si lo rechazan, una línea debajo del bloque dice qué está mal y no se guarda nada. Si Apple o Google no responden, inténtalo de nuevo en un momento.
Notificaciones push en iPhone: tu clave de APNs
Necesitas 4 datos de tu cuenta de Apple Developer:
- La clave de autenticación de APNs, un archivo que termina en
.p8. En tu cuenta de Apple Developer, ve a Certificates, Identifiers & Profiles, haz clic en Keys y crea una clave con el Apple Push Notification service activado. Descarga el archivo y guárdalo bien: Apple te deja descargarlo una sola vez. - El ID de clave. Apple lo muestra debajo del nombre de la clave cuando la seleccionas en Keys. Tiene 10 letras y números.
- Tu ID de equipo. Está en tu cuenta de Apple Developer, en Membership details, y también tiene 10 letras y números.
- El Bundle ID de tu app, por ejemplo
com.example.app. Tu desarrollador lo conoce por Xcode, y Apple lo muestra en Certificates, Identifiers & Profiles, Identifiers.
Apple puede limitar una clave a un solo entorno, sandbox o production. Las apps del App Store y de TestFlight usan production, y las compilaciones de desarrollo usan sandbox. Cuando guardas la clave, Deskwoot le pregunta a Apple para qué entornos sirve, y si es solo uno, te lo dice una línea en el bloque iOS. Si la clave sirve solo para sandbox, la línea es una advertencia: los iPhone con tu app del App Store o de TestFlight no reciben notificaciones push, así que crea también una clave para production y guárdala. Si sirve solo para production, es solo una nota: las compilaciones de desarrollo de tu app no reciben notificaciones push. En los dos casos el bloque dice Conectado, porque Apple aceptó la clave. Así que asegúrate de que tu clave sirva para production, donde funciona la app de tus clientes.
Luego, en Deskwoot:
- En Chat en tu app para iOS y Android, ve al bloque iOS.
- Pega el contenido del archivo
.p8en Clave de autenticación de APNs (.p8), o haz clic en Subir archivo .p8 y elige el archivo. - Escribe el ID de clave, el ID de equipo y el Bundle ID.
- Haz clic en Guardar.
Apple revisa juntos la clave, el ID de clave y el ID de equipo, así que los 3 tienen que ser de la misma clave, y el Bundle ID tiene que pertenecer a tu equipo. Cuando Apple los acepta, el bloque dice Conectado y muestra el ID de clave, el ID de equipo y el Bundle ID. Solo los iPhone con la app de ese Bundle ID reciben notificaciones push.
Notificaciones push en Android: tu cuenta de servicio de Firebase
Las notificaciones push a teléfonos Android pasan por Firebase Cloud Messaging, con una cuenta de servicio del proyecto de Firebase que usa tu app para Android.
- En Firebase, abre el proyecto de tu app, luego Configuración del proyecto, luego Cuentas de servicio, y genera una nueva clave privada. Firebase te da un archivo JSON.
- En Deskwoot, en Chat en tu app para iOS y Android, ve al bloque Android.
- Pega el contenido del archivo en JSON de la cuenta de servicio, o haz clic en Subir archivo .json y elige el archivo.
- Haz clic en Guardar.
Google revisa si esta cuenta de servicio puede enviar mensajes en su proyecto. Para eso, su clave tiene que ser válida, necesita un rol que pueda enviar mensajes y la API de Firebase Cloud Messaging tiene que estar activada en el proyecto. Cuando Google la acepta, el bloque dice Conectado y muestra el proyecto y el correo de la cuenta de servicio. Si los teléfonos Android de verdad pertenecen a este proyecto solo se sabe con el primer push real (consulta la sección siguiente).
Qué significa el estado
En la vista general de la bandeja de entrada, la fila Chat en tu app para iOS y Android muestra uno de estos estados:
- Sin configurar: no hay credenciales de push guardadas. El chat de tu app funciona igual, solo que sin notificaciones push.
- Notificaciones push en iOS, Notificaciones push en Android o Notificaciones push en iOS y Android: las plataformas cuyas credenciales están guardadas.
- No envía: Apple o Google rechazó los push que Deskwoot intentó enviar con tus credenciales guardadas.
Dentro del panel, cada bloque muestra su propio estado: Conectado, Sin configurar o No envía. Con No envía, una línea del bloque dice por qué:
- Apple rechaza la clave, el ID de clave o el ID de equipo. Guarda los correctos.
- Apple rechaza el Bundle ID. Guarda el Bundle ID de tu app.
- Google no envía con esta cuenta de servicio. Revisa que su clave todavía exista, que tenga un rol que pueda enviar mensajes y que la API de Firebase Cloud Messaging esté activada en su proyecto.
- Los teléfonos Android pertenecen a un proyecto de Firebase distinto al de la cuenta de servicio. Sube la cuenta de servicio del proyecto de Firebase de tu app.
No envía se mantiene hasta que un push vuelva a pasar o guardes credenciales nuevas. El bloque iOS también puede indicar que algunos iPhone usan un Bundle ID distinto al guardado, y cuántos son. Esos iPhone no reciben notificaciones push, así que revisa que el Bundle ID guardado sea el de tu app.
Claves guardadas: reemplazarlas o quitarlas
Después de guardar, el campo de la clave o del JSON vuelve a quedar vacío, con un aviso de que hay una guardada. Deskwoot guarda la clave y el JSON cifrados y nunca los vuelve a mostrar, ni en esta página ni por la API. Lo que sigue visible es el ID de clave, el ID de equipo y el Bundle ID, y para Android el proyecto de Firebase y el correo de la cuenta de servicio.
- Para reemplazar la clave o la cuenta de servicio, pega o sube la nueva y haz clic en Guardar. Deskwoot la vuelve a revisar con Apple o Google.
- Para cambiar solo el ID de clave, el ID de equipo o el Bundle ID, edita el campo y haz clic en Guardar. La clave guardada se mantiene, así que no tienes que volver a subirla.
- Para quitar un bloque, haz clic en Quitar y confirma con Quitar. Desde ese momento, los iPhone (o los teléfonos Android) no reciben notificaciones push hasta que agregues credenciales nuevas. El chat de tu app sigue funcionando.
Cuándo sale una notificación push
Deskwoot envía un push por cada respuesta que el cliente ve en el chat: una respuesta de alguien de tu equipo, una respuesta de tu bot de IA o un mensaje automático. Nunca envía uno por los mensajes del propio cliente ni por las notas privadas, ni mientras el bot de IA todavía escribe su respuesta. Las conversaciones marcadas como spam y los contactos bloqueados no reciben ninguno.
- Si el cliente no estaba en línea un momento antes, el push sale de inmediato.
- Si estaba en línea un momento antes, Deskwoot espera 12 segundos. Si para entonces ya leyó la respuesta, no sale ningún push. Así no molesta a quien está mirando la conversación.
- Cada respuesta suena una sola vez en el teléfono. Llega a cada teléfono en el que el cliente usa tu app con esta bandeja de entrada, hasta 10 teléfonos.
- Si el teléfono está apagado o sin conexión, Apple y Google guardan el push durante un día y después lo descartan.
El título de la notificación dice quién escribió: el nombre de pila de la persona de tu equipo o el nombre de tu bot de IA; si no, el nombre de tu empresa. El texto muestra la respuesta como texto simple, hasta 160 caracteres. En una respuesta que solo tiene un archivo, dice en el idioma del teléfono que se envió un archivo (en un teléfono en español, "Envió un archivo"). Un toque en la notificación abre la conversación en tu app.
Clientes con sesión iniciada en tu app
Sin configurar nada más, un cliente chatea en la app como visitante anónimo, y la conversación se queda en ese teléfono. Si tus clientes inician sesión en tu app, la app le puede decir al chat quiénes son. Así sus conversaciones los acompañan a todos sus dispositivos y al chat de tu sitio web en la misma bandeja de entrada, y tu equipo ve quién escribe.
Funciona exactamente igual que la verificación de identidad en tu sitio web, con la misma clave secreta, que creas en la misma bandeja de entrada de chat en vivo, en Reconocer a clientes con sesión iniciada. Tu servidor firma el id de usuario del cliente con esa clave y, después de tu propio inicio de sesión, la app le pasa el usuario y la firma al SDK. Cómo crear la clave y firmar el id de usuario se explica en Verificación de identidad de clientes con sesión iniciada. La llamada en la app está en la documentación para desarrolladores.
La clave va solo en tu servidor. Nunca la incluyas en la app: cualquiera que desempaque la app podría leerla y chatear como cualquiera de tus clientes.
Cuando un cliente cierra la sesión en tu app, la app se lo avisa al SDK. El SDK borra lo que guardó de ese cliente en el teléfono, el teléfono deja de recibir notificaciones push para él y el próximo chat empieza como un visitante nuevo y anónimo. Sus conversaciones se quedan en Deskwoot y vuelven cuando inicia sesión de nuevo.
Preguntas frecuentes
¿Tiene un costo extra y qué plan necesito?
El SDK y las notificaciones push no tienen un precio propio, y Deskwoot no revisa ningún plan para ellos. Todos los planes incluyen bandejas de entrada de chat en vivo, así que funciona con cualquier plan. Para las notificaciones push usas tu propia cuenta de Apple Developer y tu propio proyecto de Firebase.
¿Hay un SDK para React Native o Flutter?
No. Deskwoot tiene SDKs nativos para iOS (Swift) y para Android (Kotlin y Java), y ningún paquete para React Native ni Flutter. En una app hecha con ellos, puedes mostrar el chat de tu sitio web en una web view con el modo integrado del widget. Modo integrado: chat en un contenedor o a pantalla completa explica cómo.
¿Necesito Firebase en iOS?
No. Deskwoot envía las notificaciones push para iPhone directo a Apple con tu clave de autenticación de APNs, y el SDK no incluye Firebase. Solo necesitas Firebase para Android.
¿Quién envía las notificaciones push, Deskwoot o nosotros?
Las envía el servidor de Deskwoot, con tu clave de autenticación de APNs y tu cuenta de servicio de Firebase, o sea, por medio de tus propias cuentas de Apple y Google. Tu app solo le pasa su token de push al SDK al iniciar. Tus propias notificaciones push siguen siendo tuyas: el SDK toma solo las de Deskwoot y le deja todas las demás a tu app.
¿El SDK les pide permisos a mis clientes?
Nunca pide permiso para mostrar notificaciones. Eso lo hace tu app cuando le conviene, igual que con sus propias notificaciones. En Android 13 y posterior, sin ese permiso no aparece ninguna notificación. Aparte de eso, el SDK no necesita ningún permiso en iPhone y en Android solo el acceso a internet. Tus clientes pueden enviar fotos y archivos sin ningún permiso. La cámara solo funciona si tu app la permite. La tarjeta que muestra una respuesta con la app abierta tampoco necesita permiso.
¿Qué ve el cliente cuando la app está cerrada?
Una notificación push con el nombre de quien escribió y hasta 160 caracteres de la respuesta. Un toque abre la conversación en tu app. Si la app está abierta y el chat cerrado, en cambio, una pequeña tarjeta en la parte inferior de la app muestra la respuesta. Mientras el cliente mira esa conversación, no aparece ninguna notificación.
¿Te resultó útil esta guía?
Sigue leyendo
- Personalizar tu widget de chatAdapta el widget de chat de Deskwoot a tu marca: color, tema, idioma, textos de bienvenida, avatar, artículos sugeridos y más, todo en la configuración de tu bandeja de entrada de chat en vivo.Leer guía
- Insertar el widgetAgregar el widget de chat de Deskwoot a tu sitio web solo requiere un fragmento corto de código. El widget se carga de forma asíncrona y no afecta la velocidad de carga de tu página.Leer guía
- Abrir el widget de chat desde tu propio botónOculta el botón del chat y abre el chat en vivo desde tu propio botón o enlace con window.deskwootWidget.open().Leer guía
Preguntar a Fynn sobre esta guía
Recibe una respuesta corta basada en esta guía y el resto del centro de ayuda.