As notificações por push são usadas em aplicativos móveis para cenários de negócios e de consumo principalmente para envolver usuários de aplicativo e ajudá-los a priorizar as tarefas principais. No PowerApps, é possível enviar notificações ao usar o conector Notificação do PowerApps. É possível enviar notificações por push nativo para qualquer aplicativo que você criar no PowerApps. Estamos planejando adicionar mais tipos de notificação no futuro.

Exemplo da aparência de uma notificação por push

Adicione uma notificação por push ao seu aplicativo se:

  • Seus usuários precisarem de informações imediatamente.
  • Os usuários devem concluir tarefas importantes ao usar o aplicativo em um contexto pré-carregados.
  • Você deseja envolver seus usuários em um intervalo específico ou você precisa que os usuários insiram o aplicativo em um contexto específico.

Observação: para receber notificações por push, cada usuário deve ter aberto o aplicativo no PowerApps Mobile uma vez ou obtido do aplicativo do AppSource em Dynamics 365.

Antes de começar

Em um aplicativo no qual você tem a permissão de Colaborador, adicione uma conexão da Notificação do PowerApps. Caso ainda não tenha um aplicativo, você poderá rapidamente criar um de um modelo e terá a permissão necessária por padrão. Aquele tutorial e este usam um aplicativo baseado no modelo de Gerenciamento de Casos.

Enviar uma notificação por push de um fluxo

Observação: caso dispare uma notificação por push de um fluxo, você poderá enviar a notificação para somente um usuário ou grupo de segurança por vez no momento.

  1. Em Microsoft Flow, criar um gatilho que especifique quando a notificação por push será enviada.

    Por exemplo, você talvez queira enviar uma notificação quando um registro for adicionado à entidade Caso no Common Data Service.

    Captura de tela da criação de um fluxo com um gatilho de Common Data Service

  2. Crie uma ação para o fluxo usando o conector Notificação do PowerApps e insira a ID do Aplicativo do aplicativo para o qual você deseja enviar notificações.

    Também é possível renomear a conexão para refletir seu cenário.

    A captura de tela da criação de uma conexão para o PowerApps que receberá essas notificações por push

  3. (opcional) Passe parâmetros para o aplicativo quando ele for aberto (depois que o usuário tocar a notificação por push).

    Neste exemplo, estamos passando os campos ID do Caso e Proprietário Inicial para o contato selecionado.

    A captura de tela de passar parâmetros opcionais para a notificação por push

Enviar uma notificação de um aplicativo

É possível enviar uma notificação por push de um aplicativo para outro ou para o mesmo aplicativo.

  1. Em PowerApps, vá até o aplicativo para o qual deseja enviar notificações por push.

  2. Na guia detalhes, copie a ID do Aplicativo daquele aplicativo.

    Pegar ID do Aplicativo

  3. Na guia Conexões, crie uma conexão com o conector Notificação do PowerApps e cole a ID do aplicativo da etapa anterior.

    Criar conexão

  4. Adicione a conexão com o aplicativo de gatilho.

    Em nosso exemplo, usamos o mesmo aplicativo como o aplicativo de gatilho. O usuário que reatribui o caso também dispara uma notificação por push para o novo proprietário do caso.

    Adicionar conexão

  5. Na conexão da notificação por push, chame o método SendPushNotification.

    Em nosso exemplo, disparamos esta notificação usando a propriedade OnSuccess em um formulário.

    Fórmula do PowerApps

Carregar uma página específica e o contexto quando um usuário tocar na notificação

Passar parâmetros

A notificação por push pode passar parâmetros específicos para o aplicativo. Por exemplo, para ler o valor CaseID, use Param("CaseID"). Para identificar rapidamente esse parâmetro, adicione um controle de Rótulo ao seu aplicativo. Defina a propriedade Text deste controle como Param("CaseID"). Se o usuário abrir o aplicativo na lista Todos os aplicativos, o valor estará vazio. Se o usuário abrir o aplicativo de outro local no dispositivo, o valor será preenchido com o valor CaseID.

Definir a página inicial

Você pode definir seu aplicativo para abrir, por exemplo, a página Detalhes do caso assim que o aplicativo abrir:

  1. Adicione um controle de Temporizador e defina sua propriedade OnTimerEnd para esta fórmula:
    Navigate(EditCase, ScreenTransition.None)

  2. (opcional) Oculte o controle do Temporizador ao configurar sua propriedade Visible como false.

  3. Defina a propriedade OnVisible da tela como Timer.Start().

Dica: é uma boa ideia criar uma única primeira página no aplicativo para a notificação:

  1. Crie uma página vazia que seu aplicativo já não abre, adicione um controle de Entrada de Texto e defina seu valor timer.Duration.
  2. Quando você criar o aplicativo, defina o temporizador para um valor diferente de zero. Quando você estiver pronto para publicar o aplicativo, defina o valor como 0 para disparar imediatamente o temporizador.

Sintaxe

Nome Descrição
SendPushNotification Envie uma notificação por push para o aplicativo especificado nas configurações de conexão para a notificação.

Parâmetros

Nome Tipo Descrição
destinatários Matriz de cadeia de caracteres, necessária Uma lista de:
  • Endereços de email para usuários ou grupos de segurança
  • IDs de objeto para usuários ou grupos de segurança no Azure Active Directory
mensagem Cadeia de caracteres, obrigatório O corpo da mensagem da notificação por push.
openApp Booliano, opcional Se você deseja abrir o aplicativo quando o usuário toca na notificação por push.
params Parâmetros, opcional Os parâmetros de chave-valor para passar a notificação. Eles podem ser processados futuramente no aplicativo para abrir uma página específica e carregar um estado específico.

Fórmulas de exemplo

Envie uma notificação básica.

PowerAppsNotification.SendPushNotification(
{
  recipients: [""f60ccf6f-7579-4f92-967c-2920473c966b", 72f988bf-86f1-41af-91ab-2d7cd011db47],
  message: "A new case was assigned to you."
 }
)

Envie uma notificação que abre um aplicativo e passa parâmetros específicos. PowerAppsNotification.SendPushNotification( { recipients:["email1@contoso.com", "email2@contoso.com"], message:"message in the notif toast", params:Table({key:"notificationKey", value:"The value for notificationKey"}), openApp:true } )

Limitações conhecidas

  • Atualmente, as notificações não são exibidas no PowerApps Mobile para Windows Phone.
  • No momento, não fornecemos notificações por push para usuários que executam aplicativos somente em um navegador da Web.
  • As notificações mostram o ícone do PowerApps genérico em vez de um ícone de aplicativo específico.
  • Quando você usar o Microsoft Flow, será possível enviar uma notificação por push somente para um destinatário por vez.

Para obter informações de referência, consulte referência da Notificação do PowerApps.