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

# Notificaciones push

> Aprende a usar notificaciones push en una experiencia de producto gamificada con Trophy.

Trophy puede enviar notificaciones push automatizadas a los usuarios basándose en disparadores clave sin requerir código. Aquí veremos cuáles son estos disparadores y cómo pueden formar parte de la experiencia de gamificación de tu producto.

## Tipos de notificaciones push

Trophy admite 4 tipos de notificaciones push, cada una diseñada para adaptarse a un escenario común en la construcción de experiencias de gamificación.

Todas las notificaciones push son opcionales, pero las cuatro pueden usarse simultáneamente y pueden controlarse desde la página de [Notificaciones push](https://app.trophy.so/push/configure) en el panel de Trophy.

<video autoPlay muted loop playsInline src="https://mintcdn.com/trophy-cep/jV5zFWvq5WvABxJP/assets/features/push/push_notification_types.mp4?fit=max&auto=format&n=jV5zFWvq5WvABxJP&q=85&s=10e87e627e9427358a53321380ba970e" />

* Las **notificaciones de logros** se envían a los usuarios cada vez que desbloquean un [Logro](/es/features/milestones.md).
* Las **notificaciones de resumen** se envían a los usuarios con una frecuencia predefinida para resumir el progreso. Las notificaciones de resumen pueden configurarse para enviarse diaria, semanal, mensual o anualmente dependiendo de tu caso de uso.
* Las **notificaciones de reactivación** se envían a los usuarios después de que se vuelven inactivos con el objetivo de traerlos de vuelta a tu app.
* Las **notificaciones de rachas** se envían automáticamente a los usuarios recordándoles extender su [Racha](/es/features/streaks.md).

## Canales compatibles

Trophy admite el envío de notificaciones push usando 3 canales que pueden configurarse todos en la página de [Canales](https://app.trophy.so/push/channels) del panel de Trophy.

### Apple Push Notification Service (APNs)

Trophy admite el envío de notificaciones push a los usuarios a través de APNs mediante una conexión basada en certificados.

Para enviar notificaciones push usando APNs, deberás proporcionar a Trophy las siguientes credenciales de tu cuenta de Apple Developer:

* **Clave de firma de APN**: Trophy la usa para enviar notificaciones de forma segura a través de APNs
* **ID de equipo**: El ID de equipo de tu cuenta de Apple Developer
* **ID de clave**: El ID de tu clave de autenticación de APNs
* **ID de paquete**: El identificador de paquete único de tu aplicación

> [!NOTE]
>
> Para más información sobre cómo configurar una conexión basada en certificados a APNs
> desde un servicio de terceros, consulta la [guía de configuración
> oficial](https://developer.apple.com/documentation/usernotifications/establishing-a-certificate-based-connection-to-apns).

### Firebase Cloud Messaging (FCM)

Trophy admite el envío de notificaciones push a los usuarios a través de FCM. Para lograrlo, deberás proporcionar a Trophy tu JSON de cuenta de servicio de Firebase en el siguiente formato:

```json FCM Service Account JSON theme={null}
{
  "type": "service_account",
  "project_id": "XXX",
  "private_key_id": "XXX",
  "private_key": "-----BEGIN PRIVATE KEY-----\n\n-----END PRIVATE KEY-----\n",
  "client_email": "XXX@XXX.com",
  "client_id": "XXX",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://oauth2.googleapis.com/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/XXX"
}
```

> [!NOTE]
>
> Para más información sobre las cuentas de servicio de Firebase y cómo autenticar
> servicios externos para usar FCM, consulta la [guía oficial de cuentas de
> servicio](https://firebase.google.com/support/guides/service-accounts).

### Expo Push Service

Trophy admite el envío de notificaciones push a los usuarios a través de Expo Push Service.

Expo Push Service te ahorra tener que integrarte con FCM y APNs individualmente y dirige automáticamente las notificaciones a través del servicio correspondiente según la plataforma de tus usuarios.

Para lograrlo, debes proporcionar a Trophy algunos detalles clave de tu cuenta de Expo:

* **Nombre del proyecto Expo**: El nombre de tu proyecto Expo
* **Token push de Expo**: Tu token de autenticación para enviar notificaciones a través de Expo (requerido si usas [seguridad mejorada](https://docs.expo.dev/push-notifications/sending-notifications/#additional-security)).

> [!NOTE]
>
> Para más información sobre Expo Push Service y cómo autenticar proveedores
> externos, consulta la [guía
> oficial](https://docs.expo.dev/push-notifications/sending-notifications).

## Envío de notificaciones push

Sigue los pasos a continuación para comenzar a enviar notificaciones push usando Trophy.

> [!TIP]
>
> Los usuarios pueden controlar qué notificaciones push reciben a través de la [API de
> preferencias de usuario](/es/features/users.md#notification-preferences) de Trophy. Esto te permite
> crear un centro de preferencias en tu aplicación donde los usuarios pueden activar o desactivar
> tipos específicos de notificaciones.

**1. Configurar canales**

Trophy admite el envío de notificaciones push a través de 3 canales: [Apple Push Notification Service (APNs)](#apple-push-notification-service-apns), [Firebase Cloud Messaging (FCM)](#firebase-cloud-messaging-fcm) o [Expo Push Service](#expo-push-service).

Dirígete a la [página de canales](https://app.trophy.so/push/channels) del panel de Trophy y configura tu canal preferido siguiendo las guías específicas anteriores.

<video autoPlay muted loop playsInline src="https://mintcdn.com/trophy-cep/jV5zFWvq5WvABxJP/assets/features/push/push_channels.mp4?fit=max&auto=format&n=jV5zFWvq5WvABxJP&q=85&s=7b6f01417e9d1ef57134cad3335ce9a6" />

**2. Agregar plantillas**

Trophy proporciona una plantilla predeterminada para cada [tipo de notificación push](#types-of-push-notifications) que Trophy admite.

En la [página de configuración](https://app.trophy.so/push/configure), cada tipo de notificación tiene su propia sección. Agrega plantillas bajo el tipo correspondiente.

Consulta la guía sobre [diseño de notificaciones push](#designing-push-notifications) para obtener más información.

![](https://mintcdn.com/trophy-cep/KNKynR4KUMaS-uCh/assets/features/push/create_push_template.png?fit=max\&auto=format\&n=KNKynR4KUMaS-uCh\&q=85\&s=f5c33beac851a706d3e1012bfb40d6e5)

**3. Asociar tokens de dispositivo**

Para enviar notificaciones a los usuarios, Trophy necesita conocer los tokens únicos asignados a sus dispositivos. Le indicas a Trophy sobre los dispositivos asociando tokens de dispositivo con cada usuario que identificas.

Trophy utilizará los tokens de dispositivo que asocies con cada usuario al comunicarse con los [canales de notificaciones push](#supported-channels) compatibles para enrutar las notificaciones al dispositivo correcto.

Para asociar un token de dispositivo con un usuario en Trophy, asigna `deviceTokens` al [identificar usuarios explícitamente](https://docs.trophy.so/api-reference/endpoints/users/identify-a-user#body-device-tokens), o al [enviar eventos de métricas](https://docs.trophy.so/api-reference/endpoints/events/submit-a-metric-event#body-user-device-tokens).

Así es como se asocian tokens de dispositivo al identificar usuarios:

```bash cURL {10} theme={null}
curl --request PUT \
  --url https://app.trophy.so/api/users/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
  "email": "user@example.com",
  "name": "User",
  "tz": "Europe/London",
  "subscribeToEmails": true,
  "deviceTokens": ["token1", "token2"]
}'
```

```typescript Node {6} theme={null}
trophy.users.identify("user-id", {
  email: "user@example.com",
  name: "User",
  tz: "Europe/London",
  subscribeToEmails: true,
  deviceTokens: ["token1", "token2"],
});
```

```python Python {7} theme={null}
client.users.identify(
    id="user-id",
    email="user@example.com",
    name="User",
    tz="Europe/London",
    subscribeToEmails=True,
    deviceTokens=["token1", "token2"],
)
```

```php PHP {6} theme={null}
$trophy->users->identify("user-id", [
    'email' => 'user@example.com',
    'name' => 'User',
    'tz' => 'Europe/London',
    'subscribeToEmails' => true,
    'deviceTokens' => ['token1', 'token2'],
]);
```

```java Java {6} theme={null}
UpdatedUser user = UpdatedUser.builder()
    .email("user@example.com")
    .name("User")
    .tz("Europe/London")
    .subscribeToEmails(true)
    .deviceTokens(Arrays.asList("token1", "token2"))
    .build();

client.users().identify("user-id", user);
```

```go Go {8} theme={null}
response, err := client.Users.Identify(
    "user-id",
    &api.UpdatedUser{
        Email:            "user@example.com",
        Name:             "User",
        Tz:               "Europe/London",
        SubscribeToEmails: true,
        DeviceTokens:     []string{"token1", "token2"},
    },
)
```

```csharp C# {6} theme={null}
var user = new UpdatedUser {
    Email = "user@example.com",
    Name = "User",
    Tz = "Europe/London",
    SubscribeToEmails = true,
    DeviceTokens = new[] { "token1", "token2" }
};

await trophy.Users.IdentifyAsync("user-id", user);
```

```ruby Ruby {7} theme={null}
result = client.users.identify(
  "user-id",
  :email => "user@example.com",
  :name => "User",
  :tz => "Europe/London",
  :subscribeToEmails => true,
  :deviceTokens => ["token1", "token2"]
)
```

Y aquí se muestra cómo asociar tokens de dispositivo al enviar eventos de métrica:

```bash cURL {10} theme={null}
curl -X POST https://app.trophy.so/api/metrics/flashcards-flipped/event \
     -H "X-API-KEY: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "user": {
    "id": "18",
    "email": "user@example.com",
    "tz": "Europe/London",
    "deviceTokens": ["token1", "token2"]
  },
  "value": 750
}'
```

```typescript Node {6} theme={null}
trophy.metrics.event("flashcards-flipped", {
  user: {
    id: "18",
    email: "user@example.com",
    tz: "Europe/London",
    deviceTokens: ["token1", "token2"],
  },
  value: 750,
});
```

```python Python {7} theme={null}
client.metrics.event(
    key="flashcards-flipped",
    user=EventRequestUser(
        id="18",
        email="user@example.com",
        tz="Europe/London",
        deviceTokens=["token1", "token2"],
    ),
    value=750.0,
)
```

```php PHP {6} theme={null}
$user = new EventRequestUser([
    'id' => '18',
    'email' => 'user@example.com',
    'deviceTokens' => ['token1', 'token2'],
]);

$request = new MetricsEventRequest([
    'user' => $user,
    'value' => 750
]);

$trophy->metrics->event("flashcards-flipped", $request);
```

```java Java {6} theme={null}
MetricsEventRequest request = MetricsEventRequest.builder()
      .user(
        EventRequestUser.builder()
          .id("18")
          .email("user@example.com")
          .deviceTokens(Arrays.asList("token1", "token2"))
          .build()
      )
      .value(750)
      .build();

EventResponse response = client.metrics().event("flashcards-flipped", request);
```

```go Go {8} theme={null}
response, err := client.Metrics.Event(
    "flashcards-flipped",
    &api.MetricsEventRequest{
        User: &api.EventRequestUser{
            Id: "18",
            Email: "user@example.com",
            DeviceTokens: []string{"token1", "token2"},
        },
        Value: 750,
    },
)
```

```csharp C# {6} theme={null}
var user = new EventRequestUser {
   Id = "18",
   Email = "user@example.com",
   DeviceTokens = new[] { "token1", "token2" }
};

var request = new MetricsEventRequest {
   User = user,
   Value = 750
};

await trophy.Metrics.EventAsync("flashcards-flipped", request);
```

```ruby Ruby {7} theme={null}
result = client.metrics.event(
  :key => 'flashcards-flipped',
  :user => {
    :id => '18',
    :email => 'user@example.com',
    :deviceTokens => ['token1', 'token2']
  },
  :value => 750
)
```

> [!TIP]
>
> Cada usuario puede tener múltiples tokens de dispositivo asociados, para dar soporte a usuarios que utilizan varios dispositivos.

**4. Activar plantillas**

El último paso es activar una plantilla dentro de cada sección de [tipo de notificación push](#types-of-push-notifications) que desees enviar.

En la [página de configuración](https://app.trophy.so/push/configure), activa una plantilla en cada sección de tipo que desees habilitar. Una vez activadas, Trophy comenzará a enviar notificaciones push automáticamente.

> [!TIP]
>
> Los usuarios pueden controlar qué tipos de notificaciones push reciben a través de la [API de preferencias de usuario](/es/features/users.md#notification-preferences) de Trophy. Cuando un usuario ha desactivado un tipo de notificación en sus preferencias, Trophy respetará esa configuración y no enviará esas notificaciones a ese usuario.

<video autoPlay muted loop playsInline src="https://mintcdn.com/trophy-cep/jV5zFWvq5WvABxJP/assets/features/push/activating_templates.mp4?fit=max&auto=format&n=jV5zFWvq5WvABxJP&q=85&s=9bd6910732be578675eeada68c9cd063" />

## Diseñar Notificaciones Push

Por defecto, Trophy proporciona una plantilla para cada [tipo de notificación push](#types-of-push-notifications) como un buen punto de partida. Las plantillas predeterminadas no se pueden modificar, pero puedes duplicarlas y personalizarlas como desees.

> [!TIP]
>
> También puedes crear plantillas en blanco si prefieres empezar desde cero.

### Estructura de Plantilla

Cada notificación push tiene un título y un cuerpo, y el editor de plantillas de notificaciones push sin código de Trophy te permite personalizar completamente ambos campos.

![](https://mintcdn.com/trophy-cep/KNKynR4KUMaS-uCh/assets/features/push/push_template_editor.png?fit=max\&auto=format\&n=KNKynR4KUMaS-uCh\&q=85\&s=e62f3987cfb30f5a84580f8c7c4f2cb2)

### Usar Variables

Trophy proporciona un amplio conjunto de variables que pueden utilizarse para insertar datos altamente relevantes y personalizados en tus notificaciones push.

Las variables se pueden insertar escribiendo `@` en el título o el cuerpo de cualquier notificación push, y buscando la variable elegida.

Esto abrirá la ventana del editor de variables donde puedes configurar variables como en la demostración a continuación. También puedes probar diferentes valores de variables y cómo se comporta tu plantilla en distintos escenarios utilizando la barra lateral de vista previa.

<video autoPlay muted loop playsInline src="https://mintcdn.com/trophy-cep/jV5zFWvq5WvABxJP/assets/features/push/push_variables.mp4?fit=max&auto=format&n=jV5zFWvq5WvABxJP&q=85&s=c0b1c407ef6c56888e4b65af0e8c8da0" />

### Usar Variaciones

Las variaciones se pueden usar para agregar aleatoriedad al título y cuerpo de las notificaciones push enviadas por Trophy. Esto evita que las notificaciones se vuelvan monótonas y ayuda a mejorar las tasas de interacción.

Al momento del envío, Trophy selecciona automáticamente una de tus variaciones del título y cuerpo de forma aleatoria y envía la notificación al usuario.

<video autoPlay muted loop playsInline src="https://mintcdn.com/trophy-cep/jV5zFWvq5WvABxJP/assets/features/push/push_variations.mp4?fit=max&auto=format&n=jV5zFWvq5WvABxJP&q=85&s=510c6ffd043614f294c339d033397e0e" />

### Usar Condiciones

El generador de plantillas de notificaciones push de Trophy permite usar condiciones para enviar contenido diferente a cada destinatario según su contexto único.

Todas las [variables de plantilla](#using-variables) se pueden usar en condiciones para controlar qué contenido se utiliza en el título y cuerpo de las notificaciones enviadas por Trophy.

Al momento del envío, Trophy calcula todas las condiciones usando el contexto único de cada destinatario, entregando notificaciones altamente personalizadas y relevantes a cada usuario.

<video autoPlay muted loop playsInline src="https://mintcdn.com/trophy-cep/jV5zFWvq5WvABxJP/assets/features/push/push_conditions.mp4?fit=max&auto=format&n=jV5zFWvq5WvABxJP&q=85&s=822523984ad541ed4a5f511ab935b525" />

## Obtener Soporte

¿Quieres contactar con el equipo de Trophy? Comunícate con nosotros por [correo electrónico](mailto:support@trophy.so). ¡Estamos aquí para ayudarte!


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