Pular para o conteúdo

Para equipe ilarika

Notificação com o app fechado

  • Firebase ConsoleConfigurações do projeto
  • App Store ConnectUsuários e AcessoIntegraçõesChaves
  • GitHubSettingsSecrets and variablesActions

Cada app avisa no celular mesmo fechado:

App Quando avisa Som
iLarika Equipe pedido novo na loja, Pix para conferir, cliente sem resposta no WhatsApp alarme de balcão, alto, no canal “Pedidos novos”
iLarika Entregadores corrida nova, oferta da rede, corrida cancelada ou devolvida toque de corrida, no canal “Corridas”
iLarika pedido em preparo, pronto, saiu para entrega, entregue ou cancelado som padrão do celular

Os avisos são os mesmos eventos que já aparecem na tela pelo sistema. Quem não veria o pedido no painel (pelo papel na equipe) não recebe o aviso. O app pede a permissão de notificação depois do login, nunca na primeira abertura. Saiu da conta, o celular para de receber.

No Android, cada canal tem o próprio som e pode ser ajustado em Configurações › Apps › iLarika Equipe › Notificações.

Esta página é para a equipe iLarika configurar os avisos. Para quem trabalha na loja: Instalar o app da equipe e receber aviso de pedido no celular.

Antes de começar

Os avisos precisam de duas configurações, uma por sistema. Sem elas os apps funcionam normalmente, só não avisam com o app fechado.

Android: Firebase (grátis)

  1. Em console.firebase.google.com, crie um projeto (por exemplo, ilarika-apps). Desligue o Google Analytics: não usamos.
  2. Em Configurações do projeto › Seus apps, adicione três apps Android com os pacotes br.com.ilarika.equipe, br.com.ilarika.entregadores e br.com.ilarika.marketplace. Não precisa do SHA.
  3. Baixe o google-services.json (o último baixado traz os três apps) e cadastre o conteúdo inteiro no GitHub como o secret FIREBASE_GOOGLE_SERVICES_JSON. É ele que entra no APK.
  4. Em Configurações do projeto › Contas de serviço › Gerar nova chave privada, baixe o JSON. Ele é do servidor: vai na variável FCM_CONTA_DE_SERVICO da API (no .env do VPS, cru ou em base64), nunca no app nem no GitHub.

iPhone: chave do APNs

  1. Em developer.apple.com › Certificates, IDs & Profiles › Keys › +, marque Apple Push Notifications service (APNs) e baixe a chave .p8. Ela só pode ser baixada uma vez. Anote o Key ID.
  2. Na API (.env do VPS), preencha APNS_CHAVE_P8 (o conteúdo do .p8), APNS_KEY_ID e APNS_TEAM_ID (o Team ID da conta, em Membership details).
  3. Não precisa mexer no app: o projeto já pede a capability de push, e o build automático liga a capability no App ID.

Com conta emprestada, a chave do APNs é da conta do colega e serve para os apps de teste dele. Quando o iLarika tiver conta própria, gere outra chave lá e troque as três variáveis.

O que acontece depois

  1. Depois de configurar, faça um build novo dos apps (Android com [apk], iPhone com [ios]).
  2. Instale, entre na conta e aceite a notificação.
  3. Feche o app e faça um pedido na loja de teste: o aviso chega na Equipe.

Perguntas comuns

O web push dos entregadores continua? Continua, para quem usa pelo navegador. O app usa o canal nativo, e um não atrapalha o outro.

Celular trocado ou app desinstalado? O próximo aviso volta com “aparelho inexistente”, e o servidor apaga o registro sozinho.

Se der errado

  • Não chega nada no Android: confira se o build mostrou o aviso amarelo “Sem FIREBASE_GOOGLE_SERVICES_JSON” ou “não tem o app”. Sem o arquivo certo, o APK sai sem notificação.
  • Não chega nada no iPhone: confira as três variáveis APNS_* na API e se o build veio do TestFlight (a API fala com o servidor de produção da Apple; build pelo Xcode precisa de APNS_SANDBOX=true).
  • Chega sem som no Android: o som é do canal. Se alguém mudou nas configurações do celular, volte em Notificações › Pedidos novos › Som.