RevenueCat
Actualizado el
Los clientes de tu app de iOS le preguntan al chatbot por su propia suscripción, y este responde con los datos de RevenueCat: si está activa, cuándo se renueva o termina, si hay un problema de pago y dónde administrarla. Configurarlo toma unos diez minutos y un poco de código en tu app.
Qué pueden preguntar tus clientes
- Qué tienen: cada suscripción, si está activa o en una prueba gratis, y dónde la compraron.
- Cuándo se renueva o termina, y si desactivaron la renovación.
- Por qué se cortó el acceso: un pago que falló y se está volviendo a intentar, o una suscripción que terminó, y cuándo.
- Cómo cancelarla o cambiarla. El chatbot los envía a la tienda donde la compraron, y ahí lo hacen ellos mismos.
Solo lee. Cancelar, reembolsar y cambiar de plan quedan en manos de la tienda y del cliente: el reembolso de una compra en el App Store se le pide a Apple. Una compra hecha en un entorno de prueba se identifica como compra de prueba, para que puedas probarlo todo antes de publicar. Eso incluye las compras de una compilación de TestFlight, que no le cuestan nada a quien la prueba, así que una compra de prueba nunca demuestra que alguien pagó. Las fechas son días en UTC.
Cómo muestra tu app quién pregunta
El chatbot solo lee la suscripción del cliente que tu app avala, nunca una que alguien mencione en el chat: no pide un correo, un ID de usuario ni un recibo, y no acepta ninguno. Tu app muestra quién es el cliente de una de cuatro formas, y ChatFrom lo comprueba en cada mensaje antes de leer nada.
- Un token de tu servidor, para clientes que inician sesión en tu app. Tu servidor firma un token breve con el secreto de firma de tu chatbot: HS256, en
subel App User ID del cliente en RevenueCat, y unexpcomo máximo 24 horas en el futuro. Tu app lo pasa como su token de usuario. Esto también funciona en tu sitio web. - El token de acceso propio de RevenueCat, si tu app inicia la sesión de los clientes con la autenticación de RevenueCat, que RevenueCat ofrece en beta. Pásalo como token de usuario en su lugar; el chatbot lo comprueba con las claves de tu proyecto en RevenueCat.
- El ID anónimo de RevenueCat, para una app sin servidor propio, una vez que lo permitas en la tarjeta. RevenueCat crea uno para cada cliente que no ha iniciado sesión, y nadie puede adivinarlo, así que la app lo pasa tal cual. Quien tenga uno puede preguntar por la suscripción de ese cliente, igual que con el propio SDK de RevenueCat. Un ID que elegiste tú, como un correo o un número, podría adivinarse, así que siempre necesita un token.
- La confirmación del App Store, una vez que ingreses el bundle ID de tu app en la tarjeta. El SDK de iOS lee las suscripciones con StoreKit y pasa lo que Apple firmó, que ChatFrom comprueba con el propio certificado de Apple, y solo cuenta para tu app. Así, el chatbot puede responder incluso cuando RevenueCat no está disponible. Se refiere a quien haya iniciado sesión en el App Store en el dispositivo, que no siempre es quien inició sesión en tu app.
Las dos últimas solo funcionan en tu app, donde el SDK las pasa. Un token de tu servidor también llega a los servidores de herramientas que marcaste para el token de usuario, así que un servidor tuyo puede comprobarlo con el mismo secreto.
Vuelve a asignar revenueCatAppUserId cada vez que cambie el ID de RevenueCat, como pasa cuando alguien inicia o cierra sesión. ChatFrom.logout() lo olvida, así que asigna el siguiente después. El README del SDK de iOS tiene los detalles, y la guía de iOS, cómo agregar el chat a tu app.
En RevenueCat
- Abre tu proyecto, ve a API keys y haz clic en + New secret API key. Llámala ChatFrom, elige V2 y dale solo Customer information: Subscriptions: Read.
- Copia el ID del proyecto desde Project settings, General.
En ChatFrom
- Abre tu chatbot y ve a Tools. En Connections, haz clic en el + de RevenueCat.
- Pega el ID del proyecto y la clave, y haz clic en Connect RevenueCat. ChatFrom comprueba la clave con RevenueCat sin leer ningún cliente real, y activa la herramienta.
- Copia el signing secret (el secreto de firma) que muestra la tarjeta, para tu servidor. Se muestra una sola vez. Si alguna vez se filtra, haz clic en Make a new secret: los tokens firmados con el anterior dejan de funcionar al instante, y una clave nueva deja el secreto como está.
- Permite los anonymous ids o ingresa el Bundle id de tu app, si tu app usa esas formas.
- En tu app, abre el chat con la sesión iniciada y pregunta “¿Cuándo se renueva mi suscripción?”.
Qué se mantiene seguro
- Tu clave y el secreto de firma se guardan cifrados, y la clave no se vuelve a mostrar nunca. Al desconectar se eliminan ambos.
- La identidad del cliente pasa sellada del mensaje a la herramienta, solo para esa conversación y esa persona, y solo por unos minutos. Nada de lo que se diga en el chat puede cambiarla.
- El token se comprueba en cada mensaje: se rechaza si no está firmado con tu secreto, si ya expiró o si dura más de 24 horas.
- Si RevenueCat deja de aceptar la clave, el chatbot ofrece una transferencia a una persona, y la tarjeta pide una clave nueva.
- El chatbot no puede cancelar, reembolsar ni cambiar una suscripción.
Para dejar de usarlo, desactiva Subscription tool o haz clic en Disconnect para eliminar la clave y el secreto guardados; luego elimina también la clave en RevenueCat. En la página Conexiones verás a qué más puede conectarse un chatbot.