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

# Introducción

> Envíe notificaciones automáticas desde el panel o API: cree aplicaciones, registre dispositivos y realice un seguimiento de la entrega y los clics.

<Tip>
  Push es el **toque en el hombro del usuario**: lo devuelve a su sitio o aplicación sin SMS ni correo electrónico, ideal para usuarios que **ya aceptaron** notificaciones.
</Tip>

## ¿Qué es Push on Notifique?

Es el canal para **alertar en el navegador o la aplicación** para los usuarios que otorgaron permiso. Organiza **Push App**, **dispositivos** y **envíos** en el mismo espacio de trabajo; su integración almacena **ID de dispositivo** (y puede vincularlos a un **contacto CRM**) y los envía cuando es necesario.

Puede:

* **Crear aplicaciones push** con VAPID Web (automático), **FCM (Android)** y **APNs (iOS)**
* **Registrar dispositivos** en web (script) o mobile (token FCM/APNs), con `contactId` opcional
* **Enviar** a device IDs o `toContacts` (todos los dispositivos del contacto)
* **Rich Web Push**: `image`, `badge`, `tag`, `actions`, `requireInteraction`, etc.
* **Programar** y **cancelar** envíos futuros
* **Seguimiento** de entrega y clics vía API o [webhook](/es/push-api/como-funciona/eventos-do-webhooks)
* **BYOK**: Firebase/APNs en [Integraciones](/es/byok/index) (como Resend/SES en email)

Piense en un recordatorio en la pantalla del teléfono: breve, directo, para personas que ya dijeron “sí” a las notificaciones.

<Note>
  A diferencia de WhatsApp, push **no utiliza una instancia de canal**. Solo necesita una aplicación Push, dispositivos registrados y una clave API con los alcances adecuados.
</Note>

<Info>
  El sonido personalizado funciona en **mobile** (APNs/FCM). En navegadores modernos, el sonido custom en Web Push es limitado o no está disponible.
</Info>

## ¿Cuándo usarlo?

Funciona muy bien para **carrito abandonado**, **actualizaciones rápidas** y **traer de vuelta a los usuarios**. Si nunca abrieron el sitio o le negaron el permiso, utilice [email](/es/emails-api/como-funciona/introducao) o [SMS](/es/sms-api/como-funciona/introducao). Contenido HTML largo → correo electrónico.

## Cómo funciona en la práctica

1. **Cree una aplicación Push**, Web VAPID se genera automáticamente (o configure sus propias claves más adelante)
2. **Registrar dispositivos** cuando el navegador entregue la suscripción a su backend, guarde el **ID del dispositivo**
3. **Enviar** con `to` (conjunto de ID de dispositivos), **título** y/o **cuerpo**
4. La plataforma **pone en cola, envía y actualiza el estado**; su backend recibe alertas si configuró webhooks

<Info>
  Each **API Key** belongs to **one** workspace. On v1 **do not send** `x-workspace-id`.
</Info>

## Enviar ciclo de vida

Después de `POST`, la notificación pasa por `QUEUED` o `SCHEDULED`, luego `SENT`, `DELIVERED` o `CLICKED` según informa el dispositivo. Los fracasos se convierten en `FAILED`; los horarios cancelados se convierten en `CANCELLED`.

**La entrega y los clics** pueden ser informados por el **trabajador de servicio** del cliente. Los webhooks notifican a su backend (`push.delivered`, `push.clicked`).

## Qué puedes hacer

* **Enviar** de 1 a 100 ID de dispositivo por llamada (1 crédito por notificación)
* **Horario** con `schedule.sendAt`
* Historial de **consultas** o un envío por identificación
* **Cancelar** envíos programados mientras el estado sea **`SCHEDULED`**
* **Idempotencia** con encabezado `Idempotency-Key`
* **Prioridad** en `options.priority`: `high`, `normal`, `low`
* **Restringir por aplicación** con `pushAppIds` en la tecla, fuera de la lista → **403** (`PUSH_APP_NOT_ALLOWED`)

Detalles de campo y error: **Referencia de API** en la pestaña Push (barra lateral).

## Después de tu primer envío

* **Seguimiento** vía [webhooks](/es/push-api/como-funciona/eventos-do-webhooks) (`push.sent`, `push.delivered`, `push.clicked`, `push.failed`)
* **Elimina dispositivos** con suscripciones no válidas cuando recibas `push.failed`
* **Prueba** en [Sandbox](/es/guides/sandbox/index) con `sk_test_...` antes de la producción

## Próximos pasos

* [Integrar apps](/es/push-api/integracao/index): Android, iOS, Flutter, React Native y Web
* [Inicio rápido](/es/push-api/como-funciona/quick-start): aplicación → dispositivo → enviar (enfoque Web)
* [Ámbitos de clave API](/es/push-api/como-funciona/escopos-da-api-key): permisos
* [Eventos de webhook](/es/push-api/como-funciona/eventos-do-webhooks): qué llega a tu URL
* [Comenzar](/es/guides/introducao/comece-aqui): integración general de la plataforma