Cómo agregar chat de IA a una app React Native
Instala el SDK de React Native de Sell Whisper AI, crea un cliente con tu Widget ID y muestra la pantalla de chat en tu app de iOS y Android.
Hazlo en este orden
Instala los paquetes
Agrega @sellwhisper/chat-client y @sellwhisper/react-native desde npm. El SDK es compatible con React Native 0.73 o posterior, Expo SDK 53 o posterior, iOS 15.1 o posterior y Android con nivel de API 24 o posterior.
Copia tu Widget ID
En el panel, abre el agente, ve a Implementar (Deploy) y abre el widget de chat del agente. El Widget ID de su configuración es el mismo que usa el código de inserción del sitio web, así que la app comparte el mismo agente y la misma configuración del widget.
Crea el cliente y envuelve tu app
Crea un SellWhisperClient con el Widget ID y un adaptador de almacenamiento como AsyncStorage para que las conversaciones se conserven entre un inicio de la app y el siguiente, y luego envuelve tu app en SellWhisperProvider.
Muestra la pantalla de chat
Agrega SellWhisperChatScreen donde deba aparecer el chat. Sus props activan el encabezado, el historial de conversaciones, los archivos adjuntos y las notas de voz; los archivos adjuntos y las notas de voz requieren tener instalados los paquetes opcionales de selector y de audio.
Dos paquetes
| Paquete | Para qué sirve |
|---|---|
@sellwhisper/chat-client | El cliente headless: conversaciones, mensajes y eventos, sin dependencia de React Native |
@sellwhisper/react-native | El provider, los hooks y la pantalla de chat lista para usar en React Native y Expo |
Instala ambos para tener la pantalla lista para usar. Instala solo el cliente para crear tu propia interfaz.
Qué comparte la app con tu sitio web
La app se conecta con el mismo Widget ID que el código de inserción de tu sitio web. Eso significa un solo agente, una sola base de conocimiento y un solo conjunto de reglas de escalamiento, y que un cambio en el conocimiento o las instrucciones del agente llega a la app sin publicar una nueva versión.
Funciones opcionales y qué necesitan
| Función | Necesita |
|---|---|
| Historial de conversaciones entre un inicio de la app y el siguiente | Un adaptador de almacenamiento como AsyncStorage |
| Archivos adjuntos | Un paquete selector de imágenes o documentos |
| Notas de voz | Un paquete de grabación de audio |
| Asistente de voz | Un paquete de audio y una compilación de desarrollo (development build); no funciona en Expo Go |
| Notificaciones push | Las notificaciones push configuradas en tu app y el dispositivo registrado con el SDK |
Antes de publicar
- Prueba en un dispositivo. Ejecuta tu compilación en un dispositivo iOS y uno Android reales, no solo en un simulador.
- Agrega conocimiento primero. La pantalla solo es tan útil como el agente que tiene detrás. Consulta cómo entrenar un agente de IA con tu sitio web.
- Configura el escalamiento. El chat en vivo con tu equipo funciona en la app; decide cuándo empieza con cómo pasar conversaciones de IA a una persona.
Los comandos de instalación, las props del componente y un ejemplo completo están en SDK de React Native.