CREADO PARA React
React Chat SDK y UI Kit
Crea mensajería individual y grupal con React Chat SDK y UI Kit de Tencent RTC. Añade listas de conversaciones, mensajes y editores de mensajes conectados, y personalízalos para tu producto.
RECURSOS PARA DESARROLLADORES
Documentación y ejemplos de React Chat SDK
Guías de integración
Integra React Chat SDK y UI Kit en tu aplicación.
Ejemplos y código fuente
Explora el código fuente de React Chat SDK y un ejemplo local de mensaje de producto.
Chat de la comunidad React
Creachat de la comunidad con React Chat SDK: mensajes directos, conversaciones grupales y contenido multimedia compartido.
Mensajes personalizados del producto
Conecta los mensajes personalizados de React Chat SDK con las tarjetas de producto de chat de soporte.
FUNCIONES DE CHAT PARA REACT
Funciones de React Chat SDK
Desde acciones sobre mensajes hasta contenido personalizado, elija las funciones que necesita su aplicación.
Chat individual y grupal
- Conversaciones individuales y grupales
- Vistas previas de mensajes recientes
- Número de conversaciones no leídas
Tipos de mensajes enriquecidos
- Texto, imágenes, audio y video
- Uso compartido de archivos en las conversaciones
- Payloads personalizados de productos o pedidos
Controles de mensajes
- Copiar, citar y reenviar
- Acciones para retirar y eliminar mensajes
- Agrupación y alineación por remitente
Composición flexible
- Selectores de imágenes, vídeos y archivos
- Acciones de entrada configurables
- Tu propio placeholder y barra de herramientas
Tu producto, tu UI
- Temas claro y oscuro
- Vistas previas de conversación personalizadas
- Inglés, chino, japonés, coreano
Amplía cuando lo necesites
- Confirmaciones de lectura: activar y configurar
- Cloud Search: complemento de pago
- Voz y vídeo: añade TUICallKit
Explorar React Chat Components
Explora la interfaz, desde la lista de conversaciones hasta el editor de mensajes.
Una bandeja de entrada adaptada a tu producto
Muestra los mensajes recientes y el número de mensajes sin leer. Sustituye el componente de vista previa para cambiar cómo aparece cada conversación.
ConversationList API<ConversationList
style={{ width: 300, height: '100%' }}
enableSearch={false}
/>Elige cómo funcionan los mensajes
Controle la alineación de los mensajes, agrupe los mensajes consecutivos y seleccione las acciones disponibles en cada mensaje.
MessageList APIconst actions = useMessageActions([
'copy', 'quote', 'forward',
]);
<MessageList
alignment="two-sided"
messageAggregationTime={300}
messageActionList={actions}
/>Cree el editor de mensajes que necesita
Elija los selectores de imágenes, archivos y vídeos. Defina el marcador de posición y decida si se muestra el botón de envío.
MessageInput API<MessageInput
placeholder="Message your community"
autoFocus={false}
hideSendButton={false}
actions={[
'ImagePicker', 'FilePicker', 'VideoPicker',
]}
/>Pon las acciones útiles al alcance
Añade un control de configuración junto al título de la conversación. Conéctalo a tu propio panel o sistema de navegación.
Guía de integración del encabezadoconst [showSettings, setShowSettings] = useState(false);
<ChatHeader
ChatHeaderRight={
<button onClick={() => setShowSettings(true)}>
Settings
</button>
}
/>Conecte a las personas con las conversaciones
Combina las listas de contactos y los detalles de perfil. Vuelve a la vista de conversación cuando un usuario empiece a enviar un mensaje.
Guía de integración de contactos<ContactList />
<ContactInfo
onSendMessage={() => setActiveTab('conversations')}
onEnterGroup={() => setActiveTab('conversations')}
/>Reserva espacio para la configuración de la conversación
Coloque el componente de configuración en una barra lateral o un panel deslizante. Su aplicación controla cuándo se abre y se cierra el panel.
Guía de configuración de la integración{showSettings && (
<aside className="chat-settings">
<ChatSetting
onClose={() => setShowSettings(false)}
/>
</aside>
)}PERSONALIZACIÓN
Personaliza tu UI de chat para React
Adapta el estilo del UI Kit a tu integración de React Chat SDK y a tu propio contenido.
Tema
Configura el tema en el provider. Mantén un único flujo de conversación al alternar entre los modos claro y oscuro.
Guía de integración de temasVistas previas de conversaciones
Sustituya el diseño de la vista previa y mantenga la selección de la conversación y los datos conectados al UI Kit.
ConversationPreview APIMensajes personalizados
Presenta los datos del producto como una tarjeta de mensaje. Mantén las consultas al catálogo, los detalles del producto y el proceso de pago en tu aplicación.
Guía de mensajes personalizadosCOMENZAR
Integra el React Chat SDK
- 01
- 02
Añade el React UI Kit
Instale el paquete. Personalice los componentes según sus necesidades.
Sigue el tutorial de React - 03
Envía tu primer mensaje
Inicia sesión en dos cuentas de usuario del React Chat SDK y envía un mensaje de prueba.
Conecta a tus usuarios
npm install @tencentcloud/chat-uikit-react<UIKitProvider theme="light">
<ConversationList />
<Chat>
<ChatHeader />
<MessageList />
<MessageInput />
</Chat>
</UIKitProvider>CHAT + CALL
Algunas conversaciones necesitan una llamada
Conecta voz y vídeo mediante TUICallKit y el encabezado de tu chat con React.
Las llamadas requieren integrar TUICallKit y habilitar el servicio Call. Consulta los precios de Call por separado de los de Chat.
Preguntas frecuentes sobre React Chat SDK
¿En qué se diferencia el React Chat SDK del React UI Kit?
React Chat SDK ofrece funciones de mensajería mediante JavaScript SDK. React UI Kit añade componentes listos para usar en la interfaz de chat. Usa el UI Kit para empezar con componentes conectados o crea tu propia interfaz sobre el SDK subyacente.
¿Puedo personalizar los componentes y el diseño de los mensajes?
Sí. Use las props y los puntos de extensión documentados para configurar el comportamiento de los componentes, ajustar las vistas previas de las conversaciones y renderizar mensajes personalizados. Los cambios disponibles dependen del componente; consulte su API antes de planificar una sustitución.
¿Qué UI Kit debo usar para React web, web móvil o React Native?
Usa React UI Kit para aplicaciones de navegador. La guía para web móvil (H5) utiliza componentes del paquete React como ConversationListH5 y MessageListH5. Para aplicaciones nativas de iOS y Android desarrolladas con React Native, utiliza el React Native UI Kit independiente y su guía de configuración nativa.
¿Cómo integro React Chat SDK con Next.js o SSR?
Planifica la interfaz de chat interactiva para el navegador. En Next.js App Router, aísla el código que depende del navegador en un Client Component; Next.js admite la carga dinámica solo en el cliente con ssr: false. Genera el UserSig en tu servidor. Comprueba la versión y las dependencias del UI Kit instalado, y prueba la compilación de producción, el inicio de sesión y la navegación antes del lanzamiento.
¿Qué relación existe entre el React UI Kit de código abierto y el servicio alojado de Chat?
El código fuente del React UI Kit está disponible en GitHub. Sus componentes de mensajería conectados usan Tencent RTC Chat y requieren una aplicación de Chat y usuarios autenticados. La disponibilidad del código fuente de los componentes no incluye mensajería alojada ilimitada: el uso del servicio y el acceso a funciones dependen de tu plan de Chat. Puedes ejecutar una vista previa local de la interfaz sin una conexión activa.
¿Puedo empezar a usar React Chat SDK gratis?
Tencent RTC Chat ofrece un plan gratuito con 1,000 usuarios activos mensuales. Consulte los detalles y precios de los planes según las funciones y el uso que necesite.
¿React UI Kit incluye llamadas de voz y vídeo?
Puedes añadir llamadas integrando TUICallKit y activando el servicio Call. El ejemplo actual de integración completa con React incluye esta extensión; la configuración y los precios de las llamadas se mantienen separados de la mensajería.
¿Cloud Search está incluido en el plan gratuito?
Cloud Search es una función de valor añadido que requiere el plugin Cloud Search. Revisa sus requisitos antes de habilitar la búsqueda en tu interfaz de chat.
¿Cómo integro Chat SDK React con React?
Inicializa el provider documentado y compón los componentes conectados. Ajusta las suscripciones y la limpieza al ciclo de vida de React y prueba la navegación y los montajes repetidos en tu aplicación real.
¿Cómo pruebo Chat SDK React antes de publicar mi aplicación?
Comprueba inicio de sesión, disponibilidad del SDK, eventos de envío y recepción y estado de mensajes tras reconectar.
¿Cómo personalizo la interfaz de Chat SDK React?
Envuelve los componentes de chat en UIKitProvider y establece theme="light" o theme="dark". Un componente hijo puede usar useUIKit().setTheme para cambiar la apariencia; el hook debe ejecutarse dentro del contexto del provider. Para las tarjetas de producto, proporciona un renderizador de mensajes personalizado mediante MessageList.messageRenderers. Mantén una alternativa para los payloads no reconocidos y deja que tu aplicación gestione la consulta de productos y el proceso de compra, sin tratarlos como funciones de Chat.
Encuentra el soporte adecuado para el siguiente paso
Preguntas técnicas
Revise el ejemplo de React Chat SDK o informe un problema reproducible.
Ver GitHub IssuesPreguntas sobre productos y precios
Hable con nuestro equipo sobre su aplicación, el uso previsto y sus necesidades de integración.
Contactar con VentasTu próxima conversación empieza aquí
Desarrolla con el React Chat SDK y el UI Kit. Empieza gratis con 1.000 usuarios activos mensuales.

