API do OneSignal: o que dá para fazer e como usar com agentes de IA
A API do OneSignal permite enviar notificações push, e-mails, SMS e mensagens in-app, além de gerenciar usuários, segmentos e templates. É usada por apps, e-commerces e produtos digitais que fazem engajamento e reativação. O acesso é feito com a chave de API do app no OneSignal.
Os grandes recursos da API, em português claro.
Envio de push, e-mail, SMS e in-app para usuários ou segmentos.
Criação e uso de segmentos por comportamento ou atributos.
Gestão de usuários, tags e canais em que cada um está inscrito.
Modelos reutilizáveis de mensagem.
Entregas, aberturas e cliques de cada mensagem.
Como se acessa a API do OneSignal.
- Com credencial da sua empresaUsa a chave de API do app (REST API key) e o identificador do app, enviados nas requisições; há também chaves de nível de organização.
- Documentação oficialdocumentation.onesignal.com
- Envios em massa devem ter aprovação e limite de volume.
- Respeite consentimento e opção de descadastro (LGPD).
- Separe apps de teste e de produção.
- api onesignal
- onesignal api
- onesignal api push
- onesignal rest api key
- api do onesignal enviar notificação
- integração onesignal api
O que um agente do iTeam faz com a API do OneSignal.
O agente propõe o texto e o segmento de usuários inativos, mostra o volume e dispara após aprovação.
Quando o pedido muda de status, o agente envia a notificação ao usuário certo com o template padrão.
O agente compara aberturas e cliques das últimas campanhas e indica qual horário e mensagem funcionaram melhor.
O agente atualiza tags dos usuários com dados do CRM, como plano ou estágio, para segmentar melhor.
Da credencial ao agente trabalhando, com aprovação.
Copiar a chave do app
No painel do OneSignal, copie o identificador e a chave de API do app correto.
Guardar no cofre do iTeam
Cadastre a chave e defina limites: segmentos permitidos, volume máximo e horários de envio.
Enviar para teste primeiro
Dispare para um segmento interno de teste e só depois libere envios reais com aprovação.
Dúvidas sobre a API do OneSignal.
A API do OneSignal é gratuita?
O OneSignal tem plano gratuito com limites, e a API está disponível; volumes maiores e recursos avançados entram nos planos pagos.
Preciso programar para usar a API do OneSignal com o iTeam?
Não necessariamente. O time de implantação do iTeam configura envios e regras a partir da documentação do OneSignal.
O agente pode criar segmentos?
Pode, se tiver permissão. Muitas empresas preferem que o agente use segmentos já aprovados pelo marketing.
Quais credenciais a API do OneSignal exige?
A API do OneSignal usa a chave de API REST do app junto com o identificador do app. Há também chaves em nível de organização. Cada app tem a sua chave. Como ela permite disparar mensagens, guarde-a como segredo e crie uma chave só para o agente, nunca compartilhada com outros sistemas.
Dá para testar envios do OneSignal sem atingir usuários reais?
Dá, separando os apps: mantenha um app de teste e outro de produção, cada um com a própria chave. No de teste, cadastre apenas aparelhos e e-mails da equipe. Assim o agente pode errar o texto ou o segmento sem que nenhum cliente receba. Confira na documentação oficial se há recursos de envio de teste para o seu canal.
O que significa o erro 429 da API do OneSignal e como o agente deve reagir?
O 429 indica que o limite de chamadas foi excedido, e a resposta traz o cabeçalho Retry-After com o tempo de espera. Segundo a documentação, os limites variam entre plano gratuito e pago e por tipo de endpoint. Ao tentar de novo, o agente reutiliza a mesma chave de idempotência, para não duplicar notificação.
Que tarefas um agente executa no OneSignal?
Pela API ele cria e atualiza segmentos, mantém templates, envia mensagens, gerencia usuários e assinaturas e lê os resultados de envio. Na prática: montar o segmento de quem abandonou o carrinho, redigir três versões de um push para revisão ou resumir a entrega da última campanha. O disparo final em volume fica sob aprovação.
O agente escolhe sozinho entre push, e-mail e SMS no OneSignal?
O OneSignal envia push, e-mail, SMS e mensagens in-app, mas quem define a regra de canal é a empresa, considerando o consentimento de cada pessoa. Um agente pode seguir a regra, por exemplo push primeiro e e-mail para quem desativou, sem inventar canal novo. O iTeam também tem WhatsApp e e-mail como canais, definidos por quem configura o agente.
Quais cuidados de LGPD valem para notificações enviadas pelo OneSignal?
Respeite o consentimento e a opção de descadastro de cada pessoa, e não use o agente para reimpactar quem pediu para sair. Guarde o registro de base legal do contato e evite segmentos baseados em dados sensíveis. O volume também importa: envios em massa devem ter limite e aprovação antes do disparo.
Um agente poderia disparar notificação em massa por engano?
Poderia, se tivesse permissão irrestrita de envio. Por isso o desenho precisa de limite de volume e de aprovação humana antes de qualquer disparo para segmento grande. Um segmento errado vira reclamação e descadastros. No iTeam, o teto de gasto e a aprovação por alçada seguram esse tipo de ação, e a trilha mostra quem autorizou.
O que pesa no custo de usar a API do OneSignal com agentes de IA?
Pesam o plano do OneSignal, que muda os limites de chamadas, e o volume de mensagens enviadas. Pesa também o uso do modelo de IA na criação dos textos. Valores você vê na página de preços do OneSignal; não os cito porque mudam. Ligar o OneSignal ao CRM para decidir quem recebe o quê é esforço de integração. O iTeam fecha custo e meta de cada etapa com preço fixo.
