Limites

Referência rápida do que cada campo da AI Web Push API aceita. Os valores abaixo são os mesmos que a API valida; fora deles a resposta é 400 com a mensagem correspondente em Erros.

POST /campaign/create

Campo	Regra
title	Obrigatório, de 3 a 100 caracteres
body	Obrigatório, de 3 a 300 caracteres
link	Obrigatório
topics / countries	Pelo menos um dos dois, com ao menos um valor; use os nomes como GET /topics e GET /countries devolvem (minúsculas, países com country__)
callToAction	Opcional, até 20 caracteres
icon / image	Opcionais; se enviados, precisam começar com https://
status	published, draft ou failed
scheduleMode	now ou scheduled
scheduleDate	Obrigatório quando scheduleMode é scheduled; data UTC
ttl	Número inteiro até 2419200 segundos (28 dias); o padrão é 2419200 e enviar 0 também resulta no padrão
utmSource / utmMedium / utmCampaign	Opcionais; são anexados ao link

POST /campaigns

Campo	Regra
limit	De 1 a 60; o padrão é 10 e valores acima de 60 viram 60
startDate / endDate	Datas UTC; startDate não pode ser maior que endDate
dateField	createdAt ou scheduleDate; padrão createdAt
status	draft, scheduled, sent ou failed
cursor	Use exatamente o valor devolvido em nextCursor

Dicas para a notificação render mais

Os limites acima são o máximo aceito, não o tamanho ideal. Navegadores e sistemas cortam textos longos, então:

• Título curto. É o que aparece inteiro na maioria dos dispositivos; coloque a informação principal no começo.
• Texto direto. O body aceita 300 caracteres, mas muitos dispositivos mostram bem menos antes de truncar.
• Botão de até 20 caracteres (callToAction): um verbo e um objeto, como Ver ofertas.
• Ícone quadrado em HTTPS, 192×192 recomendado. Imagem grande (image) opcional, também em HTTPS.
• TTL coerente com a oferta. Se a promoção acaba em 24 h, ttl: 86400 evita entregar a notificação depois do prazo a quem estava offline.
• UTMs para ver o tráfego da campanha no seu analytics: utmSource, utmMedium e utmCampaign são anexados ao link.