API de Tik Tok

Documentación interna para desarrolladores. Esta página cubre la integración de la API de TikTok for Business: devolución de llamada de OAuth, arquitectura de webhook y enrutamiento de eventos. No está destinado a usuarios finales.

​

Mapa de ruta

​

Flujo de OAuth de TikTok

1. User clicks "Connect TikTok" in Integrations settings
2. Redirect to TikTok OAuth authorization URL
3. User grants permissions (DM access)
4. TikTok redirects to GET /api/tiktok/callback?code=...&state=...
5. Server exchanges code for access token
6. Token stored encrypted in DB
7. Redirect to dashboard with success message

• dm.conversation.readonly — Leer mensajes directos
• dm.conversation.write — Enviar DM

​

Arquitectura de webhook

​

Carga útil del evento DM

{
  "event": "direct_message",
  "timestamp": 1705312800,
  "data": {
    "conversation_id": "tiktok_conv_abc",
    "sender_id": "tiktok_user_xyz",
    "message": {
      "id": "msg_abc",
      "type": "text",
      "content": "Hi, I saw your product!"
    }
  }
}

​

Enrutamiento de conversación

​

Variables de entorno necesarias

​

Problemas conocidos / Problemas

• La API de TikTok es estrictamente interna: actualmente no hay una interfaz de usuario de configuración orientada al usuario. La conexión la realiza el equipo de desarrollo en nombre de los clientes.
• Actualización de token: Los tokens de acceso a TikTok caducan. Un trabajo en segundo plano debe actualizarlos antes de que caduquen usando refresh_token.
• Disponibilidad de DM: El acceso a la API de DM de TikTok está restringido a cuentas comerciales aprobadas. La aplicación debe estar incluida en la lista blanca de TikTok.
• Límites de tarifas: TikTok impone límites estrictos de tarifas por cuenta comercial. Supervise las respuestas 429.