Mobile apps

To access the mobile applications section, click configure in the main menu and then click the mobile applications panel. The Mobile applications management page displays, including the mobile applications list (figure 1).

Click the appropriate link below to scroll to the information you require:

Overview

All mobile application settings are configured and managed from the Mobile applications management page (figure 1).

Figure 1: Example of the Mobile applications management page with the mobile applications list

An application is displayed in the mobile applications list with the following settings:

  • ID
    An identifier for the application in Contactsend.
  • Code
    A unique alphanumeric string, which is used in the Application Code field of the database. It identifies the application and the contacts (users) who use it. The string can include up to a maximum of 155 characters, consisting of letters, numbers and periods or dots (.).
  • Name
    The name of the application.
  • Description
    A short description of the app, which was entered in the appropriate field when it was created.
  • Environment
    Push applications can be published for two environments:

    • Production
      Applications that are published in the appropriate stores.
    • Development
      Applications that are not yet published, which are used for testing and/or development.

Note:
Currently, an application can only be configured for Production or Development. Once this setting has been defined, you cannot change it yourself. You need support from the Contactlab team and, for example, a new certificate needs to be created and activated.

  • Vendor
    The channels that are enabled for the application. For an application to be enabled for deliveries, a certificate is required for uploading to Apple, or an API key is needed for Google.
    The color of the relevant icon in the Vendor column of the mobile applications list shows the status of the channel, as follows:

    • Gray
      The vendor is not configured.
    • Yellow
      The vendor is configured, but waiting to be enabled. Every vendor must be enabled by out team once a certificate and/or API key have been loaded or changed.
    • Green
      The vendor is configured and ready to be used.

Creating a new mobile application

To create a new application, do the following: 

  1. Click + Add application on the Mobile applications management page.
    The Add new application page displays.

push_add

Figure 2: The Add new application page

    1. Under Environment, select whether the application is for Production (published to an app store) or Development (for test/development use).
      IMPORTANT:
      This defines the use of different Push transmission channels. Making the wrong selection here, may result in incorrect reception of the Push messages.
    2. Under Code, enter the unique alphanumeric code for the mobile application.
      Up to a maximum of 155 characters, consisting of letters, numbers and periods or dots (.).
    3. Under Name, enter an appropriate name for the application.
    4. Under Description, add a short description, if required.
    5. Under User database, select the appropriate database from the drop-down list.
      Only databases that are configured for the Push channel display.
      Note:
      Because a group is not used for Push channels, a database needs to be associated with each application.
    6. In the next section, do the following, as required:
      Note:
      At least one vendor must be configured.

      1. Under iOS, upload the appropriate Certificate in P12 format, and enter the relevant Password.

      and/or:

      1. Under Android, enter the appropriate API key.
    7. When you are finished, click +Insert.
      The application is created and added to the mobile applications list.

Filter creation

When the application is created, three filters are automatically generated for the appropriate database (figure 3).  These help you identify the contacts (users) who use a specific application, when there are contacts in the database who use different ones.

clab_conf_applicazionemobile_filtri

Figure 3: Example of the Push channel filters
The following filters are created:

  • All application users.
     Name of the application
    .
  • Apple users.
     Name of the application APN
    .
  • Google users.
     Name of the application GCM
    .

In addition, when you create a filter for a database with the Push channel enabled, a panel displays (figure 4) that enables you to associate the filter exclusively with a specific application and/or vendor.

See User dbViewing and managing an existing database and filtersUsing the filter management panelCreating a new filter for more about creating a filter.

Figure 4: The filter creation Push channel selection panel