Dois modelos de entrega: o conjunto completo de recursos como serviço em nuvem ou nos seus próprios servidores — contas, mensagens e gravações ficam na rede internaPilha completa no seu servidorImplantação privada
Gateway de conexões persistentes, Open API e entrega por callback: conversas individuais e em grupo, salas de bate-papo, supergrupos e notificações do sistema. Em rede ruim, as mensagens não se perdem nem duplicam, e a operação pode ser administrada e auditada no painel.
Web, Android, iOS, macOS, Flutter, React Native e miniprograma; os componentes de UI do IMKit podem ser reutilizados.
Uma conta online em vários dispositivos ao mesmo tempo
IMKit entrega UI de conversas, mensagens e contatos
Console e back office para administração e auditoria
Entrega confiável e governança
Não é só enviar mensagens: confiabilidade de entrega, experiência de conversa e moderação de conteúdo andam juntas.
Sem perdas nem duplicatas ao trocar de rede
O gateway de conexões cuida do envio e do recebimento; a confirmação só volta depois de gravar a mensagem com três réplicas. O cliente mantém um número de sequência por conversa, busca o que faltou após reconectar e remove duplicatas — assim, ao trocar de rede ou ter o processo encerrado, nada se perde nem aparece duas vezes.
Reconexão automática, mensagens offline aguardam o envio
Três réplicas de armazenamento, consistentes mesmo com muito escrita
Canal de push offline como reserva, mesmo com o app fechado
Entrega por callback leva o status das mensagens aos seus sistemas
Os detalhes do dia a dia
Da confirmação de leitura à resposta citada: o que se usa de verdade no dia a dia já vem pronto — depois da integração, a experiência de conversa está completa.
Confirmação de leitura em grupo como n/m, com detalhe dos leitores
Revogação de mensagens, menções com @, resposta citada, rascunho e fixação
Roaming de histórico e busca em todas as mensagens
Salas de bate-papo com alta concorrência e limite de frequência
Contatos e grupos sob controle
Solicitações de amizade, bloqueios, gestão de grupos e filtro de palavras em uma única interface, com visão no back office.
Solicitações com aprovação, bloqueios e sincronização de presença
O admin do grupo renomeia, define administradores, silencia, remove e transfere
O aviso do grupo alcança todos, e a notificação do sistema chama atenção
Filtro de palavras e moderação: bloquear ou substituir
Arquitetura
O cliente mantém uma única conexão persistente; o servidor é dividido por responsabilidade, e armazenamento e push escalam de forma independente.
Camada de acessoSDKs de cliente e componentes de UI
Gateway de conexõesServiço de mensagensRelaçõesServiço de gruposModeração de conteúdoOpen APIAdmin APIEntrega de callbacks
Armazenamento e pushPersistência e entrega
Armazenamento de mensagens (3 réplicas)Roaming de históricoCanal de push offlineLista de termos sensíveis
O gateway de conexões e o serviço de mensagens escalam horizontalmente; na implantação privada, as três camadas ficam na rede interna do seu data center.
Primeiro uma mensagem, depois o resto
Crie o app no console, pegue o AppID, integre o SDK e abra a conexão — já dá para enviar a primeira mensagem.
Crie o app no console, obtenha AppID e chave e configure a URL de callbacks
Integre o SDK ou os componentes de UI do IMKit e substitua a interface de conversa
No servidor, chame a Open API para notificações, grupos e relações
import FeiyanIM from '@feiyan/im-sdk';
// 1. Init: get the AppID from the app details in the console
const im = FeiyanIM.init({ appId: 'YOUR_APP_ID' });
// 2. Connect (auto-reconnect after a drop, offline messages are re-delivered)
await im.connect({ userId: 'user_1001', token });
// 3. Send a message: one API for direct chats, groups and chat rooms
await im.sendMessage({
target: 'group_2001',
type: 'text',
content: 'Hello, FeiyanCloud',
});
// 4. Listen for messages and read receipts
im.on('message', (msg) => console.log(msg));
im.on('readReceipt', (r) => {
console.log(`${r.readCount}/${r.totalCount}`, r.readUserIds);
});
Perguntas frequentes antes de integrar
Mais detalhes técnicos na documentação ou em um ticket de suporte.
Como as mensagens não se perdem nem duplicam?
O gateway de conexões grava a mensagem no serviço de mensagens, e a confirmação de envio só retorna depois da gravação com três réplicas. O cliente mantém um número crescente por conversa, busca o que faltou após reconectar e descarta duplicatas. Por isso, ao trocar de rede ou ter o processo encerrado, não há perda nem exibição repetida.
Quais tipos de mensagem existem? Dá para criar um?
Já vêm texto, imagem, arquivo, áudio, localização e notificações do sistema. Também é possível definir um tipo personalizado: o corpo e a renderização ficam com o seu serviço, e o servidor apenas repassa e armazena — útil para cartões de pedido e cartões rich text.
Como a confirmação de leitura em grupo é contada?
No grupo, a confirmação aparece como n/m — lida por n de m participantes — e é possível buscar os detalhes dos leitores pela interface. Na conversa individual, marca-se o horário de leitura. Os dois estados são enviados ao seu back office por callback.
Por quanto tempo o histórico fica disponível?
Na nuvem, o período é definido pelo plano e ajustado no console, e o histórico é lido em páginas pela Open API. Na implantação privada, armazenamento e regras de roaming ficam no seu próprio banco de dados, com o período que você definir.
Como as mensagens sincronizam com vários dispositivos?
A mesma conta pode estar online em Web, celular e desktop ao mesmo tempo. Enviar ou ler em um dispositivo dispara um evento no canal online; os dispositivos offline buscam o que faltou pela sequência na próxima conexão, mantendo o estado das conversas igual em todos.
O IM funciona sozinho ou precisa do RTC?
IM e vídeo em tempo real são produtos independentes e podem ser integrados separadamente. Se você quiser iniciar uma chamada de áudio ou vídeo dentro da conversa, combine os recursos de chamada do RTC — a conta e a autenticação continuam as mesmas.
Capturas do produto
Interface e back office no mesmo produto
Conversa em grupo: menções com @, avisos do grupo e contagem de leituraLido por 2 de 7, 8 participantes e o marcador de mensagem revogada — tudo em uma conversa realLista de conversas no celularIndicadores de não lidas, conversas fixadas, rascunhos e notificações do sistemaReunião no celularChamada 1:1: vídeo remoto em tela cheia e prévia local na janela pequenaCompartilhamento de telaUm painel do console é compartilhado, com os vídeos dos participantes à direita
Sua primeira mensagem em 30 minutos
O plano gratuito já cobre desenvolvimento e testes; no lançamento, mude de plano conforme o uso.