Integrations

Attention

Before your setup the integrations, first you need to follow the instructions in the Mobile App Getting Started guide.

Google Integration

The mobile app offers integrations with several Google services: Analytics, Maps and Login. To generate keys for Google Maps and Google Login you first need to create a new Google Cloud Console project

Origami App Builder Integrations

Create a new Google Cloud Console Project

Google Analytics

You can add the Google Analytics tracking ID at any time, even after your app has been built and published to the App Store and Google Play. The tracking ID is a string like UA-000000-2.

Enabling Google APIs

For Maps and Login integrations on your app, we need to have the API keys before building the app binaries. Generating the keys requires several steps outlined below:

  1. Enabling the necessary API services for the project.
  2. Generating the API credentials
  3. Generating the Oath credentials
  4. Restricting the credentials

1. Enabling the necessary API services for the project

First you should enable the API services that your mobile app Google Console project will use. To do this, select the new console project you just created from the projects list at the top of the page, then click ENABLE APIS AND SERVICES

Origami App Builder Integrations

You can also access the API library page through the top-left menu icon, then APIs & Services ‣ Library

Origami App Builder Integrations

In the libraries page you will search for and individually enable the following APIs

  • Maps Static API
  • Maps SDK for Android
  • Maps SDK for iOS
  • Maps JavaScript API
  • Places API

Below you can see an example for enabling the Places API.

Origami App Builder Integrations

Now that you’ve enabled the necessary APIs, you can begin creating the credentials that will be used in the Mobile App.

2. Generating the Maps API credentials

Click on the top-left menu icon, then APIs & Services ‣ Credentials

Origami App Builder Integrations

For the maps integration you need to create a total of 3 Api Key credentials for HTTP, iOS and Android. For now you can create the credentials without restrictions. You should give each credential a name as suggested below:

  • Web Api Key
  • iOS Api Key
  • Android Api Key

3. Generating the OAuth credentials

Click on the top-left menu icon, then APIs & Services ‣ Credentials

When creating the OAuth credentials, you’ll be asked to set a product name in the consent screen as shown below. There’s no need to add any other information at this time, other than your app name.

Origami App Builder Integrations

After saving the consent form you’ll be able to select the Application type. You need to create a total of 3 credentials for Web application, Android and iOS. You can use the following names for each one:

  • Web Api Key
  • iOS Api Key
  • Android Api Key

For the iOS and Android keys you’ll need to enter additional information before you can save the form.

  • For the iOS bundle ID and Android package name settings, enter your app Bundle Id in the format com.yourdomain.www. Learn more.
  • For the Android Signing-certificate fingerprint use the SHA-1 certificate fingerprint. Learn more.

5. Completing the Integration Settings for your app

So now you have a total of 6 credentials, 3 API keys and 3 OAuth keys. In Origami App Builder, on your app’s Settings ‣ Integrations page:

  • Add your Google Analytics tracking ID. You can also do this after the app has been built and published.
  • Add the 3 map API keys that correspond to each setting.
  • Add the OAuth Web Api Key to the Google Registration/Login settting.

Finally, download the plist file for the Oauth iOS key and send it to us via ticket.

Facebook Integration

The mobile app supports user login and registration with Facebook accounts associated with an email address. There is no support for Facebook accounts that only have an phone number associated with them.

To setup the integration you need to create an new app on your Facebook Developer account or if your website already has a Facebook app you can use the same one.

  • If you are creating a new App it will ask you to add a new product. Select Facebook Login, skip the Quickstart and save.
  • Go to Settings ‣ Basic and scroll down to the bottom of the page.
  • Click + Add Platform, select iOS and fill in the Bundle ID as com.yourdomain.www and save.
  • Click + Add Platform, select Android and fill in the Google Play Package Name as com.yourdomain.www. For the Key Hash value use the one that we provide to you.

The resulting setup should look something like this:

Origami App Builder Integrations

Origami API Integrations Setup

If you are using the Google or Facebook Login integrations, to finalize the setup you also need to complete a few settings on the Origami API that is installed on your server. You can access the server using FTP and find the .env file on the API’s root folder. Keep in mind that the API has a public folder and a folder where the source code resides which is below the public folder. The .env file is located in the non-public folder.

You’ll need to fill in the following settings which you can find towards the bottom of the .env file:

#----------------------------------------------------------------------
# Social Networks
#----------------------------------------------------------------------

FACEBOOK_APP_ID=""
FACEBOOK_APP_SECRET=""

GOOGLE_CLIENT_ID="here you add the Web OAuth Key"
GOOGLE_CLIENT_ID_IOS="here you add the iOS Oauth Key"