Skip to main content
Cada alcance es una puerta en su clave: aplicación, registro de dispositivo, envío o lectura. Abra solo lo que necesite.
Cada alcance desbloquea un tipo de operación Push. Use solo lo que su integración necesita.

​
Cómo enviar la clave

Recomendado
Alternativo
Cada clave API pertenece a un espacio de trabajo. No puede acceder a otro espacio de trabajo con la misma clave.

​
Combinaciones comunes

Solo enviar

push:send

Enviar y consultar

push:send, push:read

Setup web completo

push:apps:manage, push:devices:register, push:send, push:read

Solo registrar dispositivos

push:devices:register
Lista de alcances vacía al crear = acceso ADMIN (todo). En producción, restrinja siempre.

​
Alcances disponibles

Enumere y consulte aplicaciones Push en el espacio de trabajo.
Cree, actualice (VAPID, FCM, APNs según evolucione el producto) y elimine aplicaciones push.
Registre un dispositivo o una suscripción. También se utiliza para quitar un dispositivo.
Envíe notificaciones inmediatas o programadas a hasta 500 IDs de dispositivo por solicitud.
  • Listar y consultar envíos
  • Listar y consultar dispositivos
  • Cancelar push en cola o programado (estado QUEUED o SCHEDULED)

​
Límite por aplicación

Si la clave tiene configurada pushAppIds, solo puede enviar a dispositivos de esas aplicaciones. Dispositivo de otra aplicación → 403 (PUSH_APP_NOT_ALLOWED). Lista vacía = cualquier aplicación en el espacio de trabajo.

​
Errores comunes

Verifique Authorization: Bearer sk_... y que la clave no se eliminó en el panel.
Verifique el alcance de la operación, pushAppIds en la clave y el origen permitido en la aplicación (ORIGIN_NOT_ALLOWED en el registro público).
Créditos insuficientes (PLAN_LIMIT_CREDITS, INSUFFICIENT_CREDITS), plan expirado (WORKSPACE_BLOCKED) o límite de gasto de la clave (API_KEY_SPEND_LIMIT_EXCEEDED).
Alcance ausente, app fuera de pushAppIds (PUSH_APP_NOT_ALLOWED), horario silencioso (PUSH_QUIET_HOURS) o programación no permitida (PLAN_LIMIT_SCHEDULING).

​
Próximos pasos