Inicio rápido - Notifique

Desde cero hasta su primer envío en la cola en unos pocos pasos: Push App → dispositivo registrado → enviar con ID de dispositivo en to.

En resumen

Crear una aplicación Push, Web VAPID se genera automáticamente al crearla.
Registrar cada dispositivo cuando el usuario acepte en el navegador y guardar el ID del dispositivo.
Enviar notificaciones pasando los ID del dispositivo en to (hasta 100 por llamada).

Contexto: Introducción. Alcances: Alcances de clave API.

Antes de empezar

Clave con push:apps:manage, push:devices:register y push:send (o alcance de administrador en la prueba)
Plan con push habilitado
Autenticación: Authorization: Bearer sk_live_... o x-api-key
URL base: https://api.notifique.dev, use sk_test_... en Sandbox al comenzar

Una clave con pushAppIds en el panel solo envía a dispositivos desde esas aplicaciones. Otra aplicación → 403 (PUSH_APP_NOT_ALLOWED).

1. Crear aplicación push

Dos caminos, elige el que mejor se adapte a tu integración:

1A, a través del tablero

Presione → Nueva aplicación
Ingrese el producto nombre
Tenga en cuenta la aplicación id y la clave pública VAPID (para el sitio)

1B, a través de API

Respuesta esperada: 200 con VAPID generado automáticamente: Scope: push:apps:manage. Save the id and use vapidPublicKey on the front end to register the subscription.

Custom VAPID (optional)

To use your own key pair instead of the generated one: The private key stays on Notifique; the public key goes on your site.

2. Register device

When the user grants permission in the browser, send the subscription to your backend and register via API: Expected response: 200: Guarda el dispositivo id, que va en to al enviar. Alcance: push:devices:register.

El registro público (sin clave API) también existe para los flujos de front-end, solo appId + subscription. Con una clave, se requiere el alcance anterior.

3. Enviar notificación

Hasta 100 IDs de dispositivo por llamada. Al menos title o body en payload es obligatorio. Cada envío consume 1 crédito.

POST /v1/push/messages
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx

{
  "to": ["clxxdevice..."],
  "type": "push",
  "payload": {
    "title": "¡Hola!",
    "body": "Tienes un nuevo mensaje.",
    "url": "https://tusitio.com/notificaciones",
    "icon": "https://tusitio.com/icon.png"
  },
  "options": { "priority": "normal" }
}

Respuesta esperada: 202

{
  "success": true,
  "data": {
    "status": "QUEUED",
    "count": 1,
    "messageIds": ["clpush1..."],
    "pushIds": ["clpush1..."]
  }
}

messageIds es el campo canónico; pushIds es alias de compatibilidad. Alcance: push:send.

Enviar con plantilla

{
  "to": ["clxxdevice..."],
  "type": "template",
  "payload": {
    "templateId": "ID_DE_LA_PLANTILLA",
    "variables": { "name": "María" }
  }
}

Programar, incluye schedule.sendAt (ISO 8601) en el body. Webhook solo de este lote: options.webhook con url y secret.

4. Query, list, and cancel

List sends Filtros opcionales: status, appId. Alcance: push:read. Ver un envío Cancel scheduled (only SCHEDULED status): El crédito programado regresa al espacio de trabajo.

5. Evite duplicados

Idempotency-Key encabezado en el envío POST. Las repeticiones dentro de las 24 h no crean impulsos duplicados. Ver Seguridad y confiabilidad.

6. Webhooks (opcional)

Configure push.sent, push.delivered, push.clicked, push.failed y push.cancelled para realizar un seguimiento sin sondeo. Guía: Eventos de webhook.

Todos los tipos de envío

En la referencia de la API (pestaña Push), abra Enviar notificación push y elija un ejemplo en el playground: Push completo, Plantilla, Programado.

Próximos pasos

Introducción: cuándo usar y estado del ciclo de vida
Scopes: permisos clave
Eventos de webhook: estado en tiempo real
Respuestas de error: códigos HTTP y code

​En resumen

​Antes de empezar

​1. Crear aplicación push

​1A, a través del tablero

​1B, a través de API

​Custom VAPID (optional)

​2. Register device

​3. Enviar notificación

​Enviar con plantilla

​4. Query, list, and cancel

​5. Evite duplicados

​6. Webhooks (opcional)

​Todos los tipos de envío

​Próximos pasos

En resumen

Antes de empezar

1. Crear aplicación push

1A, a través del tablero

1B, a través de API

Custom VAPID (optional)

2. Register device

3. Enviar notificación

Enviar con plantilla

4. Query, list, and cancel

5. Evite duplicados

6. Webhooks (opcional)

Todos los tipos de envío

Próximos pasos