Troque o TikTok-Live-Connector em segundos
Já usa o tiktok-live-connector? Mude para a API gerenciada do TikTool trocando uma única linha de import. Os mesmos nomes de eventos, os mesmos métodos, zero mudança no código.
Instale o SDK
npm install @tiktool/liveTroque uma linha de import
const { WebcastPushConnection } = require('tiktok-live-connector');const { WebcastPushConnection } = require('@tiktool/live');Use sua chave de API do TikTools
signApiKey: 'EULER_API_KEY'signApiKey: 'TIKTOOL_API_KEY'Pegue uma chave grátis em tik.tools - sem cartão de crédito.
Exemplo completo funcionando
Este código roda igual com o tiktok-live-connector e com o @tiktool/live. Só o import muda.
// Before: const { WebcastPushConnection } = require('tiktok-live-connector');
const { WebcastPushConnection } = require('@tiktool/live');
const connection = new WebcastPushConnection('username', {
signApiKey: 'YOUR_TIKTOOL_API_KEY',
});
connection.on('chat', data => {
console.log(`${data.user.uniqueId}: ${data.comment}`);
});
connection.on('gift', data => {
console.log(`${data.user.uniqueId} sent ${data.giftName}`);
});
connection.on('roomUser', data => {
console.log(`Viewers: ${data.viewerCount}`);
});
connection.on('connected', state => {
console.log('Connected!', connection.getState());
});
connection.connect();100% de compatibilidade nos nomes de eventos
Todo nome de evento do TTLC funciona exatamente igual. Também disparamos ao mesmo tempo o nome nativo do TikTools.
| Nome do evento no TTLC | Status | Observações |
|---|---|---|
chat | ✓ | Idêntico |
member | ✓ | Idêntico |
gift | ✓ | Idêntico |
like | ✓ | Idêntico |
follow | ✓ | Idêntico |
share | ✓ | Idêntico |
subscribe | ✓ | Idêntico |
social | ✓ | Idêntico |
roomUser | ✓ | Alias de roomUserSeq - os dois disparam |
questionNew | ✓ | Alias de question - os dois disparam |
linkMicBattle | ✓ | Alias de battle - os dois disparam |
linkMicArmies | ✓ | Alias de battleArmies - os dois disparam |
emote | ✓ | Alias de emoteChat - os dois disparam |
envelope | ✓ | Idêntico |
liveIntro | ✓ | Idêntico |
roomPin | ✓ | Idêntico |
barrage | ✓ | Idêntico |
superFan | ✓ | Novo na 2.0.8 - suportado |
superFanJoin | ✓ | Novo na 2.0.8 - suportado |
superFanBox | ✓ | Novo na 2.0.8 - suportado |
connected | ✓ | Idêntico |
disconnected | ✓ | Idêntico |
error | ✓ | Idêntico |
streamEnd | ✓ | Idêntico |
rawData | ✓ | Dispara com o payload bruto completo do evento |
websocketConnected | ✓ | Dispara quando o WS abre |
Por que mudar para a API gerenciada?
Nunca quebra
O TikTok atualiza o protocolo com frequência e quebra integrações diretas. O TikTool cuida de todas as mudanças de protocolo para você - zero tempo fora do ar.
Entrega de eventos mais rápida
Latência de eventos abaixo de 50ms com a nossa infraestrutura otimizada. Nada de decodificar protobuf do seu lado.
Zero dependências
Sem protobufjs, sem ws-client, sem assinatura HTTP. Só um pacote npm sem nenhuma dependência externa.
Reconexão automática
Reconexão com backoff exponencial embutida. Sua conexão sobrevive a quedas rápidas de rede e a reinícios dos servidores do TikTok.
Painel de uso
Acompanhe o uso da API, as conexões WebSocket e o volume de eventos em tempo real em tik.tools/dashboard.
Suporte para devs
Tenha ajuda pelo Discord, por e-mail ou pelo chat de suporte no app. Tempo de resposta abaixo de 4 horas.
Dúvidas comuns
Meus tipos de TypeScript continuam funcionando?
Sim. O @tiktool/live vem com definições completas de TypeScript para todo payload de evento - chat, gift, roomUser e todos os outros. Se você usava os tipos mantidos pela comunidade do TTLC, os nossos são mais rígidos e ficam em dia com o schema protobuf real do TikTok.
E as opções do TTLC como sessionId, processInitialData e requestPollingIntervalMs?
As opções do construtor que controlam o comportamento da conexão - sessionId, requestPollingIntervalMs, enableExtendedGiftInfo e parecidas - são aceitas e repassadas. Opções que não se aplicam mais (como processInitialData) são ignoradas em silêncio, então seu objeto de configuração não precisa de limpeza.
O TTLC às vezes funciona sem chave de API. Preciso de uma para o TikTool?
Sim - é preciso uma signApiKey. A chave Sandbox grátis sai em 30 segundos em tik.tools/login, sem cartão de crédito. O Sandbox inclui 5.000 chamadas de API/dia e 3 conexões WebSocket simultâneas, o suficiente para desenvolvimento e testes.
O que acontece de fato quando o TikTok atualiza o protocolo?
Com o TTLC, as atualizações periódicas do algoritmo de assinatura e do schema protobuf do TikTok fazem a biblioteca parar de funcionar - às vezes poucas horas depois de um deploy do TikTok, sem correção até o mantenedor open source lançar um patch. Com o TikTool, as atualizações de protocolo são tratadas nos nossos servidores gerenciados. Seu código não vê mudança nenhuma; os eventos continuam chegando.
Bônus: recursos que o TTLC não tem
Descoberta de lives
Busque e descubra quem está ao vivo no TikTok agora. Filtre por idioma, região e número de espectadores.
SDK para Python
SDK completo para Python disponível: pip install tiktok-live-api. A mesma API, os mesmos eventos, outra linguagem.
Pronto para migrar?
Pegue uma chave de API grátis - sem cartão de crédito. O plano Sandbox inclui 5.000 requisições/dia e 3 conexões WebSocket simultâneas - grátis, só para desenvolvimento e avaliação.