Migração em um passo

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.

1

Instale o SDK

npm install @tiktool/live
2

Troque uma linha de import

-const { WebcastPushConnection } = require('tiktok-live-connector');
+const { WebcastPushConnection } = require('@tiktool/live');
3

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.

✅
Pronto. Todos os seus handlers de eventos continuam funcionando igualzinho - chat, gift, member, roomUser, like, follow, share, emote, linkMicBattle, linkMicArmies, questionNew, getState(), connect(), disconnect().

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 TTLCStatusObservaçõ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.