Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Com base no modelo de publicação/assinatura, as mensagens de tópicos do FCM permitem enviar uma mensagem
a vários dispositivos que se inscreveram em determinado tópico. Você escreve as mensagens de tópicos conforme
necessário e o FCM processa, de maneira confiável, o encaminhamento e a entrega delas aos dispositivos
certos.
Por exemplo, os usuários de um app de previsão de marés
podem se inscrever em um tópico de "alertas de correntes de maré" e receber
notificações das melhores condições de pesca em água salgada em áreas específicas. Os usuários de um app sobre esportes
podem se inscrever para receber atualizações automáticas de placares de jogos em tempo real dos times que
mais gostam.
Alguns lembretes sobre os tópicos:
As mensagens de tópicos são mais adequadas a conteúdo de clima ou outras informações
disponibilizadas publicamente.
As mensagens de tópicos são otimizadas para capacidade, não para latência. Para enviar
mensagens com rapidez e segurança para apenas um dispositivo ou pequenos grupos de dispositivos,
elas devem ser direcionadas para tokens de registro
em vez de tópicos.
Se for necessário enviar mensagens a vários dispositivos por usuário, considere o envio de
mensagens para grupos de dispositivos
para esses casos de uso.
As mensagens de tópicos permitem um número ilimitado de assinaturas para cada tópico. No entanto, o FCM
impõe limites nestas áreas:
Uma instância de app pode estar inscrita em no máximo 2.000 tópicos.
Se você estiver usando a importação em lote
para inscrever instâncias de apps, cada solicitação estará limitada a 1.000 instâncias.
A frequência de novas assinaturas é limitada por projeto. Se muitas
solicitações de assinatura forem enviadas em um curto período, você receberá
uma resposta 429 RESOURCE_EXHAUSTED ("cota excedida") dos servidores do FCM. Tente novamente
com espera exponencial.
Inscrever o app cliente em um tópico
Os apps cliente podem ser inscritos em qualquer tópico atual ou podem criar um novo
tópico. Quando um app cliente for inscrito em um novo nome de tópico que ainda
não existe no seu projeto do Firebase, um novo tópico com esse nome será
criado no FCM e qualquer cliente poderá se inscrever nele posteriormente.
Para se inscrever em um tópico, chame subscribeToTopic() com o nome do tópico. Esse método
retorna um Future, que resolve quando a assinatura é bem-sucedida:
Para cancelar a inscrição, chame unsubscribeFromTopic() com o nome do tópico.
subscribeToTopic() e unsubscribeFromTopic() não são compatíveis com clientes da Web. Para saber como gerenciar assinaturas para usuários da Web, consulte Enviar mensagens para tópicos da Web/JavaScript.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-05 UTC."],[],[],null,["\u003cbr /\u003e\n\nBased on the publish/subscribe model, FCM topic messaging allows you to send a message\nto multiple devices that have opted in to a particular topic. You compose topic messages as\nneeded, and FCM handles routing and delivering the message reliably to the right\ndevices.\n\nFor example, users of a local tide\nforecasting app could opt in to a \"tidal currents alerts\" topic and receive\nnotifications of optimal saltwater fishing conditions in specified areas. Users of a sports app\ncould subscribe to automatic updates in live game scores for their favorite\nteams.\n\nSome things to keep in mind about topics:\n\n- Topic messaging is best suited for content such as weather, or other publicly\n available information.\n\n- Topic messages are **optimized for throughput rather than latency** . For fast,\n secure delivery to single devices or small groups of devices,\n [target messages to registration tokens](/docs/cloud-messaging/send-message#send_messages_to_specific_devices),\n not topics.\n\n- If you need to send messages to multiple devices *per user* , consider\n [device group messaging](/docs/cloud-messaging/send-message#send_messages_to_device_groups)\n for those use cases.\n\n- Topic messaging supports unlimited subscriptions for each topic. However, FCM\n enforces limits in these areas:\n\n - One app instance can be subscribed to no more than 2000 topics.\n - If you are using [batch import](https://developers.google.com/instance-id/reference/server#manage_relationship_maps_for_multiple_app_instances) to subscribe app instances, each request is limited to 1000 app instances.\n - The frequency of new subscriptions is rate-limited per project. If you send too many subscription requests in a short period of time, FCM servers will respond with a `429 RESOURCE_EXHAUSTED` (\"quota exceeded\") response. Retry with exponential backoff.\n\nSubscribe the client app to a topic\n\nClient apps can subscribe to any existing topic, or they can create a new\ntopic. When a client app subscribes to a new topic name (one that does\nnot already exist for your Firebase project), a new topic of that name is\ncreated in FCM and any client can subsequently subscribe to it.\n\nTo subscribe to a topic, call `subscribeToTopic()` with the topic name. This method\nreturns a `Future`, which resolves when the subscription succeeded: \n\n await FirebaseMessaging.instance.subscribeToTopic(\"topic\");\n\nTo unsubscribe, call `unsubscribeFromTopic()` with the topic name.\n\n`subscribeToTopic()` and `unsubscribeFromTopic()` are not supported for web\nclients. To learn how to manage subscriptions for web users, see\n[Send messages to topics on Web/JavaScript](https://firebase.google.com/docs/cloud-messaging/js/topic-messaging).\n\nNext steps\n\n- Learn how to [send topic messages](/docs/cloud-messaging/send-message#send-messages-to-topics).\n- Learn how to [Manage topic subscriptions on the server](/docs/cloud-messaging/manage-topics)."]]
