Receber mensagens upstream

Cuidado: o envio de mensagens (incluindo mensagens upstream) com as FCM APIs legadas XMPP e HTTP do FCM foi descontinuado em 20 de junho de 2023 e será removido a partir de junho. de 2024. Se você estiver usando as APIs de envio legadas FCM, recomendamos migrar para a API HTTP v1 ou usar o SDK Admin para criar solicitações de envio.

Quando uma chamada de mensagem upstream de um app cliente é recebida no FCM, é gerada uma estrofe XMPP para enviar essa mensagem. Os campos category e from são adicionados pelo FCM, que envia uma estrofe como esta ao servidor do app:

<message id="">
  <gcm xmlns="google:mobile:data">
  {
      "category":"com.example.yourapp", // to know which app sent it
      "data":
      {
          "hello":"world",
      },
      "message_id":"m-123",
      "from":"REGID"
  }
  </gcm>
</message>

Recomenda-se pelo menos uma conexão a cada 500 mensagens por segundo. Se o servidor do app não abrir conexões suficientes para processar todo o tráfego, o FCM descartará o excesso de mensagens upstream.

Como enviar mensagens ACK

Em resposta a uma mensagem upstream como a mostrada acima, o servidor do app deve usar a mesma conexão para enviar uma ACK com o ID exclusivo da mensagem. Se o FCM não receber uma ACK, pode ser que ele tente enviar a mensagem para o servidor do app novamente.

<message id="">
  <gcm xmlns="google:mobile:data">
  {
      "to":"REGID",
      "message_id":"m-123"
      "message_type":"ack"
  }
  </gcm>
</message>

Consulte Referência do servidor de conexão XMPP para mais informações sobre a sintaxe de mensagens upstream.