La API de outreach por DM en TikTok

¿Existe una API oficial de TikTok para mandar DMs?

No. A junio de 2026, TikTok no ofrece ninguna API oficial para iniciar mensajes directos a personas que no te han contactado antes. La única superficie oficial de mensajería — la Business Messaging API — está pensada para soporte inbound, no para outreach.

Sus restricciones lo dejan claro: el usuario tiene que escribir primero a tu negocio, tienes una ventana de respuesta de 48 horas, puedes mandar unos 10 mensajes automatizados por ventana y el broadcasting está prohibido. Justo por eso las herramientas inbound construidas sobre ella (ManyChat es la más conocida) no pueden iniciar ni un solo cold DM.

Así que toda herramienta real de cold DM del mercado opera fuera de la API oficial — Hooka incluida. Lo decimos sin rodeos porque condiciona todo el diseño: la API de Hooka es una capa programática gestionada sobre cuentas reales de TikTok. Tú llamas a endpoints REST limpios; Hooka ejecuta las sesiones reales de Chrome, aplica en el servidor los topes diarios por cuenta y el espaciado entre mensajes, y pausa los envíos exactamente 5 minutos cuando TikTok avisa de que estás "enviando demasiado rápido". Los números detrás de esos valores por defecto están en nuestra guía de límites de DM en TikTok en 2026.

¿Cómo funciona la API de Hooka?

Funciona como esperarías si has usado Stripe: una API REST versionada (versión actual 2026-06-01), autenticación con bearer keys, IDs de objeto tipados y JSON predecible. Las convenciones:

• Keys: bearer keys hk_live_ y hk_test_, creadas en autoservicio desde la página Developers de tu panel. Se guardan como hashes sha256 y se muestran exactamente una vez — cópialas al crearlas.
• IDs tipados: cada ID te dice a qué apunta — snd_ para senders, cmp_ para campañas, tgt_ para targets.
• Idempotencia: pasa una cabecera Idempotency-Key en las escrituras y los reintentos son seguros durante 24 horas — sin campañas duplicadas, sin envíos dobles.
• Trazabilidad: cada respuesta lleva una cabecera Hooka-Request-Id que puedes citar en los tickets de soporte.
• Límite de peticiones: 300 peticiones por minuto.

Todo lo que hace el panel para outreach — senders, campañas, todo el conjunto de funciones desde la sender rotation hasta el inbox unificado — se apoya en el mismo motor que mueven tus llamadas a la API.

Quickstart: de la API key a tu primera campaña en cuatro llamadas

Este es todo el flujo principal. Conecta un sender, crea una campaña, añade targets, arráncala — y luego escucha los webhooks.

1. Conecta un sender

La conexión es solo por QR y sin contraseña: la llamada devuelve un código QR, lo escaneas desde la app de TikTok y la cuenta pasa a connected. Hooka guarda solo cookies de sesión — nunca una contraseña.

curl -X POST https://api.hooka.to/v1/senders \
  -H "Authorization: Bearer hk_live_..." \
  -d '{ "label": "cuenta-outreach-1" }'

# → { "id": "snd_...", "status": "pending", "qr": "..." }

2. Crea una campaña

Las campañas aceptan variants de mensaje (hasta 20 por paso, elegidas al azar en cada envío), follow_ups (hasta 10 pasos, cada uno con su retraso de 1–60 días y sus propias variantes) y settings. Un follow-up solo sale si el lead no ha respondido — las respuestas siempre detienen la secuencia.

curl -X POST https://api.hooka.to/v1/campaigns \
  -H "Authorization: Bearer hk_live_..." \
  -H "Idempotency-Key: 1d4e8f2a-lanzamiento-junio" \
  -d '{
    "name": "Outreach UGC — junio",
    "variants": [
      "Hola {{handle}} — me encantó tu último vídeo. Una pregunta rápida...",
      "Hola {{handle}}, trabajamos con creadores como tú en..."
    ],
    "follow_ups": [
      { "delay_days": 3, "variants": ["Te lo recuerdo, {{handle}} — ¿sigue interesándote?"] }
    ],
    "settings": { "daily_limit": 100, "spacing_seconds": 7 }
  }'

3. Añade targets

Hasta 1.000 handles por lote, cada uno con variables arbitrarias por target (como {{first_name}}) que puedes usar en cualquier variante. Los duplicados, los handles ya contactados y cualquiera de tu lista Do-Not-Contact se saltan automáticamente, con contadores de saltados devueltos por lote.

curl -X POST https://api.hooka.to/v1/campaigns/cmp_.../targets \
  -H "Authorization: Bearer hk_live_..." \
  -d '{
    "targets": [
      { "handle": "creator_one", "variables": { "first_name": "Mia" } },
      { "handle": "creator_two", "variables": { "first_name": "Leo" } }
    ]
  }'

4. Arráncala

curl -X POST https://api.hooka.to/v1/campaigns/cmp_.../start \
  -H "Authorization: Bearer hk_live_..."

A partir de aquí el motor toma el control: los envíos se espacian en el servidor (7 segundos por defecto, configurable de 3 a 300s), tienen tope diario por cuenta y rotan entre hasta 10 senders conectados. Tu trabajo ha terminado — escucha los eventos.

¿Cómo funcionan los webhooks?

Registra un endpoint HTTPS vía POST /v1/webhook_endpoints y Hooka te empuja 12 tipos de evento mientras corren tus campañas, entre ellos:

• sender.connected y sender.status_changed — cambios de salud de la cuenta (cooldown, disconnected, banned)
• campaign.started y campaign.completed
• target.sent — un DM salió de la cola
• target.replied — lleva un flag opt_out cuando el lead pidió parar (Hooka lo añade a la blacklist automáticamente)
• message.received — cualquier mensaje entrante, para volcarlo en tu CRM

Cada entrega va firmada con HMAC-SHA256 para que puedas verificar que de verdad viene de Hooka:

Hooka-Signature: t=1781222400,v1=4f0a9c2e8b7d6f5a3c1e0d9b8a7f6e5d4c3b2a190817263544536271809f8e7d

Las entregas caducan a los 10 segundos. Las fallidas se reintentan a 1m, 5m, 30m, 2h, 6h y 24h — hasta 8 intentos. ¿No puedes alojar un endpoint? Consulta GET /v1/events: expone el mismo flujo de eventos como fallback o barrido de reconciliación.

Preguntas frecuentes

Sigue leyendo