Outsystems

Instalando o plugin Pushwoosh

Comece instalando o plugin Pushwoosh a partir do OutSystems Forge. A maneira mais rápida de fazer isso é ir para a aba OutSystems em seu ambiente de desenvolvimento e instalá-lo a partir de lá.

Configurando o Pushwoosh

Você precisará configurar o Pushwoosh para cada uma das plataformas que você irá suportar. Assim que sua configuração estiver concluída, você terá um Código de Aplicação (Application Code) do Pushwoosh que será usado com seu plugin.

Para iOS

Aprenda como configurar o Pushwoosh para iOS.

Para Android

Aprenda como configurar o Pushwoosh para Android.

Adicionando o plugin Pushwoosh à sua aplicação

1. Em sua aplicação, use “Manage Dependencies…” para adicionar uma referência ao plugin Pushwoosh.

2. Adicione o bloco “PushwooshNotifications” a:

   • O bloco “Layout” se sua aplicação não tiver login
   • O bloco “LayoutBlank” se sua aplicação tiver login

   Ao adicionar o bloco “PushwooshNotifications”, evite adicioná-lo dentro de placeholders, pois alguns estão disponíveis apenas em tempo de design e, em tempo de execução, o Pushwoosh não funcionará.

3. Defina os seguintes parâmetros no PushwooshNotifications:

   • PushwooshApplicationCode: O Código Pushwoosh que você obteve após criar a aplicação no Pushwoosh.
   • FCMSenderId: O número de identificação que você obteve ao configurar o Android. Você pode deixar isso em branco se sua aplicação estiver disponível apenas para iOS.
   • NotificationReceivedEvent (Opcional): Um evento que é chamado quando uma notificação é recebida enquanto a aplicação está em primeiro plano.
   • NotificationOpenedEvent (Opcional): Um evento que é chamado quando um usuário clica em uma notificação em seu dispositivo.

Se você estiver usando o plugin Pushwoosh em seu aplicativo Android, faça o seguinte:

1. Obtenha o google-services.json do Firebase. O nome do pacote dos serviços do Google deve corresponder ao identificador do aplicativo da aplicação OutSystems que está sendo construída.
2. Crie um arquivo zip contendo o google-services.json na raiz.
3. Faça o upload do arquivo “google-services.zip” da etapa anterior para sua aplicação OutSystems e certifique-se de:
   • Definir o “Name” como “google-services.zip”
   • Definir “Deploy to Target Directory” como “google-services”

Para que seu dispositivo receba notificações push, você precisará registrá-lo. Se seus usuários precisarem fazer login para usar a aplicação, vá para a tela “Login” e edite a ação “Login”.

Adicione o código para registrar o dispositivo após a ação “DoLogin”. Deve se parecer com algo assim:

Se sua aplicação não tiver login, você pode adicionar este código ao evento OnInitializeOver no bloco PushwooshNotifications.

Neste manipulador de eventos, chame a ação RegisterDevice.

Se você estiver gerando um aplicativo móvel iOS usando um certificado de desenvolvedor, precisará adicionar uma preferência à propriedade Extensibility Configurations do seu módulo OutSystems:

{
  "preferences": {
    "global": [
      {
        "name": "aps-environment",
        "value": "development"
      }
    ]
  }
}

Esta preferência será adicionada ao seu arquivo de entitlements (saiba mais sobre entitlements na documentação do Apple Developer).

Se você estiver gerando um aplicativo móvel iOS usando um certificado de produção, não precisará especificar nenhuma preferência, pois o valor padrão da preferência aps-environment no OutSystems é production.

Sua aplicação agora está pronta para receber notificações push. Configure e gere seu aplicativo móvel e instale-o em seu dispositivo. Neste ponto, você pode usar a interface do Pushwoosh para enviar notificações para seu aplicativo e garantir que tudo esteja configurado corretamente. Observe que você não verá uma notificação se o aplicativo estiver em execução. Em vez disso, o evento NotificationReceivedEvent é acionado imediatamente.

Enviando notificações

Para enviar notificações, você precisa de um Token de Acesso à API do Pushwoosh. Crie um acessando o console do Pushwoosh, vá para “API Access” e clique em “Generate new access token”.

Para enviar uma notificação para todos os dispositivos, use a ação SendPushNotificationToAll.

Esta ação recebe os seguintes parâmetros:

• PushwooshApplicationCode: O Código Pushwoosh que você obteve após criar a aplicação no Pushwoosh.
• ApiAccessToken: O Token de Acesso à API do Pushwoosh obtido anteriormente.
• Message: O texto da mensagem que você deseja enviar.
• Badge: Um número que é exibido no ícone da aplicação iOS.
• Deeplink: Um deep link para enviar com a notificação. Aprenda como definir deep links.

Por exemplo, se você usar esta ação para enviar a mensagem “Hello from OutSystems” para uma aplicação chamada “PushTest”, o seguinte seria mostrado no iOS:

Informações adicionais

• Se o seu aplicativo estiver em execução, a notificação não aparecerá no dispositivo. Em vez disso, ela é enviada para o aplicativo e o evento NotificationReceivedEvent é acionado. Você precisará definir o que deseja que o aplicativo faça nessa situação.
• As notificações push podem levar um tempo para se tornarem ativas. Se você não vir as notificações chegando, espere alguns minutos antes de solucionar outros problemas.

Compartilhe seu feedback conosco

Seu feedback nos ajuda a criar uma experiência melhor, então adoraríamos ouvir de você se tiver algum problema durante o processo de integração do SDK. Se você enfrentar alguma dificuldade, não hesite em compartilhar suas opiniões conosco através deste formulário.