send¶

Envía una notificación push a uno o varios usuarios (por userId) usando los tokens almacenados en user_device_tokens.

Este endpoint está pensado para uso interno (otro backend, n8n, cron, etc.) y se protege con x-api-key.

Base v2: /api/v2

Seguridad¶

Header requerido:

x-api-key: <PUSH_NOTIFICATIONS_API_KEY>

La variable de entorno usada por backend es: - PUSH_NOTIFICATIONS_API_KEY

Request¶

URL¶

POST /api/v2/push-notifications/send

Headers¶

Content-Type: application/json
x-api-key: <PUSH_NOTIFICATIONS_API_KEY>

Body¶

{
  "userIds": [123, 456],
  "title": "Título",
  "body": "Mensaje de la notificación",
  "priority": "high",
  "channelId": "default",
  "platform": "android",
  "data": {
    "type": "example",
    "id": 999
  }
}

Campos: - userIds (requerido): array de userId (números). - body (requerido): mensaje. - title (opcional): título. - priority (opcional): default | normal | high. - channelId (opcional): canal Android (Expo). - platform (opcional): ios | android para filtrar tokens por plataforma. - data (opcional): objeto para deep-linking.

Response¶

200 OK¶

{
  "success": true,
  "requestedUserIds": [123, 456],
  "tokensCount": 3,
  "successCount": 3,
  "errorCount": 0,
  "errors": []
}

Notas¶

El backend obtiene los tokens desde user_device_tokens.
Si no encuentra tokens para esos usuarios, responde success: true con tokensCount: 0.