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.

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

Mobile Push: Como integrar e configurar o canal

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 de mobile push.

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 obrigatório na configuração.
• 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 da Configuração

1. Realize a Integração via SDK

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

Abaixo estão os guias necessários:

• Documentação oficial SDK
• Guia unificado para configuração de Push Notifications

2. Configure o Firebase e envie o arquivo JSON

Após a integração do aplicativo, configure o Firebase e realize o upload do arquivo JSON na plataforma 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 integração do mobile push.

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

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

3. Importe os Tokens Retroativos (Opcional)

Se o aplicativo já possuía usuários cadastrados antes da integração com a Dito, envie 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.

4. Configure os Eventos de Cliques e Entrega

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.
3. Eventos registrado na ficha de um usuário:
   

Seguindo todos os passos descritos neste artigo (a integração técnica do aplicativo, o envio do token, a configuração do Firebase, o upload do JSON e a implementação dos eventos de clique e entrega), sua marca estará totalmente preparada para utilizar o canal de notificações push da Dito.

FAQ – Perguntas Frequentes

1. Pergunta: É obrigatório integrar o aplicativo com a Dito para enviar notificações push?
Resposta: 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. Pergunta: Quais plataformas de SDK a Dito oferece suporte?
Resposta: A Dito oferece SDKs para Android, iOS e Flutter, além de um documento auxiliar para projetos desenvolvidos em React Native.

3. Pergunta: Já possuo usuários cadastrados no app antes da integração. O que devo fazer?
Resposta: 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 registrados.

4. Pergunta: Por que preciso configurar o Firebase e realizar o upload do arquivo JSON?
Resposta: 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. Pergunta: O que acontece se eu não configurar os eventos de entrega e clique?
Resposta: 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.

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)

TAGS DE BUSCA: Mobile Push, Notificação Push, Dito CRM, Integrar Push, Configurar Push, SDK Mobile, Firebase, JSON Firebase, Token Push, Eventos de clique, Notificação Android, Notificação iOS, Dito SDK, React Native, Flutter, como enviar notificação para celular, configurar push no app, erro push dito, métricas de push, push não funciona, cadastrar token mobile, importar base mobile, firebase cloud messaging, fcm, google firebase, upload json. PERGUNTAS RELACIONADAS: Como enviar push pelo Dito? Como configurar notificação no meu aplicativo? Por que preciso do Firebase para enviar push? Como importar tokens de push de usuários antigos? Por que a Dito não está medindo o clique do meu push? Onde faço o upload do arquivo JSON do Firebase na Dito? Como integrar o SDK da Dito no meu app Android/iOS?