Protocolo HTTP do Firebase Cloud Messaging

Este parâmetro especifica o destinatário de uma mensagem.

O valor pode ser o token de registro de um dispositivo, a chave de notificação de um grupo de dispositivos ou um único tópico (prefixado com /topics/). Para enviar a vários tópicos, use o parâmetro condition.

Este parâmetro especifica o destinatário de uma mensagem multicast, uma mensagem enviada a mais de um token de registro.

O valor deve ser uma matriz de tokens de registro para onde enviar a mensagem multicast. A matriz precisa conter pelo menos 1 e no máximo 1.000 tokens de registro. Para enviar uma mensagem a um único dispositivo, use o parâmetro to.

As mensagens multicast só são permitidas usando o formato HTTP JSON.

Este parâmetro especifica uma expressão lógica de condições que determinam o destino da mensagem.

Condição aceita: tópico, formatado como "'seuTópico' em tópicos". Esse valor não diferencia minúsculas de maiúsculas.

Operadores compatíveis: &&, ||. No máximo dois operadores são permitidos por mensagem de tópico.

Este parâmetro foi descontinuado. Use to para especificar destinatários da mensagem. Para mais informações sobre como enviar mensagens a vários dispositivos, consulte a documentação da sua plataforma.

Este parâmetro identifica um grupo de mensagens (por exemplo, com collapse_key: "Updates Available") que podem ser recolhidas, para que apenas a última seja enviada quando a entrega puder ser feita. O objetivo disso é evitar o envio de um número excessivo de mensagens iguais quando o dispositivo voltar a ficar on-line ou ativo.

Não há garantia da ordem em que as mensagens são enviadas.

No máximo quatro chaves de recolhimento diferentes são permitidas a qualquer momento. Isso significa que o FCM pode armazenar simultaneamente quatro mensagens diferentes por app cliente. Se você exceder esse limite, não há garantia de qual das quatro chaves recolhidas será mantida pelo FCM.

Define a prioridade da mensagem. Os valores válidos são "normal" e "high" (alta). Nas plataformas Apple, eles correspondem às prioridades 5 e 10 de APNs.

Por padrão, as mensagens de notificação são enviadas com prioridade alta e as mensagens de dados com prioridade normal. A prioridade normal otimiza o consumo de bateria do app cliente e deve ser sempre usada, exceto quando a entrega imediata é necessária. Mensagens com prioridade normal podem ser recebidas pelo app com atraso não especificado.

Uma mensagem com prioridade alta é enviada imediatamente, e o app pode exibir uma notificação.

Nas plataformas Apple, use este campo para representar content-available no payload de APNs. Quando uma notificação ou mensagem é enviada e o campo está definido como true, um app cliente inativo é ativado e a mensagem é enviada por APNs como uma notificação silenciosa e não pelo servidor de conexão do FCM. Não é garantido que essas notificações silenciosas em APNs sejam entregues e isso depende de fatores como o usuário ativar o modo de baixo consumo, saída forçada do app etc. No Android, as mensagens de dados ativam o app por padrão. Ainda não há compatibilidade com o Chrome.

Nas plataformas Apple, use este campo para representar mutable-content no payload de APNs. Quando uma notificação é enviada e este campo está definido como true, o conteúdo dela pode ser modificado antes da exibição por uma extensão de app do serviço de notificação. No Android e na Web, esse parâmetro é ignorado.

Este parâmetro especifica o tempo, em segundos, de manutenção da mensagem no armazenamento do FCM se o dispositivo ficar off-line. A vida útil máxima permitida é 4 semanas, que também é o valor padrão. Para mais informações, consulte Definir a vida útil de uma mensagem.

Quando definido como true, este parâmetro permite que os desenvolvedores testem uma solicitação sem realmente enviar uma mensagem.

O valor padrão é false.

Este parâmetro especifica os pares de chave-valor personalizados do payload da mensagem.

Por exemplo, com data:{"score":"3x1"}:

Nas plataformas Apple, se a mensagem é enviada por APNs, ela é representada por campos de dados personalizados. Se for enviada pelo FCM, ela será representada como um dicionário de chave-valor no AppDelegate application:didReceiveRemoteNotification:.

No Android, isso resulta em uma intent adicional chamada score com o valor de string 3x1.

A chave não pode ser uma palavra reservada, por exemplo, "from", "message_type" ou qualquer palavra que comece com "google" ou "gcm". Não use palavras definidas nesta tabela como, por exemplo, collapse_key.

É recomendável usar valores do tipo string. É preciso converter os valores nos objetos ou outros tipos de dados sem string (por exemplo, números inteiros ou booleanos) para string.

O título da notificação.

Este campo não está visível em smartphones e tablets.

O texto do corpo da notificação.

O som a ser reproduzido quando o dispositivo recebe a notificação.

String que especifica arquivos de som no pacote principal do app cliente ou na pasta Library/Sounds do contêiner de dados do app. Consulte mais informações na Biblioteca dos desenvolvedores do iOS.

O valor do indicador no ícone do app da tela inicial.

Se não é especificado, o indicador não é alterado.

Se é definido como 0, o indicador é removido.

A ação associada a um clique de usuário na notificação.

Corresponde a category no payload de APNs.

A legenda da notificação.

A chave da string de corpo nos recursos de string do app, a ser usada para identificar o texto do corpo na localização atual do usuário.

Corresponde a loc-key no payload de APNs.

Para mais informações, consulte Referência da chave de payload e Como localizar o conteúdo de notificações remotas.

Valores de string variáveis a serem usados no lugar dos especificadores de formato em body_loc_key para identificar o texto do corpo na localização atual do usuário.

Corresponde a loc-args no payload de APNs.

Para mais informações, consulte Referência da chave de payload e Como localizar o conteúdo de notificações remotas.

A chave da string de título nos recursos de string do app a ser usada para identificar o texto do título na localização atual do usuário.

Corresponde a title-loc-key no payload de APNs.

Para mais informações, consulte Referência da chave de payload e Como localizar o conteúdo de notificações remotas.

Valores de string variáveis a serem usados no lugar de especificadores de formato em title_loc_key para identificar o texto do título na localização atual do usuário.

Corresponde a title-loc-args no payload de APNs.

Para mais informações, consulte Referência da chave de payload e Como localizar o conteúdo de notificações remotas.

O título da notificação.

O texto do corpo da notificação.

O código do canal da notificação (novo no Android O).

O app precisa criar um canal com este ID do canal antes que qualquer notificação com esse ID seja recebida.

Se você não enviar esse ID do canal na solicitação ou, se o ID do canal fornecido ainda não foi criado pelo app, o FCM usará o ID do canal especificado no manifesto do app.

O ícone da notificação.

Define o ícone da notificação como myicon para o recurso drawable myicon. Se você não enviar essa chave na solicitação, o FCM exibe o ícone do inicializador especificado no manifesto do app.

O som a ser reproduzido quando o dispositivo recebe a notificação.

Aceita "default" ou o nome do arquivo de um recurso de som no pacote do app. Arquivos de som precisam residir em /res/raw/.

Identificador usado para substituir notificações existentes na gaveta de notificações.

Se não está especificado, cada solicitação cria uma nova notificação.

Se está especificado e uma notificação com a mesma tag já está sendo mostrada, a nova notificação substitui a existente na gaveta das notificações.

A cor do ícone da notificação, expressa no formato #rrggbb.

A ação associada a um clique de usuário na notificação.

Se especificado, uma atividade com um filtro de intent correspondente é iniciada quando um usuário clica na notificação.

A chave da string de corpo nos recursos de string do app, a ser usada para identificar o texto do corpo na localização atual do usuário.

Consulte Recursos de string para mais informações.

Valores de string variáveis a serem usados no lugar dos especificadores de formato em body_loc_key para identificar o texto do corpo na localização atual do usuário.

Consulte Como formatar e definir estilo para mais informações.

A chave da string de título nos recursos de string do app a ser usada para identificar o texto do título na localização atual do usuário.

Consulte Recursos de string para mais informações.

Valores de string variáveis a serem usados no lugar de especificadores de formato em title_loc_key para identificar o texto do título na localização atual do usuário.

Consulte Como formatar e definir estilo para mais informações.

O título da notificação.

O texto do corpo da notificação.

O URL a ser usado para o ícone da notificação.

A ação associada a um clique de usuário na notificação.

Um HTTPS é obrigatório para todos os valores de URL.

Este parâmetro especifica os apps cliente (tokens de registro) que recebem a mensagem.

O envio e o recebimento de mensagens multicast (envio para mais de um token de registro) só são permitidos no formato HTTP JSON.

Os pares de chave-valor de payload da mensagem são especificados nesse parâmetro. Não há limite para o número de parâmetros de chave-valor, mas há um limite de tamanho de mensagem total de 4096 bytes.

Por exemplo, no Android, "data.score"."3x1" resultaria em uma intent adicional chamada score com o valor de string 3x1.

A chave não pode ser uma palavra reservada, por exemplo, "from", "message_type" ou qualquer palavra que comece com "google" ou "gcm". Não use palavras definidas nesta tabela como, por exemplo, collapse_key.

• message_id: string que especifica um ID único para cada mensagem processada corretamente.
• error: string que especifica o erro que ocorreu ao processar a mensagem para o destinatário. Os valores possíveis estão disponíveis na tabela 9.

• Se o app cliente cancelar o registro com o FCM.
• Se o app cliente tiver o registro cancelado automaticamente, algo que pode ocorrer se o usuário desinstalar o aplicativo. Por exemplo, no iOS, se o serviço de feedback de APNs informou o token delas como inválido.
• Se o token de registro expirar, por exemplo, se o Google atualizar os tokens de registro, ou o token de APNs expirou para dispositivos iOS.
• Se o app cliente estiver atualizado, mas a nova versão não estiver configurada para receber mensagens.

• Cabeçalho de autorização não encontrado ou com sintaxe inválida na solicitação HTTP.
• O projeto do Firebase ao qual a chave do servidor especificada pertence está incorreto.
• Somente chaves de servidor legadas: a solicitação originada de um servidor que não consta na lista de permissões dos IPs de chave do servidor.

O servidor não conseguiu processar a solicitação a tempo. Tente enviar a mesma solicitação novamente. Para isso, é necessário:

• respeitar o cabeçalho Retry-After se ele estiver incluído na resposta do servidor de conexão do FCM.
• implementar uma retirada exponencial no mecanismo de nova tentativa. Por exemplo, se você esperou um segundo antes da primeira nova tentativa, aguarde pelo menos dois segundos antes da próxima, depois quatro segundos e assim por diante. Se estiver enviando várias mensagens, atrase cada uma de maneira independente por um período aleatório adicional para evitar emitir uma nova solicitação para todas as mensagens ao mesmo tempo.

Os remetentes que causam problemas podem ser incluídos nas listas negras.

A taxa de mensagens para um determinado dispositivo é muito alta. Se um aplicativo da Apple enviar mensagens a uma velocidade que exceda os limites dos APNs, talvez receba esta mensagem de erro.

Reduza o número de mensagens enviadas a esse dispositivo e use espera exponencial para tentar novamente o envio.