--- title: "Notificações push para o seu app: uma API, uma plataforma" description: "Envie notificações push aos usuários do seu app com uma única API REST, por ID de usuário, token, tópico ou segmento, e reforce com SMS ou WhatsApp." canonical: "https://omnichannels.ai/pt/channels/push-notifications/" language: "pt" updated: "2026-11-04" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" --- # Notificações push para o seu app: uma API, uma plataforma Canonical: https://omnichannels.ai/pt/channels/push-notifications/ Language: pt Publisher: OmniChannels.ai by BroadNet Technologies 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. **Resposta curta:** 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? | 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. | | WhatsApp | 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 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. ## Fontes oficiais - [Firebase Cloud Messaging — Firebase](https://firebase.google.com/docs/cloud-messaging) - [User Notifications — Apple Developer](https://developer.apple.com/documentation/usernotifications) Atualizado em: 2026-11-04