prerequisites.md

Prerequisites

First of all, you have to obtain prerequisites from Google and Apple (optionaly), which are neccesary to setup you Project in Notimatica.

{.toc}

1. Google Chrome Support (GCM)
2. Apple Safari Support (APN)

{#google-chrome-support}

Google Chrome Support (GCM)

To support Google Chrome you need to create an app in Google Services, obtain Google Server API Key and Google Project Number.

{.step-text}

• Go to Google Services Wizard

  Go to – https://developers.google.com/mobile/add?platform=android&cntapi=gcm

• Choose App name and Android package name

  Type new App name (it can be the name of your website) or select an existing app from the dropdown. We don't need the Android package name, but you have to type something here to continue like test.test as shown on the screen below. Finally, click "Choose and configure services".

  {.img-rounded .img-shadow .img-responsive .center-block}

  Please, wait for the project to be created.

• Click "Enable Google Cloud Messaging"

  {.img-rounded .img-shadow .img-responsive .center-block}

• Save the two values

  You'll need Server API Key and Sender ID (also known as the Project Number) a bit later in Project Setup Guide.

  {.img-rounded .img-shadow .img-responsive .center-block}

• Congratulations

  Now you're ready to enable Google Chrome Support in Notimatica.

  The next step is to install JavaScript SDK on your website with the help of SDK Installation Guide.

{#apple-safari-support}

Apple Safari Support (APNS)

Safari Support is Optional

• Using Google Chrome and Mozilla Firefox as your only web push notification platform is totally fine as they have 80% market share combined.
• iOS and Windows are currently not supported

{#apple-developer-license}

Apple Developer License

• To complete this guide you need to have an active iOS or Mac OS developer account in the Apple Developer Program.

{#website-push-id-certificate} {.step-text}

• Go to Website Push IDs section of Provisioning Portal.

  Go to – https://developer.apple.com/account/ios/identifier/websitePushId/landing

  {.img-rounded .img-shadow .img-responsive .center-block}

• Create new Website Push ID

  Type new Website Push ID Description (it can be the name of your website). Next, type Identifier as a reverse-domain name of your website, such as web.com.your-domain (it should start with web. prefix). Finally, click "Continue".

  {.img-rounded .img-shadow .img-responsive .center-block}

  Click "Register"

  {.img-rounded .img-shadow .img-responsive .center-block}

• Go to Certificates section on Provisioning Portal.

  Go to – https://developer.apple.com/account/ios/certificate/

  {.img-rounded .img-shadow .img-responsive .center-block}

• Create new Certificate

  Choose ‘Website Push ID Certificate’ option.

  {.img-rounded .img-shadow .img-responsive .center-block}

• Select Website Рush ID

  Сhoose the Website Push ID which we created a moment ago and click "Continue".

  {.img-rounded .img-shadow .img-responsive .center-block}

• Download the Website Рush ID Сertificate

  {.img-rounded .img-shadow .img-responsive .center-block}

• Launch Keychain Access app

  {.center-block}

• Add Certificate file to Keychain Access.

  Make sure you've placed it into the "Login" keychain under "Certificates" category.

• Export the Private Key file

  In context menu of newly added certificate click "Export".

  {.img-responsive .center-block}

• Choose the directory to save Private Key file

  {.img-responsive .center-block}

• Set Private Key password

  You'll be asked to create a password. Please, leave both fields blank.

  {.img-responsive .center-block}

• Hurray!

  It wasn't easy, but you've nailed it! Now you have prerequisites for Apple Safari Support in Notimatica.

  The next step is to install JavaScript SDK on your website with the help of SDK Installation Guide.