Como configurar notificações push do SDK móvel do Zendesk: Guia completo de 2026
Stevia Putri
Última edição February 26, 2026
As notificações push são a ponte entre seus clientes e sua equipe de suporte quando eles estão em movimento. Quando alguém envia uma solicitação de suporte de seu telefone, espera saber imediatamente quando você respondeu. Não quando eles se lembram de verificar o aplicativo. Não depois que eles mudaram para o e-mail. Na hora.
Configurar notificações push para o SDK móvel do Zendesk não é complicado, mas é preciso. Um certificado mal configurado, uma etapa perdida no Firebase e seus clientes ficam se perguntando se sua mensagem desapareceu no vazio.
Este guia explica tudo o que você precisa para fazer as notificações push funcionarem para iOS e Android. Abordaremos o Zendesk Messaging SDK (a abordagem recomendada atualmente), o Chat SDK mais antigo, se você estiver mantendo o código legado, e o que fazer quando as coisas não funcionarem como esperado.
Para equipes que já usam o Zendesk, também existe um caminho mais simples que vale a pena considerar. Na eesel AI, nos integramos diretamente com sua configuração existente do Zendesk e lidamos com as conversas com os clientes sem a complexidade do SDK móvel. Mais sobre isso mais tarde.
O que são notificações push do SDK móvel do Zendesk?
As notificações push no ecossistema móvel do Zendesk são alertas enviados ao dispositivo de um cliente quando um agente responde à sua solicitação de suporte. Sem elas, os clientes precisam abrir manualmente seu aplicativo e verificar se há respostas. Com elas, a conversa flui naturalmente.
O SDK móvel do Zendesk oferece suporte a notificações push em duas plataformas principais:
- iOS: Usa o serviço de notificação push da Apple (APNs) com certificados SSL
- Android: Usa o Firebase Cloud Messaging (FCM) com chaves de servidor
Existem também três SDKs diferentes que você pode encontrar, cada um com abordagens ligeiramente diferentes:
| SDK | Caso de Uso | Método Push |
|---|---|---|
| Zendesk Messaging SDK | Mensagens unificadas modernas | APNs/FCM integrado |
| Zendesk Chat SDK v2 | Implementações de chat legadas | APNs/FCM via painel do Chat |
| Zendesk Support SDK | Suporte baseado em tickets | API Webhook ou Urban Airship |
Se você estiver começando do zero, use o Messaging SDK. É o padrão atual e lida com a maioria dos casos de uso sem a complexidade das opções mais antigas.
Pré-requisitos para configurar notificações push
Antes de mergulhar na configuração, certifique-se de que você tem:
- Uma conta do Zendesk com o Messaging habilitado
- Acesso de administrador ao seu Admin Center do Zendesk
- Para iOS: Uma conta de desenvolvedor da Apple (US$ 99/ano)
- Para Android: Um projeto Firebase (o nível gratuito funciona)
- Seu aplicativo móvel com o SDK do Zendesk já integrado
Você também precisará de dispositivos físicos para teste. As notificações push não funcionam em simuladores iOS e os emuladores Android podem não ser confiáveis para isso.
Configurando notificações push para iOS
As notificações push do iOS exigem a criação e o upload de um certificado do Apple Push Notification service (APNs). Veja como é feito.
Passo 1: Crie seu certificado .p12 no Portal de Desenvolvedores da Apple
Faça login no Apple Developer Member Center e navegue até a seção de certificados:
- Clique no botão + para criar um novo certificado
- Selecione Apple Push Notification service SSL (Sandbox & Production)
- Escolha o ID do seu aplicativo no menu suspenso
- Siga as instruções da Apple para gerar uma Solicitação de Assinatura de Certificado (CSR) usando o Acesso às Chaves
- Envie o CSR para gerar seu certificado
- Baixe o certificado e clique duas vezes para abri-lo no Acesso às Chaves
- Clique com o botão direito do mouse no certificado e selecione Exportar "Apple Push Services: {your-app-id}"
- Salve como um arquivo .p12 (você pode definir uma senha ou deixá-la em branco)
Importante: o Zendesk não oferece suporte a certificados somente Sandbox. Você precisará usar um certificado com o ambiente de produção habilitado.
Passo 2: Envie o certificado para o Admin Center do Zendesk
Agora adicione esse certificado à sua conta do Zendesk.
- No Admin Center do Zendesk, clique no ícone Canais e, em seguida, em Messaging
- Clique em iOS e, em seguida, na guia Notificações
- Arraste e solte seu arquivo .p12 ou clique para procurar
- Clique em Salvar alterações
Se você ainda não tiver o iOS messaging habilitado, você precisará adicionar o canal primeiro (Canais > Configuração de Messaging > Adicionar Canal > iOS).
Passo 3: Configure seu projeto Xcode
Abra seu projeto no Xcode e adicione os recursos necessários:
- Selecione o destino do seu projeto
- Vá para a guia Signing & Capabilities
- Clique em + Capability e adicione Push Notifications
- Verifique o arquivo .entitlements do seu aplicativo para confirmar se existe uma chave
APS Environmente está definida como production
Passo 4: Implemente o código de notificação push
Adicione o código para se registrar para notificações e manipulá-las em seu aplicativo.
Primeiro, solicite autorização e registre-se para notificações remotas em seu AppDelegate:
import UserNotifications
import ZendeskSDKMessaging
func application(_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
registerForPushNotifications()
return true
}
private func registerForPushNotifications() {
let notificationCenter = UNUserNotificationCenter.current()
notificationCenter.delegate = self
notificationCenter.requestAuthorization(options: [.alert, .sound, .badge]) { allowed, _ in
guard allowed else { return }
DispatchQueue.main.async {
UIApplication.shared.registerForRemoteNotifications()
}
}
}
Em seguida, manipule o registro do token do dispositivo:
func application(_ application: UIApplication,
didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
PushNotifications.updatePushNotificationToken(deviceToken)
}
Finalmente, implemente o delegado do centro de notificação para lidar com as notificações recebidas:
func userNotificationCenter(_ center: UNUserNotificationCenter,
willPresent notification: UNNotification,
withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
let userInfo = notification.request.content.userInfo
let shouldBeDisplayed = PushNotifications.shouldBeDisplayed(userInfo)
switch shouldBeDisplayed {
case .messagingShouldDisplay:
if #available(iOS 14.0, *) {
completionHandler([.banner, .sound, .badge])
} else {
completionHandler([.alert, .sound, .badge])
}
case .messagingShouldNotDisplay:
completionHandler([])
case .notFromMessaging:
completionHandler([])
@unknown default:
break
}
}
Configurando notificações push para Android
O Android usa o Firebase Cloud Messaging (FCM), que geralmente é mais simples do que o gerenciamento de certificados iOS.
Passo 1: Configure o Firebase Cloud Messaging
Se você ainda não o fez, crie um projeto Firebase e adicione seu aplicativo Android.
- Vá para o Firebase Console
- Crie um novo projeto ou selecione um existente
- Clique no ícone do Android para adicionar um aplicativo
- Digite o nome do seu pacote e registre o aplicativo
- Baixe o arquivo
google-services.json - Copie o arquivo para a pasta app do seu projeto Android Studio
Adicione as dependências do Firebase ao build.gradle no nível do aplicativo:
implementation platform("com.google.firebase:firebase-bom:{latest_version}")
implementation "com.google.firebase:firebase-messaging:{latest_version}"
Aplique o plugin de serviços do Google no mesmo arquivo:
apply plugin: 'com.google.gms.google-services'
Passo 2: Adicione as credenciais do Firebase ao Zendesk
Gere uma chave de conta de serviço e envie-a para o Zendesk:
- No Firebase Console, vá para Configurações do projeto > Contas de serviço
- Clique em Gerar nova chave privada
- No Admin Center do Zendesk, vá para Canais > Messaging > Android
- Envie o arquivo JSON que você acabou de baixar
- Clique em Salvar alterações
Observação: o Google descontinuou as APIs FCM legadas em junho de 2024. Se você estiver migrando de uma configuração mais antiga, certifique-se de que está usando o formato da API FCM v1.
Passo 3: Implemente o FCM em seu aplicativo
Registre seu token push com o SDK do Zendesk quando ele estiver disponível.
No código principal do seu aplicativo ou FirebaseMessagingService:
import com.google.firebase.messaging.FirebaseMessaging
import zendesk.messaging.android.push.PushNotifications
// Retrieve the current FCM registration token
FirebaseMessaging.getInstance().token.addOnCompleteListener { task ->
if (task.isSuccessful) {
val token = task.result
PushNotifications.updatePushNotificationToken(token)
}
}
// Or in your FirebaseMessagingService:
override fun onNewToken(newToken: String) {
PushNotifications.updatePushNotificationToken(newToken)
}
Para exibir notificações, use o serviço padrão do SDK ou manipule-as você mesmo:
// Using the default implementation (simplest)
// Add to AndroidManifest.xml:
<service android:name="zendesk.messaging.android.push.DefaultMessagingService"
android:exported="false">
<intent-filter>
<action android:name="com.google.firebase.MESSAGING_EVENT" />
</intent-filter>
</service>
Para manipulação personalizada, verifique se o push pertence ao Zendesk antes de exibir:
override fun onMessageReceived(remoteMessage: RemoteMessage) {
val responsibility = PushNotifications.shouldBeDisplayed(remoteMessage.data)
when (responsibility) {
PushResponsibility.MESSAGING_SHOULD_DISPLAY -> {
PushNotifications.displayNotification(context = this, messageData = remoteMessage.data)
}
PushResponsibility.MESSAGING_SHOULD_NOT_DISPLAY -> {
// Zendesk push, but shouldn't display
}
PushResponsibility.NOT_FROM_MESSAGING -> {
// Handle your own pushes here
}
}
}
Entendendo os diferentes SDKs do Zendesk
Se você estiver mantendo um aplicativo mais antigo ou avaliando opções, vale a pena entender as diferenças entre os SDKs móveis do Zendesk.
Zendesk Messaging SDK (Atual)
O Messaging SDK é a plataforma moderna e unificada do Zendesk. Ele combina chat, mensagens e suporte em uma única interface:
- Histórico de conversas unificado em todos os canais
- Suporte integrado para notificações push
- Componentes de UI modernos
- Recomendado para todas as novas implementações
Zendesk Chat SDK v2 (Legado)
O Chat SDK v2 foi projetado especificamente para cenários de chat ao vivo:
- Requer configuração separada no painel do Chat
- Processo de configuração de notificação push diferente
- Ainda é suportado, mas não recomendado para novos projetos
Zendesk Support SDK
O Support SDK se concentra no suporte baseado em tickets, em vez de chat em tempo real:
- Usa API Webhook ou Urban Airship para notificações push
- Configuração mais complexa que exige integração de backend
- Melhor para aplicativos que não precisam de chat em tempo real
Se você estiver iniciando um novo projeto, use o Messaging SDK. As outras opções existem principalmente para equipes que mantêm implementações existentes.
Solução de problemas comuns
As notificações push têm vários pontos de falha. Veja o que verificar quando elas não estão funcionando.
Notificações push não aparecendo
- iOS: Verifique se o seu certificado .p12 inclui o ambiente de produção e não expirou
- Android: Confirme se a API FCM v1 está habilitada no Google Cloud Console (as APIs legadas foram descontinuadas em junho de 2024)
- Ambos: Verifique se o token do dispositivo está realmente sendo registrado no Zendesk (adicione o registro para verificar)
Notificações não abrindo a conversa
Quando um usuário toca em uma notificação, ele deve acessar a conversa relevante. Se não o fizer:
- Verifique se você está implementando
userNotificationCenter(didReceive:)no iOS - Verifique se
PushNotifications.handleTap()está sendo chamado - Certifique-se de que o SDK está inicializado antes de manipular o toque (não funcionará se o aplicativo foi encerrado)
Confusão entre sandbox e produção do iOS
Um erro comum é testar com um certificado Sandbox em uma build de produção ou vice-versa. O Zendesk requer certificados de produção. Teste em um dispositivo real com uma build assinada para produção.
Falhas no registro do token do dispositivo
Se os tokens não estiverem sendo registrados:
- Verifique a conectividade de rede
- Verifique se o dispositivo já não está registrado com uma identidade diferente
- Certifique-se de que está chamando
updatePushNotificationToken()toda vez que o aplicativo é iniciado (os tokens podem mudar)
Melhores práticas para notificações push de suporte móvel
Acertar a configuração técnica é apenas metade da batalha. Como você usa as notificações push também importa.
-
Solicite permissão no momento certo: Não peça permissão de notificação imediatamente no primeiro lançamento. Espere até que o usuário inicie uma conversa de suporte.
-
Personalize a aparência da notificação: Tanto o iOS quanto o Android permitem que você personalize ícones, sons e padrões de vibração. Combine-os com sua marca.
-
Manipule as notificações em primeiro plano: Por padrão, as notificações não aparecem quando seu aplicativo está em primeiro plano. Implemente
willPresentNotificationpara mostrá-las ou fornecer indicadores no aplicativo. -
Teste completamente: Teste em dispositivos reais, não em simuladores. Teste quando o aplicativo estiver em primeiro plano, em segundo plano e totalmente encerrado. Teste com condições de rede ruins.
-
Monitore a entrega: Use a análise do Zendesk para rastrear as taxas de entrega de push. Se estiverem baixas, investigue problemas de certificado ou configuração.
Uma alternativa mais simples: eesel AI para suporte móvel
Configurar notificações push é apenas uma parte do quebra-cabeça do suporte móvel. Você também precisará contratar pessoas para essas conversas, treinar agentes e manter os tempos de resposta.
Na eesel AI, oferecemos uma abordagem diferente. Em vez de apenas rotear mensagens para agentes humanos, atuamos como um colega de equipe autônomo que lida com toda a conversa.
Veja como nos comparamos à abordagem tradicional do SDK móvel do Zendesk:
| Aspecto | Zendesk SDK + Agentes Humanos | Integração eesel AI |
|---|---|---|
| Complexidade da configuração | Certificados, integração do SDK, treinamento de agentes | Conexão com o Zendesk com um clique |
| Tempo de resposta | Depende da disponibilidade do agente | Instantâneo, 24 horas por dia, 7 dias por semana |
| Taxa de resolução | Varia de acordo com a equipe | Média de resolução autônoma de 81% |
| Notificações móveis | Requer implementação completa do SDK | Funciona com o aplicativo móvel Zendesk existente |
| Custo | Assentos por agente + infraestrutura | Preços por interação |
Com nossa integração com o Zendesk, você conecta sua conta existente do Zendesk e aprendemos com seus tickets anteriores, artigos da central de ajuda e macros. Em seguida, lidamos com o suporte de linha de frente diretamente no Zendesk, escalando apenas o que não podemos resolver.
Para equipes que já investiram no SDK móvel do Zendesk, podemos trabalhar em conjunto com ele. Lidamos com consultas de rotina instantaneamente, enquanto seus agentes humanos se concentram em questões complexas. Os clientes ainda recebem notificações push por meio do aplicativo móvel do Zendesk, mas obtêm respostas mais rapidamente.
Nossos preços começam em US$ 299/mês para o plano Team, que inclui até 3 bots e 1.000 interações. O plano Business, a US$ 799/mês, adiciona bots ilimitados, treinamento de tickets anteriores e residência de dados na UE.
Começando com as notificações push do SDK móvel do Zendesk
As notificações push são essenciais para qualquer experiência de suporte móvel. Sem elas, as conversas ficam paralisadas. Com elas, você pode fornecer o suporte responsivo e em tempo real que os clientes esperam.
O processo de configuração é simples, mas exato. Siga as etapas para sua plataforma com cuidado, teste em dispositivos reais e tenha uma lista de verificação de solução de problemas pronta para quando as coisas não funcionarem na primeira vez.
Se você estiver procurando reduzir a complexidade do suporte móvel completamente, considere aumentar sua configuração do Zendesk com eesel AI. Nós lidamos com as conversas para que sua equipe possa se concentrar no que os humanos fazem de melhor.
Perguntas Frequentes
Share this article
Article by
Stevia Putri
Stevia Putri is a marketing generalist at eesel AI, where she helps turn powerful AI tools into stories that resonate. She’s driven by curiosity, clarity, and the human side of technology.
