Este guia orienta administradores e equipes de tecnologia na integração de aplicativos móveis com a plataforma Dito. O foco principal é estabelecer o canal de Mobile Push, permitindo que a marca envie notificações diretas e mensuráveis para sua base de usuários.

Para quem é este artigo?

• Nível de Acesso: Administrador.
  Persona: Administradores, TI.

Nesse artigo você vai encontrar:

• Integração técnica do aplicativo com a Dito
• Passo a passo
• Token de Push
• Configuração do Firebase e envio do JSON
• Configuração dos eventos de cliques e entrega
  • FAQ – Perguntas Frequentes sobre Mobile Push

Integração técnica do aplicativo com a Dito

Antes de qualquer configuração de notificações push, é necessário que o time de tecnologia da marca realize a integração técnica do aplicativo com a Dito. Essa etapa é essencial para garantir o correto funcionamento de todos os recursos do canal mobile.

Regras da Integração

• Obrigatoriedade do SDK: Não é possível enviar push sem a integração técnica prévia.

• Sincronização de Base Antiga: Usuários antigos não aparecem automaticamente; seus tokens devem ser importados via API.

• Dependência do Firebase: O upload do arquivo JSON gerado no console do Firebase para dentro da plataforma Dito é um passo mandatório.

• Habilitação por Ficha: Para testes ou envios reais, o canal "Mobile Push" deve estar ativo na ficha do cliente alvo.

O que essa integração permite?

• Identificação correta dos usuários logados no aplicativo;

• Envio de eventos de comportamento para a base da Dito;

• Registro do token de push de cada dispositivo, indispensável para o envio das notificações.

Passo a passo

1. Integração SDK: 

Acesse a documentação técnica da Dito e siga o processo de integração mobile.

1.  Documentação oficial SDK
   
2. Guia unificado para configuração e uso de Push Notifications em todas as plataformas suportadas pelo Dito SDK.
   

2. Firebase:
Após a integração do aplicativo, é necessário configurar o Firebase  e realizar o upload do arquivo JSON no app.dito. Essa etapa conecta a infraestrutura do Firebase da marca à Dito.

1. Gere o arquivo JSON no Firebase, conforme as orientações do artigo Como criar Projeto no Firebase para intergação do mobile push.

2. Acesse o app.dito e faça o upload do arquivo JSON no canal Mobile Push, seguindo os passos do artigo Como realizar o upload do JSON no Canal Mobile Push.
   

Importante: Essa etapa é obrigatória, pois o envio de notificações mobile push utiliza a tecnologia do Google Firebase

3. Tokens Retroativos:

Se o aplicativo já possuía usuários cadastrados antes da integração com a Dito, será necessário enviar os tokens desses usuários via API. Caso contrário, apenas os usuários que utilizarem o app após a integração terão seus tokens registrados.

1. Gere o token no aplicativo conforme a tecnologia utilizada.
   

2. Envie o token para a Dito via API, seguindo a documentação oficial: Cadastrar token mobile

Por que configurar esses eventos?

A configuração dos eventos de entrega e clique é fundamental para que a Dito consiga gerar estatísticas sobre as notificações push enviadas.

Sem essa configuração, as notificações podem ser disparadas normalmente, porém não será possível acompanhar métricas como entregas, cliques e performance das campanhas.

1. Configure os eventos de entrega e clique no aplicativo, seguindo a documentação oficial da Dito:
   - Eventos e como se relacionam com a SDK 
   - Entendendo como a Dito recebe as integrações 
   - Guia de Push Notifications

2. Valide o envio dos eventos para garantir que os dados estejam chegando corretamente na plataforma.
   

Ficou com alguma dúvida ou identificou algum problema? Acione nosso time pelo chat disponível no app dito. (Horário de Atendimento de Segunda a Sexta das 9hrs as 18hrs) 

Gostou, mas acha que algo pode melhorar?

Sua opinião é muito importante para nós! Se você tem alguma sugestão ou sentiu falta de algo neste módulo, queremos ouvir você.

Compartilhe suas ideias diretamente com nosso time de Produto através do link abaixo.

➡️ Acesse aqui o Portal de Ideias

FAQ – Perguntas Frequentes sobre Mobile Push

1. É obrigatório integrar o aplicativo com a Dito para enviar notificações push?
R: Sim. A integração técnica é indispensável, pois é ela que permite registrar usuários, tokens de dispositivos e habilitar o envio de notificações pela Dito.

2. Quais plataformas de SDK a Dito oferece suporte?
R: A Dito oferece SDKs para Android, iOS e Flutter, além de um documento auxiliar para projetos desenvolvidos em React Native.

3. Já possuo usuários cadastrados no app antes da integração. O que devo fazer?
R: Nesse caso, é necessário enviar os tokens desses usuários para a Dito via API. Caso isso não seja feito, apenas os usuários que acessarem o app após a integração terão seus tokens considerados.

4. Por que preciso configurar o Firebase e realizar o upload do arquivo JSON?
R: Porque a tecnologia de envio de notificações push utilizada pela Dito é baseada no Google Firebase. Sem essa configuração, os disparos não funcionarão corretamente.

5. O que acontece se eu não configurar os eventos de entrega e clique?
R: As notificações poderão ser enviadas normalmente, porém não será possível visualizar métricas de entrega, cliques e performance das campanhas na plataforma Dito.