Enviar uma notificação por push no PowerAppsSend a push notification in PowerApps

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.Push notifications are used in mobile apps for consumer and business scenarios primarily to engage app users and help them prioritize key tasks. No PowerApps, é possível enviar notificações ao usar o conector Notificação do PowerApps.In PowerApps, you can send notifications by using the PowerApps Notification connector. É possível enviar notificações por push nativo para qualquer aplicativo que você criar no PowerApps.You can send native push notifications to any app that you create in PowerApps. Estamos planejando adicionar mais tipos de notificação no futuro.We plan to add more notification types in the future.

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

Adicione uma notificação por push ao seu aplicativo se:Add a push notification to your app if:

  • Seus usuários precisarem de informações imediatamente.Your users need to know information immediately.
  • Os usuários devem concluir tarefas importantes ao usar o aplicativo em um contexto pré-carregados.Your users must complete important tasks by using your app, in a preloaded context.
  • 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.You want to engage your users on a specific interval, or you need users to enter the app in a specific context.

Observação

Para receber notificações por push, cada usuário precisa ter aberto o aplicativo no PowerApps Mobile uma vez ou obtido do aplicativo do AppSource no Dynamics 365.To receive push notifications, each user must have opened the app in PowerApps Mobile once or gotten the app from AppSource in Dynamics 365.

Antes de começarBefore you start

Em um aplicativo no qual você tem a permissão de Colaborador, adicione uma conexão da Notificação do PowerApps.In an app for which you have the Contributor permission, add a PowerApps Notification connection. 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.If you don't already have an app, you can quickly create one from a template, and you'll have the required permission by default. Aquele tutorial e este usam um aplicativo baseado no modelo de Gerenciamento de Casos.That tutorial and this one use an app based on the Case Management template.

Enviar uma notificação por push de um fluxoSend a notification from a flow

Observação

Se disparar 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.If you trigger a push notification from a flow, you can send the notification to only one user or security group at a time currently.

  1. Em Microsoft Flow, criar um gatilho que especifique quando a notificação por push será enviada.In Microsoft Flow, create a trigger that specifies when the push notification is sent.

    Por exemplo, você talvez queira enviar uma notificação quando um registro for adicionado à entidade Caso no Common Data Service.For example, you might want to send a notification when a record is added to the Case entity in the 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.Create an action for the flow by using the PowerApps Notification connector, and enter the App ID of the app to which you want to send notifications.

    Também é possível renomear a conexão para refletir seu cenário.You can also rename the connection to reflect your scenario.

    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).(optional) Pass parameters to the app when it opens (after the user taps the push notification).

    Neste exemplo, estamos passando os campos ID do Caso e Proprietário Inicial para o contato selecionado.In our example, we pass along the Case ID and Initial Owner fields for the selected contact.

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

Enviar uma notificação de um aplicativoSend a notification from an app

É possível enviar uma notificação por push de um aplicativo para outro ou para o mesmo aplicativo.You can send a push notification from one app to another or to the same app.

  1. Em PowerApps, vá até o aplicativo para o qual deseja enviar notificações por push.In PowerApps, go to the app to which you want to send push notifications.
  2. Na guia detalhes, copie a ID do Aplicativo daquele aplicativo.On the Details tab, copy the App ID of that app.

    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.On the Connections tab, create a connection to the PowerApps Notification connector, and paste in the app ID from the previous step.

    Criar conexão

  4. Adicione a conexão com o aplicativo de gatilho.Add the connection to the trigger app.

    Em nosso exemplo, usamos o mesmo aplicativo como o aplicativo de gatilho.In our example, we use the same app as the trigger app. O usuário que reatribui o caso também dispara uma notificação por push para o novo proprietário do caso.The user who reassigns the case also triggers a push notification to the new case owner.

    Adicionar conexão

  5. Na conexão da notificação por push, chame o método SendPushNotification.From the push notification connection, call the SendPushNotification method.

    Em nosso exemplo, disparamos esta notificação usando a propriedade OnSuccess em um formulário.In our example, we trigger this notification by using the OnSuccess property in a form.

    Fórmula do PowerApps

Carregar uma página específica e o contexto quando um usuário tocar na notificaçãoLoad a specific page and context when a user taps the notification

Passar parâmetrosPass parameters

A notificação por push pode passar parâmetros específicos para o aplicativo.Your push notification can pass specific parameters to the app. Por exemplo, para ler o valor CaseID, use Param("CaseID").For example, to read the CaseID value, use Param("CaseID"). Para identificar rapidamente esse parâmetro, adicione um controle de Rótulo ao seu aplicativo.To quickly identify this parameter, add a Label control to your app. Defina a propriedade Text deste controle como Param("CaseID").Set the Text property of that control to Param("CaseID"). Se o usuário abrir o aplicativo na lista Todos os aplicativos, o valor estará vazio.If the user opens the app from the All apps list, the value is empty. Se o usuário abrir o aplicativo de outro local no dispositivo, o valor será preenchido com o valor CaseID.If the user opens the app from another location on the device, the value is populated with the CaseID value.

Definir a página inicialSet the start page

Você pode definir seu aplicativo para abrir, por exemplo, a página Detalhes do caso assim que o aplicativo abrir:You can set your app to open, for example, the Case details page as soon as the app opens:

  1. Adicione um controle de Temporizador e defina sua propriedade OnTimerEnd para esta fórmula:Add a Timer control, and set its OnTimerEnd property to this formula:
    Navigate(EditCase, ScreenTransition.None)Navigate(EditCase, ScreenTransition.None)
  2. (opcional) Oculte o controle do Temporizador ao configurar sua propriedade Visible como false.(optional) Hide the Timer control by setting its Visible property to false.
  3. Defina a propriedade OnVisible da tela como Timer.Start().Set the OnVisible property of the screen to Timer.Start().

Dica

É uma boa ideia criar uma primeira página exclusiva no aplicativo para a notificação:It's a good idea to create a unique first page in the app for the notification:

  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.Create an empty page that your app doesn't already open, add a Text Input control, and set its timer.Duration value.
  2. Quando você criar o aplicativo, defina o temporizador para um valor diferente de zero.When you create the app, set the timer to a non-zero value. Quando você estiver pronto para publicar o aplicativo, defina o valor como 0 para disparar imediatamente o temporizador.When you're ready to publish the app, set the value to 0 to immediately trigger the timer.

SintaxeSyntax

NomeName DescriçãoDescription
SendPushNotificationSendPushNotification Envie uma notificação por push para o aplicativo especificado nas configurações de conexão para a notificação.Sends a push notification to the app that's specified in the connection settings for the notification.

ParâmetrosParameters

NomeName TipoType DescriçãoDescription
destinatáriosrecipients Matriz de cadeia de caracteres, necessáriaString array, required Uma lista de:A list of:
  • Endereços de email para usuários ou grupos de segurançaEmail addresses for users or security groups
  • IDs de objeto para usuários ou grupos de segurança no Azure Active DirectoryObject IDs for users or security groups in Azure Active Directory
mensagemmessage Cadeia de caracteres, obrigatórioString, required O corpo da mensagem da notificação por push.The message body of the push notification.
openAppopenApp Booliano, opcionalBoolean, optional Se você deseja abrir o aplicativo quando o usuário toca na notificação por push.Whether to open the app when the user taps the push notification.
paramsparams Parâmetros, opcionalParameters, optional Os parâmetros de chave-valor para passar a notificação.Key-value parameters to pass with the notification. Eles podem ser processados futuramente no aplicativo para abrir uma página específica e carregar um estado específico.These can be further processed in the app to open a specific page and load a specific state.

Fórmulas de exemploSample formulas

Envie uma notificação básica.Send a basic notification.

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.Send a notification that opens an app and passes along specific parameters.

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 conhecidasKnown limitations

  • Atualmente, as notificações não são exibidas no PowerApps Mobile para Windows Phone.Currently, notifications aren't displayed on PowerApps Mobile for Windows Phone.
  • No momento, não fornecemos notificações por push para usuários que executam aplicativos somente em um navegador da Web.Currently, we don't provide push notifications for users who run apps only in a web browser.
  • As notificações mostram o ícone do PowerApps genérico em vez de um ícone de aplicativo específico.Notifications show the generic PowerApps icon instead of a specific app icon.
  • Quando você usar o Microsoft Flow, será possível enviar uma notificação por push somente para um destinatário por vez.When you use Microsoft Flow, you can send a push notification to only one recipient at a time.

Para obter informações de referência, consulte referência da Notificação do PowerApps.For reference information, see PowerApps Notification reference.