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

# App de ejemplo: mensajes in-app

> Cómo la app de ejemplo Clean Beans usa disparadores de mensajes in-app y HTML personalizado para superposiciones de ayuda, un aviso previo de permiso y avisos de actualización y reseña.

Esta página forma parte de [App de ejemplo: una integración completa de OneSignal](https://documentation.onesignal.com/docs/es/example-full-integration-overview.md), que sigue una app real de principio a fin. La app es **Clean Beans**, un turno de limpieza para hogares compartidos, creada con Expo (React Native) y un backend de Supabase.

Los mensajes in-app aparecen mientras alguien usa la app. Su contenido, su audiencia y su programación están en el panel de OneSignal, así que pueden cambiar sin una nueva versión. Clean Beans los usa para cinco tareas.

| Mensaje | Se muestra cuando | Cómo se segmenta |
| - | - | - |
| Superposiciones de ayuda | El usuario toca el botón de ayuda de una pantalla | Un disparador establecido por la app |
| Recorridos guiados | El usuario necesita una visita guiada de una pantalla | El mismo disparador |
| Aviso previo de permiso de push | Antes del diálogo de permiso del sistema | Audiencia y programación en el panel |
| Aviso de actualización de la app | El usuario tiene una versión antigua | Un segmento |
| Solicitud de reseña | El usuario alcanza un hito de racha | Un disparador establecido por la app |

## Disparadores: deja que la app decida el momento \\

Un disparador es una clave y un valor que establece la app. Se muestra cualquier mensaje in-app configurado para coincidir con él. Cada pantalla de Clean Beans tiene un botón de ayuda en su cabecera que establece un disparador, con el nombre de la pantalla como valor.

```typescript src/components/HelpButton.tsx theme={null}
export function HelpButton({ triggerValue }: HelpButtonProps) {
  const handlePress = () => {
    OneSignal.InAppMessages.addTrigger('help_topic', triggerValue);
  };

  return (
    <TouchableOpacity onPress={handlePress} style={styles.button} hitSlop={8}>
      <Ionicons name="help-circle-outline" size={26} color={Colors.white} />
    </TouchableOpacity>
  );
}
```

```typescript app/(tabs)/_layout.tsx theme={null}
<Tabs.Screen
  name="index"
  options={{
    title: 'Dashboard',
    headerRight: () => <HeaderRight helpTopic="dashboard" />,
    tabBarIcon: ({ focused }) => <TabIcon name={focused ? 'home' : 'home-outline'} focused={focused} />,
  }}
/>
```

Una sola clave de disparador sirve para trece pantallas. Añadir ayuda para una pantalla nueva consiste en añadir un botón con un valor nuevo y crear un mensaje en el panel.

![Un mensaje in-app de superposición de ayuda mostrado sobre el panel](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-help.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=521ce92f66d1df24e99790600813523a)

Al tocar el botón de ayuda en el panel se muestra una superposición de ayuda.

**Configuración del panel.** En **Mensajes > In-App**, crea un mensaje cuyo disparador sea `help_topic` **is** `dashboard` y repítelo para cada pantalla. Los recorridos guiados de varios pasos usan el mismo disparador con un diseño de carrusel.

![Un mensaje in-app de recorrido guiado formado por tarjetas deslizables](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-iam-walkthrough.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=c335375ee2bb79060e97aa945dea644e)

Un recorrido guiado de varios pasos creado como un carrusel de tarjetas.

## Mensajes con HTML personalizado \\

Las superposiciones de ayuda están escritas en HTML, así que coinciden exactamente con el diseño de la app. Un mensaje in-app HTML se comunica con el SDK a través del objeto `OneSignalIamApi`. Se aplican dos reglas a cada elemento pulsable:

* Dale un `data-onesignal-unique-label` único, para que los clics se registren correctamente.
* Asígnale un listener que llame a un método de `OneSignalIamApi`. Los enlaces simples no se registran.

```html docs/iam-html/help-dashboard.html theme={null}
<button id="got-it" class="cta-btn" data-onesignal-unique-label="dashboard-got-it">Got it</button>

<script>
  document.addEventListener("DOMContentLoaded", function () {
    document.getElementById("got-it").addEventListener("click", function (e) {
      OneSignalIamApi.close(e);
    });
  });
</script>
```

## Aviso previo de permiso de push \\

El diálogo de permiso del sistema solo se puede mostrar una vez. Un mensaje in-app mostrado antes puede explicar lo que recibirá el usuario, y solo quienes tocan **Enable notifications** ven el diálogo del sistema.

![Un mensaje in-app que explica las ventajas de activar las notificaciones](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-iam-push-prompt.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=18791e9af52a803d41048eba393109f6)

Un aviso previo explica la ventaja antes de que aparezca el diálogo del sistema.

```html docs/iam-html/push-permission-prompt.html theme={null}
<script>
  document.addEventListener("DOMContentLoaded", function () {
    document.getElementById("enable-btn").addEventListener("click", function (e) {
      OneSignalIamApi.triggerPushPrompt(e);
    });
    document.getElementById("skip-btn").addEventListener("click", function (e) {
      OneSignalIamApi.close(e);
    });
  });
</script>
```

> [!NOTE]
>
> Si usas un aviso previo, elimina la llamada a `requestPermission()` del inicio de la app. De lo contrario, el diálogo del sistema aparece primero y al aviso previo ya no le queda nada que pedir.

## Aviso de actualización de la app \\

Cuando se publica una nueva versión, quienes tienen la antigua ven un aviso para actualizar. Este mensaje no necesita ningún código en la app. Su audiencia es un segmento de usuarios con una versión antigua de la app.

![Un mensaje in-app que pide al usuario que actualice la app](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-iam-app-version.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=f096ce85f566823331171e14312e534d)

El aviso de actualización, que solo se muestra a quienes tienen una versión antigua.

Un solo mensaje sirve para ambas plataformas. El script elige la tienda según el dispositivo, y `openUrl` registra el clic, abre la tienda y cierra el mensaje.

```html docs/iam-html/app-update-prompt.html theme={null}
<script>
  var IOS_URL = "https://apps.apple.com/app/id" + IOS_APP_STORE_ID;
  var ANDROID_URL = "https://play.google.com/store/apps/details?id=" + ANDROID_PACKAGE;

  // One message serves both platforms: pick the store from the device.
  var isAndroid = /android/i.test(navigator.userAgent);
  var storeUrl = isAndroid ? ANDROID_URL : IOS_URL;

  document.addEventListener("DOMContentLoaded", function () {
    document.getElementById("update-btn").addEventListener("click", function (e) {
      // openUrl tracks the click, opens the store and closes the message
      OneSignalIamApi.openUrl(e, storeUrl);
    });
    document.getElementById("later-btn").addEventListener("click", function (e) {
      OneSignalIamApi.close(e);
    });
  });
</script>
```

El saludo usa una etiqueta, con un valor alternativo para los usuarios que no la tienen.

```html docs/iam-html/app-update-prompt.html theme={null}
<p>Hey {{ user_name | default: "there" }}, you're on an older version</p>
```

**Configuración del panel.** Crea un segmento con el filtro **App version** menor que tu versión actual y úsalo como audiencia del mensaje. Actualiza el filtro cada vez que publiques una versión.

> [!NOTE]
>
> La sustitución de etiquetas funciona en el texto y los atributos de un mensaje in-app HTML, pero no dentro de las etiquetas `script`.

## Solicitud de reseña: devolver un clic a la app \\

Un buen momento para pedir una valoración en la tienda de apps es justo después de que algo haya ido bien. Clean Beans la pide cuando una sesión de limpieza lleva una racha a un múltiplo de siete días.

Este es el único mensaje in-app en el que un toque tiene que ejecutar código en la app, porque la hoja de valoración nativa solo la puede abrir la propia app.

**1. La app establece un disparador en un hito de racha**

Espera a que se cierre la pantalla de sesión, para que el aviso nunca interrumpa la limpieza, y recuerda el último hito en el que lo pidió.

```typescript src/lib/reviewPrompt.ts theme={null}
export async function maybeAskForReview(streak: number): Promise<void> {
  try {
    if (streak <= 0 || streak % STREAK_MILESTONE_DAYS !== 0) return;

    // A second session on the same day leaves the streak unchanged —
    // don't ask twice for the same milestone.
    const lastPrompted = await AsyncStorage.getItem(LAST_PROMPTED_STREAK_KEY);
    if (lastPrompted === String(streak)) return;
    await AsyncStorage.setItem(LAST_PROMPTED_STREAK_KEY, String(streak));

    OneSignal.InAppMessages.addTrigger(REVIEW_TRIGGER_KEY, REVIEW_TRIGGER_VALUE);
    console.log('[reviewPrompt] Trigger set at streak', streak);
  } catch (e) {
    console.warn('[reviewPrompt] maybeAskForReview error:', e);
  }
}
```

**2. El mensaje devuelve un nombre de clic a la app**

`addClickName` pasa un nombre al listener de clics de la app. No cierra el mensaje, así que el script lo cierra después.

```html docs/iam-html/review-prompt.html theme={null}
<script>
  document.addEventListener("DOMContentLoaded", function () {
    var autoCloseBtn = document.getElementById("auto-close-btn");

    document.getElementById("rate-btn").addEventListener("click", function (e) {
      // Passes the click name "review" to the app's In-App Message click
      // listener, which opens the native rating sheet. addClickName does not
      // close the message, so close it straight afterwards.
      OneSignalIamApi.addClickName(e, "review");
      setTimeout(function () { autoCloseBtn.click(); }, 300);
    });
    autoCloseBtn.addEventListener("click", function (e) {
      OneSignalIamApi.close(e);
    });
    document.getElementById("later-btn").addEventListener("click", function (e) {
      OneSignalIamApi.close(e);
    });
  });
</script>
```

**3. La app abre la hoja de valoración nativa**

El listener de clics comprueba el nombre y pide al sistema que muestre la hoja.

```typescript src/lib/reviewPrompt.ts theme={null}
export function handleReviewClick(event: InAppMessageClickEvent): void {
  if (event.result.actionId !== REVIEW_ACTION_ID) return;

  // Give the In-App Message a moment to close before presenting the sheet
  setTimeout(async () => {
    try {
      // false on TestFlight builds and on the web
      if (await StoreReview.isAvailableAsync()) {
        await StoreReview.requestReview();
      } else {
        console.log('[reviewPrompt] Store review not available on this build');
      }
    } catch (e) {
      console.warn('[reviewPrompt] requestReview error:', e);
    } finally {
      // Clear the trigger so the message is not re-evaluated this app session
      OneSignal.InAppMessages.removeTrigger(REVIEW_TRIGGER_KEY);
    }
  }, 800);
}
```

```typescript app/_layout.tsx theme={null}
OneSignal.InAppMessages.addEventListener('click', handleReviewClick);
```

![Un mensaje in-app de solicitud de reseña](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-review-prompt.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=90dde058450240f49d42e76402ed28ce)

El mensaje in-app de solicitud de reseña.

**Configuración del panel.** Crea un mensaje in-app HTML con el disparador `ask_for_review` **is** `show`. Prográmalo para que se muestre como máximo una vez cada 17 semanas.

> [!WARNING]
>
> Apple muestra su hoja de valoración como máximo tres veces por usuario al año, y Google tiene su propio límite, así que tocar el botón no garantiza que se muestre nada. La hoja nunca aparece en las compilaciones de TestFlight. Prueba este flujo con una compilación de la App Store.

> [card] [Disparadores in-app](https://documentation.onesignal.com/docs/es/iam-triggers.md)
>
> Tipos de disparadores y cómo se combinan.

> [card] [Mensajes in-app HTML](https://documentation.onesignal.com/docs/es/design-your-in-app-message-with-html.md)
>
> Diseña mensajes con tu propio HTML.

> [card] [API de JavaScript in-app](https://documentation.onesignal.com/docs/es/in-app-message-api.md)
>
> Todos los métodos de `OneSignalIamApi`.


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