Migración en un paso

Cámbiate de TikTok-Live-Connector en segundos

¿Ya usas tiktok-live-connector? Cámbiate a la API gestionada de TikTool cambiando una sola línea de import. Mismos nombres de eventos, mismos métodos, cero cambios en tu código.

1

Instala el SDK

npm install @tiktool/live
2

Cambia una línea de import

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

Usa tu API key de TikTools

-signApiKey: 'EULER_API_KEY'
+signApiKey: 'TIKTOOL_API_KEY'

Consigue una key gratis en tik.tools, sin tarjeta de crédito.

✅
Eso es todo. Todos tus handlers de eventos funcionan exactamente igual: chat, gift, member, roomUser, like, follow, share, emote, linkMicBattle, linkMicArmies, questionNew, getState(), connect(), disconnect().

Ejemplo completo funcionando

Este código funciona igual con tiktok-live-connector y con @tiktool/live. Solo cambia el import.

// 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 compatibilidad en nombres de eventos

Cada nombre de evento de TTLC funciona exactamente igual. Además, disparamos al mismo tiempo el nombre nativo de TikTools.

Nombre de evento TTLCEstadoNotas
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: se disparan ambos
questionNew✓Alias de question: se disparan ambos
linkMicBattle✓Alias de battle: se disparan ambos
linkMicArmies✓Alias de battleArmies: se disparan ambos
emote✓Alias de emoteChat: se disparan ambos
envelope✓Idéntico
liveIntro✓Idéntico
roomPin✓Idéntico
barrage✓Idéntico
superFan✓Nuevo en 2.0.8: compatible
superFanJoin✓Nuevo en 2.0.8: compatible
superFanBox✓Nuevo en 2.0.8: compatible
connected✓Idéntico
disconnected✓Idéntico
error✓Idéntico
streamEnd✓Idéntico
rawData✓Se dispara con el payload completo del evento en crudo
websocketConnected✓Se dispara al abrir el WS

¿Por qué cambiarte a la API gestionada?

🛡️

Nunca se rompe

TikTok actualiza su protocolo con frecuencia y rompe las integraciones directas. TikTool se encarga de todos los cambios de protocolo por ti, sin caídas.

⚡

Entrega de eventos más rápida

Latencia de eventos por debajo de 50 ms gracias a nuestra infraestructura optimizada. Sin decodificar protobuf de tu lado.

🧩

Cero dependencias

Sin protobufjs, sin ws-client, sin firma HTTP. Solo un paquete de npm sin dependencias externas.

🔄

Reconexión automática

Reconexión con backoff exponencial integrada. Tu conexión aguanta cortes de red y reinicios de los servidores de TikTok.

📊

Panel de uso

Monitorea en tiempo real tu uso de la API, tus conexiones WebSocket y el volumen de eventos en tik.tools/dashboard.

💬

Soporte para desarrolladores

Recibe ayuda por Discord, email o el chat de soporte de la app. Tiempo de respuesta de menos de 4 horas.

Preguntas frecuentes

¿Mis tipos de TypeScript seguirán funcionando?

Sí. @tiktool/live incluye definiciones completas de TypeScript para el payload de cada evento: chat, gift, roomUser y todos los demás. Si usabas los tipos de TTLC mantenidos por la comunidad, los nuestros son más estrictos y se mantienen al día con el esquema protobuf real de TikTok.

¿Qué pasa con las opciones de TTLC como sessionId, processInitialData y requestPollingIntervalMs?

Las opciones del constructor que controlan la conexión (sessionId, requestPollingIntervalMs, enableExtendedGiftInfo y similares) se aceptan y se reenvían. Las opciones que ya no aplican (como processInitialData) se ignoran en silencio, así que no tienes que limpiar tu objeto de configuración.

TTLC a veces funciona sin API key. ¿Necesito una para TikTool?

Sí, se necesita una signApiKey. La key Sandbox gratis se obtiene en 30 segundos en tik.tools/login, sin tarjeta de crédito. Sandbox incluye 5,000 llamadas a la API por día y 3 conexiones WebSocket simultáneas, suficiente para desarrollo y evaluación.

¿Qué pasa realmente cuando TikTok actualiza su protocolo?

Con TTLC, las actualizaciones periódicas del algoritmo de firma y del esquema protobuf de TikTok hacen que la librería deje de funcionar, a veces a las pocas horas de un despliegue de TikTok, sin solución hasta que el mantenedor del código abierto la parchea. Con TikTool, las actualizaciones de protocolo se resuelven en nuestros servidores gestionados. Tu código no nota ningún cambio; los eventos siguen llegando.

Extra: funciones que TTLC no tiene

🔍

Live Feed Discovery

Busca y descubre quién está en vivo ahora mismo en TikTok. Filtra por idioma, región y número de espectadores.

🐍

SDK de Python

SDK de Python completo disponible: pip install tiktok-live-api. La misma API, los mismos eventos, otro lenguaje.

¿Listo para migrar?

Obtén una API key gratis, sin tarjeta de crédito. El plan Sandbox incluye 5,000 solicitudes/día y 3 conexiones WebSocket simultáneas: gratis, solo para desarrollo y evaluación.