> ## 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.

# Social

> Social reúne comandos de interacción y consultas manuales de perfiles públicos de Instagram y Roblox. La lectura de Instagram requiere la integración oficial de Meta; no se publican alertas automáticas de actividad.

## Interacciones de comunidad

Headless registra `slap`, `punch`, `kiss`, `pet`, `hug`, `kill`, `marry`, `marriage`, `divorce` y `ship`. Son respuestas sociales dentro de Discord, no sanciones de moderación. La mayoría funciona en servidores y aplica cooldown por usuario; las menciones y los GIF dependen del comando y de los recursos disponibles.

El texto y las etiquetas de controles que genera Social se muestran en inglés. Los nombres, notas y biografías escritos por miembros o proveedores no se traducen.

> **Referencia completa de comandos**
>
> * **`.slap <miembro> [nota]`** — **Uso y comportamiento:** Cachetada social; también puedes responder al mensaje de la persona sin repetir la mención. · **Acceso y cooldown:** Servidor; 4 s por usuario
> * **`.punch <miembro> [nota]`** — **Uso y comportamiento:** Interacción de golpe; requiere objetivo. · **Acceso y cooldown:** Servidor; 4 s por usuario
> * **`.kiss <miembro> [nota]`** — **Uso y comportamiento:** Interacción de beso; requiere objetivo. · **Acceso y cooldown:** Servidor; 4 s por usuario
> * **`.pet <miembro> [nota]`** — **Uso y comportamiento:** Interacción de caricia; requiere objetivo. · **Acceso y cooldown:** Servidor; 4 s por usuario
> * **`.hug [miembro] [nota]`** — **Uso y comportamiento:** Abrazo dirigido; sin objetivo ni respuesta a mensaje, se aplica a quien lo invoca. · **Acceso y cooldown:** Servidor; 4 s por usuario
> * **`.kill <miembro> [nota]`** — **Uso y comportamiento:** Acción ficticia de KO; requiere objetivo y no se puede dirigir a bots. · **Acceso y cooldown:** Servidor; 4 s por usuario
> * **`.marry [miembro] [nota]`** — **Uso y comportamiento:** Sin miembro, consulta tu estado; con miembro, envía una propuesta que la otra persona debe aceptar. No registra matrimonio con bots ni con personas ya emparejadas. · **Acceso y cooldown:** Servidor; 12 s por usuario
> * **`.marriage [miembro]`** — **Uso y comportamiento:** Consulta el estado de matrimonio propio o de otra persona. · **Acceso y cooldown:** Servidor; 5 s por usuario
> * **`.divorce [motivo]`** — **Uso y comportamiento:** Elimina el vínculo de ambas personas; el motivo es opcional. · **Acceso y cooldown:** Servidor; 12 s por usuario
> * **`.ship <miembro_a> [miembro_b]`** — **Uso y comportamiento:** Con un miembro, calcula la afinidad entre quien ejecuta y esa persona; con dos, calcula la pareja indicada. La puntuación es estable para el mismo par en el mismo servidor. · **Acceso y cooldown:** Servidor; 6 s por usuario
> * **`.instagram <username>` (`.ig`, `.insta`)** — **Uso y comportamiento:** Consulta el perfil público; si Meta no está configurado, solo entrega un enlace al perfil. · **Acceso y cooldown:** Prefijo o `/buscar instagram` y `/buscar ig`; 3 s por usuario

Las interacciones sociales no requieren permisos de moderación. Instagram tampoco requiere permisos elevados y puede ejecutarse fuera de un servidor; Roblox se documenta por separado en [Roblox Avatar](/docs/integrations/roblox-avatar.md).

> **Uso**
>
> Menciona a otra persona o responde a su mensaje. Las tarjetas sociales usan GIFs disponibles con una imagen alternativa cuando falla la fuente; cada comando conserva su propio cooldown.

> **Marry**
>
> La propuesta muestra botones para aceptar o rechazar. Puedes consultar el estado con `marry` o `marriage`; `divorce` elimina los dos registros de pareja guardados para ese servidor.

> [!NOTE]
>
> Las interacciones sociales se ejecutan con comandos. La configuración actual no expone un módulo Social en Dashboard ni controles para borrar automáticamente cada respuesta. No hay un comando `pat` registrado; utiliza los comandos listados arriba.

### `.hug`

```headless-command Syntax theme={null}
.hug [target] [note]
```

```headless-command Example theme={null}
.hug @Member
```

### `.ship`

```headless-command Syntax theme={null}
.ship [member_a] [member_b]
```

```headless-command Example theme={null}
.ship @Member @Other
```

## Consultas públicas de Instagram

Usa `.instagram`, `.ig` o `.insta`, o `/buscar instagram` y `/buscar ig`. Acepta username, `@username` o un enlace `instagram.com`. La consulta de métricas usa la API oficial Meta Business Discovery y requiere que Headless tenga configurados el token y el ID de una cuenta profesional de Instagram. Sin esa configuración, el comando ofrece el enlace seguro al perfil y explica que la lectura de métricas no está habilitada. No inicia sesión como el miembro ni lee cuentas privadas.

### `.instagram`

```headless-command Syntax theme={null}
.instagram <username>
```

```headless-command Example theme={null}
.instagram @username
```

### `/buscar ig`

```headless-command Syntax theme={null}
/buscar ig username:<username>
```

```headless-command Example theme={null}
/buscar ig username:@username
```

## Roblox: búsqueda de perfil

Usa `.roblox`, `.rbx` o `.rblx`, o `/buscar roblox` y `/buscar rbx`. La consulta admite username, display name, ID o URL de perfil. La respuesta puede incluir avatar, nombre visible, fecha de creación, estado, insignia verificada, conteos de amistades/seguidores, grupos y presencia pública disponible. Es una consulta de lectura a las APIs de Roblox; no vincula una cuenta ni solicita credenciales.

### `.roblox`

```headless-command Syntax theme={null}
.roblox <query>
```

```headless-command Example theme={null}
.roblox builderman
```

### `/buscar roblox`

```headless-command Syntax theme={null}
/buscar roblox query:<query>
```

```headless-command Example theme={null}
/buscar roblox
```

> [!WARNING]
>
> No se permite tratar perfiles privados como accesibles ni solicitar contraseñas. No uses estos comandos para acosar a miembros o amplificar información fuera de su contexto.

**Nota:**

Instagram y Roblox muestran datos públicos disponibles. Instagram usa Business Discovery; sin credenciales oficiales configuradas solo se entrega un enlace al perfil. Roblox puede omitir campos de presencia o conteos si su API no los devuelve.

## Integraciones y límites

TikTok y Pinterest usan flujos OAuth separados para conectar una cuenta propia desde el Dashboard; esa autorización no convierte esta página en un sistema de notificaciones. Los resultados de Instagram/Roblox dependen de la configuración y disponibilidad del proveedor. Los comandos limitan la frecuencia por usuario y devuelven un error recuperable si el proveedor rechaza o limita la solicitud.

## Pasos

**1. Elige una consulta o interacción**

Usa un comando social para una respuesta puntual, o Instagram/Roblox para buscar un perfil público.

**2. Comprueba la entrada**

Instagram acepta username, `@username` o enlace oficial. Roblox acepta username, display name, ID o URL de perfil.

**3. Abre el perfil y respeta sus límites**

Revisa la tarjeta y abre el enlace del perfil. No intentes eludir restricciones del proveedor ni uses los comandos para hostigar a otra persona.

> **Cooldowns de consultas**
>
> Instagram limita cada usuario a una consulta cada 3 segundos. Roblox limita cada usuario a una consulta cada 4 segundos. Las interacciones sociales también usan límites por usuario, con un intervalo distinto para `marry`; si Discord responde que el comando está en cooldown, espera antes de volver a intentarlo.

## Páginas relacionadas

* [TikTok](/docs/integrations/tiktok.md)
* [Pinterest](/docs/integrations/pinterest.md)
* [Roblox Avatar](/docs/integrations/roblox-avatar.md)


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