> ## Documentation Index
> Fetch the complete documentation index at: https://docs.headlesslabs.xyz/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# TikTok

> TikTok consulta solamente la cuenta que la misma persona vinculó mediante Headless Dashboard y los scopes que autorizó. La integración usa TikTok Login Kit y Display API en modo de lectura.

## Vincular una cuenta

`.tt connect` muestra el acceso al flujo oficial de OAuth; completa la autorización desde tu sesión de Headless Dashboard. Se piden `user.info.basic` y `video.list`. Los tokens quedan cifrados en PostgreSQL y asociados al ID de Discord de esa persona. No pegues tokens en el bot.

## Perfil y videos

El grupo `.tt` y `profile` consultan el perfil autorizado; `videos` muestra hasta cinco publicaciones y ofrece navegación por cursor. `video` abre el detalle de un ID perteneciente a la cuenta conectada. Los resultados de slash se envían como respuesta efímera; los controles de paginación pertenecen al usuario que inició la consulta.

### `.tiktok profile`

```headless-command Syntax theme={null}
.tiktok profile
```

```headless-command Example theme={null}
.tt profile
```

### `/tiktok profile`

```headless-command Syntax theme={null}
/tiktok profile
```

```headless-command Example theme={null}
/tiktok profile
```

### `.tiktok videos`

```headless-command Syntax theme={null}
.tiktok videos
```

```headless-command Example theme={null}
.tt videos
```

### `.tiktok video`

```headless-command Syntax theme={null}
.tiktok video <video_id>
```

```headless-command Example theme={null}
.tt video 1234567890
```

## Renovación y desconexión

Headless intenta renovar una sesión próxima a vencer. `disconnect` solicita la revocación remota de TikTok cuando hay credenciales, pero la revocación es best-effort; siempre elimina del vault local la conexión de ese usuario. La publicación de videos no está disponible.

### `.tiktok connect`

```headless-command Syntax theme={null}
.tiktok connect
```

```headless-command Example theme={null}
.tt connect
```

### `.tiktok disconnect`

```headless-command Syntax theme={null}
.tiktok disconnect
```

```headless-command Example theme={null}
.tt disconnect
```

## Pasos

**1. Conecta tu propia cuenta**

Ejecuta `.tt connect` o `/tiktok connect` y sigue la autorización de la Dashboard oficial.

**2. Consulta el contenido permitido**

Usa `.tt p`, `.tt vids` o `.tt v <ID>`; la API limita los datos según los scopes concedidos.

**3. Elimina la conexión**

Usa `.tt disconnect` y confirma que el bot ya no devuelve la cuenta vinculada.

## Comandos registrados

* **`.tiktok` (`.tt`)** — **Comando slash:** — · **Resultado:** Muestra el perfil y hasta cinco videos recientes de tu cuenta conectada. · **Cooldown de prefijo:** 5 s
* **`.tiktok profile` (`p`, `perfil`)** — **Comando slash:** `/tiktok profile` · **Resultado:** Muestra el perfil autorizado. · **Cooldown de prefijo:** 5 s
* **`.tiktok videos` (`vids`, `lista`)** — **Comando slash:** `/tiktok videos` · **Resultado:** Muestra hasta cinco videos visibles y controles de página. · **Cooldown de prefijo:** 5 s
* **`.tiktok video <video_id>` (`v`, `detail`, `detalle`)** — **Comando slash:** `/tiktok video video_id` · **Resultado:** Consulta un video de tu propia cuenta conectada. · **Cooldown de prefijo:** 5 s
* **`.tiktok connect` (`conectar`)** — **Comando slash:** `/tiktok connect` · **Resultado:** Abre el acceso al OAuth oficial para vincular tu propia cuenta. · **Cooldown de prefijo:** 10 s
* **`.tiktok disconnect` (`desconectar`)** — **Comando slash:** `/tiktok disconnect` · **Resultado:** Intenta revocar la sesión remota y elimina la credencial local. · **Cooldown de prefijo:** 10 s

> [!WARNING]
>
> Headless no publica videos ni consulta cuentas ajenas. Si TikTok rechaza una consulta, falta un scope o venció el refresh token, reconecta desde la Dashboard oficial; no compartas credenciales.

**Nota:**

Los callbacks no declaran permisos elevados de Discord. La consulta y desconexión usan el ID de Discord de quien ejecuta el comando; la autorización OAuth es individual.

## Páginas relacionadas

* [Integraciones](/docs/integrations.md)
* [Pinterest](/docs/integrations/pinterest.md)
* [YouTube](/docs/integrations/youtube.md)
* [Dashboard](/docs/dashboard.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.