Notificações push para o seu app: uma API, uma plataforma
Envie notificações push aos usuários do seu app pela mesma API REST que você usa para SMS, WhatsApp e RCS e alcance por outro canal quem ainda não abriu o app.
curl -X POST https://api.broadnet.me/push/message/send \
-H "Authorization: Bearer $BROADNET_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"userRefs": ["user-10293"],
"title": "Your order has shipped",
"body": "Tap to track your parcel.",
"deepLink": "https://example.com/orders/8842",
"category": "UTILITY",
"priority": "HIGH",
"ttl": 3600
}'Uma requisição de notificação push para a API da OmniChannels.ai. Os valores são dados de exemplo.
Resposta curta
Atualizado em
A OmniChannels.ai é um serviço e uma API de notificações push para apps móveis. Você chama POST /push/message/send com título, texto e público: IDs de usuário, tokens de dispositivo, tópicos ou um segmento. As notificações podem levar imagens, deep links e botões de ação, usar modelos salvos, ser agendadas e ser validadas antes com um teste sem envio. Nossa equipe conecta o seu projeto do Firebase Cloud Messaging e, no iOS, as suas credenciais do APNs durante a implantação.
O que a API de notificações push faz
Segmentação por usuário, token, tópico ou segmento
Endereçe os envios aos seus próprios IDs de usuário (userRefs), a tokens de dispositivo FCM específicos, a tópicos do FCM ou a um segmento definido por país, cidade, idioma e tags.
Notificações enriquecidas
Adicione uma imagem HTTPS, um deep link aberto ao tocar e botões de ação, como Confirmar ou Reagendar.
Modelos salvos
Crie, visualize, teste e publique modelos com histórico de versões e envie-os por templateId com as suas próprias variáveis.
Prioridade, tempo de vida e agendamento
Marque como alta prioridade as mensagens urgentes, defina um tempo de vida, substitua notificações antigas com uma chave de agrupamento ou agende o envio.
Teste sem envio antes de enviar
Defina dryRun como true para validar um payload de ponta a ponta sem entregar nada a usuários reais.
Controle de lotes
Liste os lotes, consulte os detalhes e pause, retome ou cancele um lote pelos endpoints de lotes.
Notificações por localização
Geofences podem disparar notificações conforme a localização. Nossa equipe ativa o geofencing para o seu app sob solicitação.
Status de entrega por webhook
Acompanhe os status de entrega na URL de webhook configurada na sua conta, do mesmo modo que nos demais canais.
Push, SMS ou WhatsApp: qual usar?
O push alcança quem tem o seu app instalado. O SMS e o WhatsApp alcançam um número de telefone. A maioria das empresas usa os três, nesta ordem de preferência para cada mensagem.
| Canal | Alcança | Ideal para | Observação |
|---|---|---|---|
| Notificação push | Usuários que instalaram o seu app e registraram um dispositivo | Atividade no app: status de pedidos, lembretes, ofertas dentro do app, reengajamento | Use como primeiro passo quando o usuário está no seu app. |
| Clientes com opt-in, por número de telefone | Conversas ricas, modelos, atendimento e comprovantes | Use quando precisar de uma conversa ou de mídia. | |
| SMS | Qualquer número de celular | Códigos OTP, alertas urgentes e clientes sem o app ou o WhatsApp | Use como alternativa universal. |
Como começar a enviar notificações push
O push roda sobre o Firebase Cloud Messaging e, no iOS, sobre o APNs da Apple, por isso há antes uma breve etapa de implantação.
- 1
Conecte o seu app
Nossa equipe conecta o seu projeto do Firebase Cloud Messaging e, no iOS, as suas credenciais do APNs, e entrega o ID do seu app.
- 2
Registre os dispositivos nos seus IDs de usuário
O seu app registra cada dispositivo com o seu próprio identificador, o userRef, para que você envie para pessoas em vez de tokens.
- 3
Verifique um payload com um teste sem envio
Chame POST /push/message/send com dryRun definido como true e confirme que a requisição é válida antes de qualquer usuário real ver algo.
- 4
Envie ou agende
Envie para userRefs, tokens, tópicos ou um segmento, ou agende o envio. Salve as mensagens repetidas como modelos.
- 5
Adicione uma alternativa
Defina quais mensagens precisam de um segundo canal, por exemplo SMS para um OTP ou um aviso de entrega, e configure a ordem para cada caso de uso.
Quando o push é o canal certo?
Indicado quando
- Você tem um app móvel e quer alcançar os usuários instalados sem precisar dos números de telefone deles.
- As mensagens estão ligadas à atividade no app, como status de pedido, lembretes de consulta ou alertas da conta.
- Você quer uma única API e um único formato de webhook para push, SMS, WhatsApp e os demais canais.
- Você quer enviar pelo seu próprio ID de usuário em vez de gerenciar tokens de dispositivo.
Bom saber antes de começar
- O push só alcança quem instalou o seu app e permitiu as notificações.
- A API documentada cobre o push de apps móveis via FCM e APNs. Consulte a nossa equipe sobre qualquer outro caso antes de planejar em torno dele.
- Não dependa só do push para códigos OTP nem alertas críticos: adicione SMS ou voz como alternativa.
- O geofencing é ativado sob solicitação para o seu app.
Perguntas sobre o serviço de notificações push
O que é um serviço de notificações push?
Um serviço de notificações push entrega mensagens curtas dos seus servidores aos dispositivos dos usuários, mesmo com o app fechado. No Android a entrega passa pelo Firebase Cloud Messaging e no iOS pelo APNs da Apple. Um serviço como a OmniChannels.ai fica na frente dos dois e oferece uma única API.
Como funciona uma API de notificações push?
O seu app registra cada dispositivo com um token. O seu backend chama então a API com o público e o conteúdo, e o serviço entrega a notificação ao FCM ou ao APNs. Com a OmniChannels.ai você chama POST /push/message/send e pode endereçar usuários pelos seus próprios IDs.
Qual é a diferença entre notificações push e SMS?
O push alcança quem instalou o seu app e permitiu as notificações, e precisa de conexão de dados. O SMS alcança qualquer número de celular sem app. O push serve para novidades e engajamento no app. O SMS serve para códigos OTP, alertas urgentes e clientes sem o seu app.
Posso enviar uma notificação push para um segmento de usuários?
Sim. Além de IDs de usuário, tokens de dispositivo e tópicos, a API aceita um objeto de segmento com critérios como país, cidade, idioma e tags, junto com o ID do seu app. Você também pode agendar o envio e identificá-lo com o nome de uma campanha.
Posso testar uma notificação push antes de enviar?
Sim. Defina dryRun como true para validar a requisição sem entregar nada. Nos modelos, você pode visualizar com dados de exemplo e enviar um teste para o seu próprio dispositivo antes de publicar uma versão.
Posso adicionar imagens, links e botões?
Sim. As notificações podem incluir uma imagem HTTPS, um deep link aberto ao tocar, dados personalizados para o seu app e botões de ação, cada um com ID, título e ação. Você também pode enviar mensagens somente de dados e silenciosas.
E se o usuário não abriu o app ou desativou as notificações?
O push não consegue alcançá-lo. Para as mensagens importantes, configure uma alternativa em outro canal, como SMS ou WhatsApp. A ordem de alternativas é definida por caso de uso e os status de entrega chegam em um único formato de webhook.
Como eu começo?
Agende uma demonstração. Nossa equipe conecta o seu projeto do Firebase e as credenciais do APNs durante a implantação, entrega o ID do seu app e, depois, você já pode chamar a API com o seu token. A documentação para desenvolvedores lista todos os endpoints de push.
Guias sobre este tema
- OmnichannelEstratégia de fallback entre canais: WhatsApp, RCS e SMS12 min de leitura
- SMS e OTPWhatsApp, SMS ou RCS: qual canal usar para OTP e marketing?8 min de leitura
- IntegraçãoGuia de integração de API de mensagens: REST, SMPP e webhooks9 min de leitura
- ConformidadeOpt-in e consentimento em campanhas de WhatsApp, SMS e e-mail8 min de leitura
- OmnichannelO que é mensagem omnichannel? Arquitetura, exemplos e benefícios10 min de leitura
Conheça mais da plataforma
Adicione o push à sua pilha de mensagens
Conte-nos sobre o seu app. Conectaremos o FCM e o APNs e mostraremos o push ao lado do SMS e do WhatsApp.
Conte qual é sua stack e o que você quer conectar. Um engenheiro de soluções entrará em contato.