Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Firebase Cloud Messaging
plat_ios
plat_android
plat_web
plat_flutter
plat_cpp
plat_unity
O Firebase Cloud Messaging (FCM) é uma solução de mensagens entre plataformas que permite a entrega confiável de
mensagens.
Usando o
FCM, você pode notificar um app cliente de que novos e-mails ou outros dados estão disponíveis para sincronização. Você pode enviar mensagens de notificação para promover novas interações e a retenção de
usuários. Para casos de uso como mensagens instantâneas, uma mensagem pode transferir um
payload de até 4096 bytes para um app cliente.
Pronto para começar? Escolha sua plataforma:
iOS+
Android
Web
Flutter
Unity
C++
Principais recursos
Enviar mensagens de notificação ou mensagens de dados |
Enviar mensagens de notificação que são exibidas para o usuário.
Ou enviar mensagens de dados e determinar o que acontece no código do aplicativo. Consulte Tipos de mensagens. |
Segmentação versátil de mensagens |
Distribua mensagens ao seu app cliente de três maneiras: para dispositivos únicos, para grupos de dispositivos ou para dispositivos inscritos em tópicos. |
Como funciona?
Uma implementação do FCM inclui dois componentes principais para envio e recebimento:
- um ambiente confiável, como o Cloud Functions for Firebase ou um servidor de apps
usado para criar, segmentar e enviar mensagens.
- um aplicativo cliente Apple, Android ou da Web (JavaScript) que recebe
mensagens pelo serviço de transporte específico da plataforma.
Você pode enviar mensagens pelo
Firebase Admin SDK ou o
protocolo do servidor FCM.
É possível usar o
Editor do Notificações para testar e enviar mensagens de marketing ou engajamento
usando segmentação e análises incorporadas e avançadas ou personalizar
segmentos importados.
Consulte a visão geral da
arquitetura para mais detalhes e informações importantes
sobre os componentes do FCM.
Caminho de implementação
|
Configurar o SDK do FCM |
Configure o Firebase e o FCM no seu app de acordo com as
instruções de instalação da sua plataforma. |
|
Desenvolver seu app cliente |
Adicione o gerenciamento de mensagens, a lógica de assinatura de tópicos ou outros recursos
opcionais ao app cliente. Durante o desenvolvimento, é possível enviar
mensagens de teste do
Editor do Notificações com facilidade. |
|
Desenvolver seu app server |
Decida se quer usar o
Firebase Admin SDK ou o protocolo do servidor para criar a lógica
de envio: lógica de autenticação, criar solicitações de envio, lidar com respostas e
assim por diante. Em seguida, implante a lógica no seu ambiente confiável. |
Próximas etapas
Execute a amostra do guia de início rápido do Android ou do iOS (links em inglês). Com esses exemplos, você pode executar e revisar o código para enviar uma
mensagem de teste a um único dispositivo usando o Console do Firebase.
Saiba mais sobre o FCM na
visão geral da arquitetura,
guias para os principais conceitos de FCM
e guias de práticas recomendadas para enviar mensagens em grande escala
e gerenciar tokens de registro.
Veja os tutoriais para Android
ou iOS.
Adicione Firebase Cloud Messaging ao
Android,
Apple,
ou app da Web.
Configure seu ambiente confiável onde você criará e enviará solicitações de mensagens.
Você pode escrever a lógica de envio usando o
SDK Admin e
implantar prontamente esse código no Cloud Functions for Firebase ou em outros ambientes de nuvem gerenciados pelo Google.
Como opção, é possível executar o desenvolvimento do servidor usando o
protocolo do servidor do FCM.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-18 UTC.
[null,null,["Última atualização 2025-08-18 UTC."],[],[],null,["Firebase Cloud Messaging \nplat_ios plat_android plat_web plat_flutter plat_cpp plat_unity \nFirebase Cloud Messaging (FCM) is a cross-platform messaging solution that lets you reliably send\nmessages. \nUsing FCM, you can notify a client app that new email or other data is available to sync. You can send notification messages to drive user re-engagement and retention. For use cases such as instant messaging, a message can transfer a payload of up to 4096 bytes to a client app.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nReady to get started? Choose your platform:\n\n[iOS+](/docs/cloud-messaging/ios/client)\n[Android](/docs/cloud-messaging/android/client)\n[Web](/docs/cloud-messaging/js/client)\n[Flutter](/docs/cloud-messaging/flutter/client)\n\n[Unity](/docs/cloud-messaging/unity/client)\n[C++](/docs/cloud-messaging/cpp/client)\n\nKey capabilities\n\n|---------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Send notification messages or data messages | Send notification messages that are displayed to your user. Or send data messages and determine completely what happens in your application code. See [Message types](/docs/cloud-messaging/concept-options#notifications_and_data_messages). |\n| Versatile message targeting | Distribute messages to your client app in any of 3 ways---to single devices, to groups of devices, or to devices subscribed to topics. |\n\nHow does it work?\n\n\u003cbr /\u003e\n\nAn FCM implementation includes two main components for\nsending and receiving:\n\n1. A trusted environment such as Cloud Functions for Firebase or an app server on which to build, target, and send messages.\n2. An Apple, Android, or web (JavaScript) client app that receives messages via the corresponding platform-specific transport service.\n\n\u003cbr /\u003e\n\nYou can send messages via\nthe [Firebase Admin SDK](/docs/cloud-messaging/server#firebase-admin-sdk-for-fcm) or the\n[FCM server protocol](/docs/cloud-messaging/server#choose).\nYou can use [the Notifications composer](//console.firebase.google.com/project/_/notification) for testing and to send marketing or engagement\nmessages using powerful built-in targeting and analytics or custom\n[imported segments](/docs/projects/import-segments).\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nSee the [architectural\noverview](/docs/cloud-messaging/fcm-architecture) for more detail and important\ninformation about the components of FCM.\n\n\u003cbr /\u003e\n\nImplementation path\n\n|---|-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| | Set up the FCM SDK | Set up Firebase and FCM on your app according to the setup instructions for your platform. |\n| | Develop your client app | Add message handling, topic subscription logic, or other optional features to your client app. During the development, you can easily send test messages from [the Notifications composer](//console.firebase.google.com/project/_/notification). |\n| | Develop your app server | Decide whether you want to use the Firebase Admin SDK or the server protocol to create your sending logic---logic to authenticate, build send requests, handle responses, and so on. Then build out the logic in your trusted environment. |\n\nNext steps\n\n- Run the [Android](https://github.com/firebase/quickstart-android/tree/master/messaging)\n or [iOS](https://github.com/firebase/quickstart-ios/tree/master/messaging/)\n Quickstart sample. These samples let you run and review code to send a test\n message to a single device using the Firebase console.\n\n- Learn more about FCM from the\n [architecture overview](/docs/cloud-messaging/fcm-architecture),\n guides to key [FCM concepts](/docs/cloud-messaging/concept-options),\n and best practices guides for [sending messages at scale](/docs/cloud-messaging/scale-fcm)\n and [managing registration tokens](/docs/cloud-messaging/manage-tokens).\n\n- Try the tutorials for [Android](/docs/cloud-messaging/android/first-message)\n or [iOS](/docs/cloud-messaging/ios/first-message).\n\n- Add Firebase Cloud Messaging to your\n [Android](/docs/cloud-messaging/android/client),\n [Apple](/docs/cloud-messaging/ios/client),\n or [Web](/docs/cloud-messaging/js/client) app.\n\n- Set up your trusted environment where you'll build and send message requests.\n You can write sending logic using the\n [Admin SDK](/docs/cloud-messaging/server#firebase-admin-sdk-for-fcm), and\n readily deploy that code on Cloud Functions for Firebase or other cloud\n environments managed by Google.\n Alternatively, you can perform server development using the\n [FCM server protocol](/docs/cloud-messaging/server#choose)."]]