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

# Aliases

> Aprenda cómo usar aliases personalizados en OneSignal para identificar y rastrear usuarios en diferentes plataformas y dispositivos usando sus propios identificadores únicos. Los aliases ayudan a unificar datos de usuarios de múltiples fuentes y son esenciales para integraciones, gestión de datos de usuarios y mensajería transaccional.

Los aliases personalizados le permiten asignar identificadores clave-valor personalizados a usuarios en OneSignal, habilitando el seguimiento e identificación de usuarios multiplataforma usando sus propios ID internos.

<Warning>
  **Importante**: Debe establecer un [External ID](./users) **antes** de usar aliases personalizados.

  OneSignal usa un `onesignal_id` único para identificar usuarios. Este ID solo permanece consistente entre [Suscripciones](./subscriptions) si tienen el mismo `external_id`.

  Los aliases personalizados **no** vinculan suscripciones entre sí: dependen del `external_id` para funcionar correctamente. Sin él, los aliases no se asociarán con el mismo usuario en diferentes dispositivos o plataformas.
</Warning>

***

## ¿Qué es un alias personalizado?

Un alias personalizado es un par `clave : valor` donde:

* El `alias_label` (clave) es un identificador consistente y estático para todos los usuarios (por ejemplo, `facebook_id`, `firebase_id`, `crm_user_id`).
* El `alias_id` (valor) es el ID específico del usuario para esa etiqueta (por ejemplo, `facebook_id: 3453443`, `firebase_id: test3555`).

Esto le permite vincular registros de usuarios de OneSignal a identificadores de sus otras plataformas o bases de datos.

***

## ¿Por qué usar aliases?

1. Identificar usuarios en múltiples plataformas y bases de datos.
2. Enviar mensajes transaccionales dirigidos usando la [API REST Create Message](/reference/create-message).
3. Obtener, actualizar o eliminar usuarios a través de las API REST de usuarios.

***

## Cómo establecer aliases

Puede establecer aliases usando el SDK de OneSignal o a través de la API REST.

### Usar el SDK

Siga estos pasos en su aplicación:

1. Establecer el External ID
   Llame a `OneSignal.login(externalId)` para asociar el registro del usuario.

2. Establecer aliases personalizados
   Use `OneSignal.User.addAlias(label, id)` para agregar un solo alias, o `OneSignal.User.addAliases({ label1: id1, label2: id2 })` para establecer múltiples.

3. Cerrar sesión (opcional)
   Use `OneSignal.logout()` para eliminar el external ID y cualquier alias asociado para ese dispositivo o sesión.

**Ejemplo**:

```javascript theme={null}
OneSignal.login("user_123");

OneSignal.User.addAliases({
  facebook_id: "3453443",
  firebase_id: "test3555"
});

// Más tarde, cuando el usuario cierre sesión
OneSignal.logout();
```

***

### Usar la API REST

Para establecer aliases personalizados a través de la API, use el endpoint [Create Alias](/reference/create-alias). Este método se usa típicamente en sistemas backend para la gestión de usuarios del lado del servidor.

**Ejemplo de solicitud**:

```json theme={null}
POST /aliases
{
  "subscription_id": "abc123",
  "aliases": {
    "facebook_id": "3453443",
    "crm_user_id": "XYZ789"
  }
}
```

***

## Mejores prácticas

* Siempre establezca el `external_id` antes de asignar cualquier alias.
* Use etiquetas estables y descriptivas (por ejemplo, `crm_user_id`, `legacy_user_id`) para evitar confusión entre equipos.
* Evite usar información sensible como direcciones de correo electrónico o números de teléfono como valores de alias.
* Use `logout()` para limpiar aliases al cerrar sesión del dispositivo o cambiar eventos de usuario.

***

<Check>
  ¡Tutorial de aliases personalizados completado!
  Próximos pasos:

  * Revise nuestra documentación de [Usuarios](./users) y [Suscripciones](./subscriptions) si aún no lo ha hecho.
  * Explore nuestra documentación de [API REST](/reference/create-alias) para obtener más detalles sobre el uso de aliases a través de la API.
  * Configure [Integraciones](./integrations) para sincronizar datos de usuarios entre sistemas.
</Check>

***