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.

Pasos

Hazlo en este orden

  1. 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.

  2. 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.

  3. 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.

  4. 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

PaquetePara qué sirve
@sellwhisper/chat-clientEl cliente headless: conversaciones, mensajes y eventos, sin dependencia de React Native
@sellwhisper/react-nativeEl 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ónNecesita
Historial de conversaciones entre un inicio de la app y el siguienteUn adaptador de almacenamiento como AsyncStorage
Archivos adjuntosUn paquete selector de imágenes o documentos
Notas de vozUn paquete de grabación de audio
Asistente de vozUn paquete de audio y una compilación de desarrollo (development build); no funciona en Expo Go
Notificaciones pushLas notificaciones push configuradas en tu app y el dispositivo registrado con el SDK

Antes de publicar

  1. Prueba en un dispositivo. Ejecuta tu compilación en un dispositivo iOS y uno Android reales, no solo en un simulador.
  2. 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.
  3. 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.

Preguntas frecuentes

Preguntas comunes

¿El SDK funciona con Expo?
Sí, desde Expo SDK 53. El asistente de voz necesita una compilación de desarrollo (development build) en lugar de Expo Go.
¿Puedo crear mi propia interfaz de chat?
Sí. @sellwhisper/chat-client es un cliente headless sin dependencias de React Native, así que puedes controlar tus propios componentes con él.
¿El escalamiento a una persona funciona en la app?
Sí. Una conversación escalada continúa como chat en vivo con tu equipo en la misma pantalla. Para llegar a los usuarios mientras la app está en segundo plano, configura las notificaciones push en tu app y registra el dispositivo con el SDK.

Documentación relacionada

Empieza

Pon los pasos en práctica

Empieza gratis, sin tarjeta de crédito.