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.
Instala el SDK
npm install @tiktool/liveCambia una línea de import
const { WebcastPushConnection } = require('tiktok-live-connector');const { WebcastPushConnection } = require('@tiktool/live');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.
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 TTLC | Estado | Notas |
|---|---|---|
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.