DESENVOLVIDO PARA React

React Chat SDK e UI Kit

Crie mensagens individuais e em grupo com o React Chat SDK e o UI Kit do Tencent RTC. Adicione listas de conversas, mensagens e campos de composição conectados e personalize-os para o seu produto.

RECURSOS PARA DESENVOLVEDORES

Documentação e exemplos do React Chat SDK

RECURSOS DE CHAT PARA REACT

Recursos do React Chat SDK

De ações de mensagens a conteúdo personalizado, escolha os recursos necessários para sua aplicação.

Tipos de mensagem avançados

  • Texto, imagens, áudio e vídeo
  • Compartilhamento de arquivos nas conversas
  • Payloads personalizados de produtos ou pedidos

Controles de mensagens

  • Copiar, citar e encaminhar
  • Ações de revogação e exclusão
  • Agrupamento e alinhamento por remetente

Composição flexível

  • Seletores de imagens, vídeos e arquivos
  • Ações de entrada configuráveis
  • Seu próprio placeholder e sua barra de ferramentas

Seu produto, sua UI

  • Temas claro e escuro
  • Pré-visualizações personalizadas de conversas
  • Inglês, chinês, japonês, coreano

Amplie quando precisar

  • Confirmações de leitura: ative e configure
  • Cloud Search: plugin pago
  • Voz e vídeo: adicione o TUICallKit

Explorar React Chat Components

Explore a interface, da lista de conversas ao editor de mensagens.

Lista de conversas

Uma caixa de entrada adequada ao seu produto

Mostre mensagens recentes e contagens de mensagens não lidas. Substitua o componente de pré-visualização para alterar a aparência de cada conversa.

ConversationList API
App.tsx
<ConversationList
  style={{ width: 300, height: '100%' }}
  enableSearch={false}
/>

PERSONALIZAÇÃO

Personalize sua UI de chat para React

Personalize o estilo do UI Kit para combinar com sua integração do React Chat SDK e seu próprio conteúdo.

Tema

Defina o tema no provider. Mantenha um único fluxo de conversa ao alternar entre os modos claro e escuro.

Guia de integração de temas

COMECE AGORA

Integre o React Chat SDK

  1. 01

    Crie seu app

    Crie um aplicativo Chat para integrar o React Chat SDK.

    Abrir o console do Chat
  2. 02

    Adicione o React UI Kit

    Instale o pacote. Personalize os componentes conforme suas necessidades.

    Siga o tutorial de React
  3. 03

    Envie sua primeira mensagem

    Faça login em duas contas de usuário do React Chat SDK e envie uma mensagem de teste.

    Conecte seus usuários
Kit de interface de chat React
Terminal
npm install @tencentcloud/chat-uikit-react
UI composition
<UIKitProvider theme="light">
  <ConversationList />
  <Chat>
    <ChatHeader />
    <MessageList />
    <MessageInput />
  </Chat>
</UIKitProvider>

CHAT + CALL

Algumas conversas precisam de uma chamada

Integre voz e vídeo usando o TUICallKit e o cabeçalho do chat em React.

As chamadas exigem a integração do TUICallKit e a ativação do serviço Call. Consulte os preços do Call separadamente dos preços do Chat.

Perguntas frequentes sobre o React Chat SDK

Qual é a diferença entre o React Chat SDK e o React UI Kit?

O React Chat SDK oferece recursos de mensagens por meio do JavaScript SDK. O React UI Kit acrescenta componentes prontos para a interface de chat. Use o UI Kit para começar com componentes conectados ou crie sua própria interface sobre o SDK subjacente.

Posso personalizar os componentes e o layout das mensagens?

Sim. Use as props e os pontos de extensão documentados para configurar o comportamento dos componentes, ajustar as prévias das conversas e renderizar mensagens personalizadas. As alterações disponíveis dependem do componente; consulte a respectiva API antes de planejar uma substituição.

Qual UI Kit devo usar para React web, web móvel ou React Native?

Use o React UI Kit em aplicações para navegador. O guia para web móvel (H5) usa componentes como ConversationListH5 e MessageListH5 do pacote React. Para aplicações nativas de iOS e Android desenvolvidas com React Native, use o React Native UI Kit separado e seu guia de configuração nativa.

Como integrar o React Chat SDK ao Next.js ou SSR?

Planeje a interface de chat interativa para o navegador. No Next.js App Router, isole o código dependente do navegador em um Client Component; o Next.js permite carregamento dinâmico somente no cliente com ssr: false. Gere o UserSig no seu servidor. Verifique a versão e as dependências do UI Kit instalado e teste a compilação de produção, o login e a navegação antes do lançamento.

Qual é a relação entre o React UI Kit de código aberto e o serviço hospedado do Chat?

O código-fonte do React UI Kit está disponível no GitHub. Os respetivos componentes de mensagens ligados utilizam o Tencent RTC Chat e exigem uma aplicação do Chat e utilizadores autenticados. A disponibilidade do código-fonte dos componentes não inclui mensagens alojadas ilimitadas: a utilização do serviço e o acesso às funcionalidades dependem do seu plano do Chat. É possível executar uma pré-visualização local da interface sem uma ligação ativa.

Posso começar a usar o React Chat SDK gratuitamente?

O Tencent RTC Chat oferece um plano gratuito com 1,000 usuários ativos mensais. Consulte os detalhes e os preços dos planos para os recursos e o uso de que você precisa.

O React UI Kit inclui chamadas de voz e vídeo?

Pode adicionar chamadas integrando o TUICallKit e ativando o serviço Call. O exemplo atual de integração completa com React inclui essa extensão; a configuração e os preços das chamadas permanecem separados das mensagens.

O Cloud Search está incluído no plano gratuito?

O Cloud Search é um recurso de valor agregado que requer o plugin Cloud Search. Consulte os requisitos antes de habilitar a pesquisa na sua interface de chat.

Como integro Chat SDK React com React?

Inicialize o provider documentado e componha os componentes ligados. Alinhe as subscrições e a limpeza com o ciclo de vida do React e teste a navegação e montagens repetidas na aplicação real.

Como testo Chat SDK React antes de lançar a minha aplicação?

Confira login, prontidão do SDK, eventos de envio e recebimento e estado das mensagens após reconectar.

Como personalizo a interface de Chat SDK React?

Envolva os componentes de chat em UIKitProvider e defina theme="light" ou theme="dark". Um componente filho pode usar useUIKit().setTheme para alternar a aparência; o hook precisa ser executado dentro do contexto do provider. Para cards de produtos, forneça um renderizador de mensagens personalizado por MessageList.messageRenderers. Mantenha uma alternativa para payloads não reconhecidos e deixe sua aplicação cuidar da consulta de produtos e do checkout, sem tratá-los como recursos do Chat.

Encontre o suporte certo para a próxima etapa

Dúvidas técnicas

Consulte o exemplo do React Chat SDK ou informe um problema reproduzível.

Ver GitHub Issues

Sua próxima conversa começa aqui

Desenvolva com o React Chat SDK e o UI Kit. Comece gratuitamente com 1.000 usuários ativos mensais.