Skip to main content
Cada escopo é uma porta na sua chave: app, registro de device, envio ou leitura, abra só o necessário.
Cada escopo libera um tipo de operação no Push. Use só o que sua integração precisa.

​
Como enviar a chave

Recomendado
Alternativo
A API Key pertence a um workspace. Você não acessa outro workspace com a mesma chave.

​
Combinações comuns

Só enviar

push:send

Enviar e consultar

push:send, push:read

Setup completo Web

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

Só registrar devices

push:devices:register
Lista de escopos vazia na criação = acesso ADMIN. Em produção, restrinja sempre.

​
Escopos disponíveis

Listar e consultar Push Apps do workspace.
Criar, atualizar (VAPID, FCM, APNs conforme produto) e remover Push Apps.
Registrar dispositivo ou subscription. Também usado para remover dispositivo.
Enviar notificação imediata ou agendada para até 100 device IDs por requisição.
  • Listar e consultar envios
  • Listar e consultar dispositivos
  • Cancelar push agendado (status SCHEDULED)

​
Limite por app

Se a chave tiver pushAppIds configurados, ela só envia para dispositivos daqueles apps. Device de app fora da lista → 403 (PUSH_APP_NOT_ALLOWED). Lista vazia = qualquer app do workspace.

​
Erros comuns

Confira Authorization: Bearer sk_... e se a chave não foi apagada no painel.
Verifique escopo da operação, pushAppIds na chave e origem permitida no app (ORIGIN_NOT_ALLOWED no registro público).
Envio exige crédito (PLAN_LIMIT_CREDITS). Agendamento depende do plano (PLAN_LIMIT_SCHEDULING).

​
Próximos passos