Qual é o meu plano?

Disponível em todos os planos do Chat

Se você está oferecendo o Zendesk Chat pelo seu próprio aplicativo para dispositivos móveis, pode ativar as notificações por push para avisar aos clientes sobre respostas e atualizações dos chats deles.

Para as contas do Zendesk Chat nos planos pagos, as notificações por push podem ser configuradas para notificar o usuário mesmo quando o aplicativo estiver em segundo plano no dispositivo móvel dele. Essas notificações podem ser ativadas em vários aplicativos para dispositivos móveis, se necessário.

Este artigo descreve as tarefas que os administradores precisam executar para a ativação de notificações por push nos aplicativos para dispositivos móveis e inclui os tópicos a seguir:

  • Preparação para adicionar o aplicativo
  • Ativação de notificações por push em seu aplicativo para dispositivos móveis
  • Edição de informações do aplicativo
  • Desativação de notificações por push de um aplicativo
  • Teste de notificações por push
  • Observação para antigos usuários do SDK para dispositivos móveis do Chat V1
Observação: a ativação de notificações por push só será possível para o Zendesk Chat em vários aplicativos se eles estiverem usando o SDK para dispositivos móveis V2 do Chat ou superior.

Preparação para adicionar o aplicativo

Antes que os desenvolvedores ativem as notificações por push, um administrador do Chat precisa carregar as credenciais do servidor FCM (para Android) ou um certificado PEM (para iOS) na conta do Chat.

Os desenvolvedores devem fornecer a você as credenciais do servidor FCM ou o arquivo do certificado PEM. Se eles tiverem dúvidas, direcione-os a estes documentos do portal de desenvolvedores da Zendesk:

  • https://developer.zendesk.com/embeddables/docs/chat-sdk-v-2-for-ios/push_notifications
  • https://developer.zendesk.com/embeddables/docs/chat-sdk-v-2-for-android/introduction

Ativação de notificações por push em seu aplicativo para dispositivos móveis

Observação: o Google removerá as APIs legadas de FCM XMPP e HTTP em junho de 2024. Clientes existentes que usam o SDK do Chat no Android precisam recarregar as credenciais no formato mais recente. Consulte Migrar de HTTP legado para HTTP v1.

Para ativar as notificações por push, os administradores precisam adicionar seus aplicativos à lista de SDK para dispositivos móveis, acessada pelo painel do Chat. Quando um aplicativo é adicionado a essa lista, uma ID do aplicativo é gerada e depois compartilhada com sua equipe de desenvolvimento de dispositivos móveis.

Como adicionar um aplicativo à lista de SDK para dispositivos móveis

  1. Em seu painel do Chat, vá até Configurações > Conta > API e SDKs.
  2. Na seção SDK para dispositivos móveis, clique em Adicionar aplicativo.

  3. Na página Adicionar aplicativos, insira as informações de seu aplicativo, que incluem:
    • Nome: um nome para o seu aplicativo que desenvolvedores e outros administradores reconheçam.
    • Descrição: uma breve descrição sobre o que o aplicativo faz.
    • (para Android) Carregue a chave privada da conta de serviço contendo as credenciais privadas, o e-mail do cliente (também chamado de e-mail da conta de serviço) e o ID do projeto clicando em Generate New Private Key no console do Firebase. Consulte Initialize the SDK in non-Google environments. Você também deve adicionar google-services.json ao seu projeto Android. Consulte Push notifications.

      Na maioria dos cenários de migração, a API Firebase Cloud Messaging (FCM) v1 é ativada por padrão. Se você encontrar erros quando tentar o contato com o ponto de extremidade, garanta que a API Firebase Cloud Messaging esteja ativada na lista de APIs e serviços no console do Google Cloud.

    • (para iOS) Carregue um certificado PEM.
  4. Clique em Salvar alterações.

Seu aplicativo agora está criado e atribuído com uma ID do aplicativo.

Informe à equipe de desenvolvimento que as credenciais ou o certificado foram carregados. Após receber essa confirmação, a equipe precisa fazer as alterações no código do aplicativo para ativar as notificações por push. Para obter mais informações, envie a ela os links para os documentos do desenvolvedor citados anteriormente.

Edição de informações do aplicativo

É possível editar o nome e a descrição atribuídos para o seu aplicativo para dispositivos móveis, conforme descrito anteriormente em Ativação de notificações por push em seu aplicativo para dispositivos móveis.

Como editar as configurações existentes do aplicativo

  1. No painel, vá até Configurações > Conta > API e SDKs.
  2. Na seção SDK para dispositivos móveis, clique no aplicativo que deseja editar.
  3. Na página Editar aplicativo, faça as alterações e clique em Salvar alterações.

Desativação de notificações por push de um aplicativo

Se não deseja mais disponibilizar as notificações por push do Chat em um aplicativo para dispositivos móveis, remova-as da lista de SDK para dispositivos móveis.

Uma vez apagadas, os visitantes que usarem essa ID do aplicativo não receberão mais notificações por push de seu atendimento. Você não pode criar outro aplicativo de SDK para dispositivos móveis com a mesma ID do aplicativo e a exclusão é irreversível.

Como apagar um ou mais aplicativos

  1. No painel, vá até Configurações > Conta > API e SDKs.
  2. Na seção SDK para dispositivos móveis, selecione os aplicativos que deseja apagar.
  3. Clique em Apagar os selecionados.

Teste de notificações por push

Se o seu aplicativo está disponível nos dispositivos iOS, você pode testar suas notificações por push antes de disponibilizá-las pelo seu aplicativo ativo.

Como enviar as notificações por push para testar o ambiente (apenas no iOS)

  1. No painel, vá até Configurações > Conta > API e SDKs.
  2. Na seção SDK para dispositivos móveis, clique no aplicativo para o qual deseja enviar as notificações por push para testar o ambiente.
  3. Na seção iOS, selecione Para sandbox de APNs.
  4. Clique no botão Salvar alterações.

Observação para antigos usuários do SDK para dispositivos móveis do Chat V1

Se você já usou o SDK para dispositivos móveis do Chat V1, verá que não é possível apagar os aplicativos chamados "App 1" em sua conta.

Se você tem um aplicativo que usa o SDK para dispositivos móveis V1 criado na antiga experiência de configurações do SDK para dispositivos móveis, migramos o aplicativo existente para a nova experiência. Você o encontrará com facilidade ao procurar o nome pré-atribuído "App 1" (você pode alterar isso nas configurações do aplicativo).

Desabilitamos a exclusão desse aplicativo em seu painel, pois ele usa a versão antiga do SDK para dispositivos móveis que não poderá mais ser adicionada como um novo aplicativo caso seja apagado por engano.

Caso queira desativar esse aplicativo:

  1. Clique no App 1 na seção SDK para dispositivos móveis.
  2. Clique em Editar aplicativo.
  3. Remova a chave do servidor FCM e/ou o arquivo PEM.
  4. Clique em Salvar alterações.
Powered by Zendesk