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
Guias de integração
Integre o React Chat SDK e o UI Kit ao seu aplicativo.
Exemplos e código-fonte
Explore o código-fonte do React Chat SDK e um exemplo local de mensagem de produto.
Chat da comunidade React
Criechat da comunidade com o React Chat SDK: mensagens diretas, conversas em grupo e conteúdo multimídia compartilhado.
Mensagens personalizadas do produto
Conecte mensagens personalizadas do React Chat SDK aos cartões de produto em chat de suporte.
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.
Chat individual e em grupo
- Conversas individuais e em grupo
- Prévias de mensagens recentes
- Número de conversas não lidas
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.
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<ConversationList
style={{ width: 300, height: '100%' }}
enableSearch={false}
/>Escolha como as mensagens funcionam
Controle o alinhamento das mensagens, agrupe mensagens consecutivas e selecione as ações disponíveis em cada mensagem.
MessageList APIconst actions = useMessageActions([
'copy', 'quote', 'forward',
]);
<MessageList
alignment="two-sided"
messageAggregationTime={300}
messageActionList={actions}
/>Crie o editor de mensagens de que precisa
Escolha os seletores de imagem, ficheiro e vídeo. Defina o placeholder e decida se o botão de envio ficará visível.
MessageInput API<MessageInput
placeholder="Message your community"
autoFocus={false}
hideSendButton={false}
actions={[
'ImagePicker', 'FilePicker', 'VideoPicker',
]}
/>Mantenha ações úteis ao alcance
Adicione um controle de configurações ao lado do título da conversa. Conecte-o ao seu próprio painel ou sistema de navegação.
Guia de integração do cabeçalhoconst [showSettings, setShowSettings] = useState(false);
<ChatHeader
ChatHeaderRight={
<button onClick={() => setShowSettings(true)}>
Settings
</button>
}
/>Conecte as pessoas às conversas
Combine listas de contatos e detalhes de perfil. Volte à visualização da conversa quando um usuário iniciar uma mensagem.
Guia de integração de contactos<ContactList />
<ContactInfo
onSendMessage={() => setActiveTab('conversations')}
onEnterGroup={() => setActiveTab('conversations')}
/>Reserve espaço para as configurações da conversa
Coloque o componente de configurações em uma barra lateral ou gaveta. Seu aplicativo controla quando o painel é aberto e fechado.
Guia de configuração da integração{showSettings && (
<aside className="chat-settings">
<ChatSetting
onClose={() => setShowSettings(false)}
/>
</aside>
)}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 temasPrévias de conversas
Substitua o layout de visualização, mantendo a seleção da conversa e os dados conectados ao UI Kit.
ConversationPreview APIMensagens personalizadas
Apresente os dados do produto como um cartão de mensagem. Mantenha as consultas ao catálogo, os detalhes do produto e a finalização da compra no seu aplicativo.
Guia de mensagens personalizadasCOMECE AGORA
Integre o React Chat SDK
- 01
- 02
Adicione o React UI Kit
Instale o pacote. Personalize os componentes conforme suas necessidades.
Siga o tutorial de React - 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
npm install @tencentcloud/chat-uikit-react<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 IssuesDúvidas sobre produtos e preços
Fale com nossa equipe sobre sua aplicação, o uso previsto e as necessidades de integração.
Entre em contato com a equipe de vendasSua 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.

