• Documentation >
• Apps >
• Communication >
• Android

Android

Getting Started with Android App

The Android App modules allow you to monitor events performed by your Android phone and/or perform various actions using your Android phone device.

Prerequisites

• Android device (Android 7.0 and higher)

• Ibexa Connect App for Android installed on your phone

As of the beginning of 2019, Google has restricted applications published on Google Play that gives access to:

• SMS permissions

• Call logs

The Ibexa Connect app you have downloaded from Google Play is also subject to these restrictions.

Installation of the Non-restricted Ibexa Connect App for Android

• See the comparison of functions in the restricted and non-restricted app versions.

In order to install the Ibexa Connect app with no restrictions, follow the steps below:

Note

All of your settings and scenarios made using the previously installed Ibexa Connect app from Google Play will remain untouched and functional in the new non-restricted Ibexa Connect app for Android.

1. Tap on the following download link, and download the APK file.

Ibexa Connect app for Android (8.5 MB)

2. Open the downloaded integromat.apk file.

Caution

Some phones (typically Huawei devices) may detect a possible virus in the APK file. There might be various reasons for this to happen. But as we investigated – most likely we are blacklisted by Huawei's antivirus system.

Huawei devices, unlike other OEMs, pre-installed an antivirus into their system and uses Virustotal API (https://developers.virustotal.com/v3.0/reference) which may falsely detect Ibexa Connect's APK file as malware. All other OEMs use Google Play Protect anti-malware service where the Ibexa Connect app is verified.

If you are in doubt whether the file contains suspicious software, scan your device using Google Play Protect:

1. Open the Google Play Store app ().

2. At the top right, tap the profile icon.

3. Tap Play Protect.

4. Tap the Scan button to scan your device for malware and/or viruses.

3. Switch the button to allow the Ibexa Connect app installation.

3. Install the Ibexa Connect application.

4. Open the installed application.

5. Log in, or scan the QR code, and proceed to the application.

6. The application is now ready to use.

Installation of the Restricted Ibexa Connect App for Android on Google Play

You can still install the Ibexa Connect app for Android on Google Play.

Using the App

The app is designed to run in the background and perform selected functions.

On the main screen, you can switch between the following options:

• Events: Contains a list of captured events that have not yet been sent to the server. The app synchronizes events automatically. The synchronization is performed in the shortest possible time interval supported by the operating system. While for Android devices, events are sent immediately, for iOS devices, it can take several hours to send events. The automatic synchronization also occurs every time you open the app. To start the synchronization manually, drag the list of events down.

• History: Contains all events that have already been sent to the server and those that generated an error when being sent. By clicking on an event, you can view its details, including any errors that have possibly occurred.

• Buttons: Buttons allow you to run a scenario by tapping the associated button on your Android device.

• Scanner: Use the barcode or QR code scanner to scan respective codes and trigger the scenario.

• Settings: Settings of the Ibexa Connect for Android app features.

Modules are divided into two categories: triggers and actions. Triggers have the ability to listen to the connected device and start the scenario whenever the device generates a new event. Actions, on the other hand, create new items in the device. Select the desired trigger or action, and add it to your scenario. In the configuration window of the module, select the desired module and, where appropriate, set up other parameters.

Setting Up the Ibexa Connect for Android App

Before you start building a scenario using the Android app modules, it is necessary to set up particular functions on your Ibexa Connect for Android app to allow the app access to your phone's corresponding functions.

General Settings

Synchronize events in the order they were created	This option allows you to keep the synchronization order even if the scenario is not available. No new events are processed until the first event in the queue is processed.
Send photos only over WiFi	When enabled, photos will be sent only when your device is connected to the Internet via WiFi. It prevents high data consumption when connected via the mobile data network.
Dark Mode	You can switch the Ibexa Connect app for Android to Dark Mode or Light Mode. Select one of the options: Always light: Switches the app to the Light Mode. Always dark: Switches the app to the Dark Mode. Follow system: The mode is selected according to your system settings.

QR / Barcode Scanner

Same code scan delay

Set the period when the same code is scanned again.

Default description

Enter the description to be added to all scanned codes if the adding of description is enabled during the code scanning.

Photos

Triggers

Send new photos to Ibexa Connect	When enabled, every time a photo is taken, the app sends the photo to Ibexa Connect, and then triggers the New Photo module.

Actions

Allow Ibexa Connect to import photos to the device	Enable this option to allow the use of the Save a Photo module.
Take photo	Allows you to use the Take a Photo module.

GPS

Triggers

Track GPS location	Allows you to use the Watch location changes module that triggers when the device changes location. Use the Change button to define the distance that has to be changed to trigger the event.
Entered/left area	Activate this function to send information when the device enters and/or leaves the specified area to the Watch entrances to/exits from a geofence area module. Please note that you must spend a couple of minutes outside/inside the geofence area to trigger this function.

WiFi

Triggers

Wifi connected event	This function triggers the WiFi connection module in your scenario when the device connects to the WiFi network.
Wifi disconnected event	This function triggers the WiFi disconnection module when the device disconnects from the WiFi network.

Actions

Enable WiFi	This function allows you to use the Enable Wifi module in your scenario.
Disable WiFi	This function allows you to use the Disable Wifi module in your scenario.

Bluetooth

Triggers

Bluetooth enabled	This function triggers the Watch Bluetooth activations module in your scenario when Bluetooth is enabled on your device.
Bluetooth disabled	This function triggers the Watch Bluetooth Deactivations module in your scenario when Bluetooth is disabled on your device.
Device connected	This function triggers the Watch connections from Bluetooth Devices module in your scenario when your Bluetooth device connects to another device.
Device disconnected	This function triggers the Watch Disconnections from Bluetooth Devices module in your scenario when your Bluetooth device disconnects from another device.

Actions

Enable bluetooth	This function allows you to use the Enable Bluetooth module in your scenario to turn on Bluetooth on your device.
Disable bluetooth	This function allows you to use the Disable Bluetooth module in your scenario to turn off Bluetooth on your device.

Calls

Call functions (except Change a Ring Mode) are available for the non-restricted Ibexa Connect for Android app only.

Triggers

Incoming call	This function triggers the Watch Incoming Calls module in your scenario when your device registers an incoming call.
Incoming call ended	This function triggers the Watch Completed Incoming Calls module in your scenario when an incoming call is finished.
Outgoing call	This function triggers the Watch Outgoing Calls module in your scenario when your device makes an outgoing call.
Outgoing call ended	This function triggers the Watch Completed Outgoing Calls module in your scenario when an outgoing call is finished.

Actions

Prepare phone call	This function allows you to use the Prepare a Phone Call module in your scenario to display the pre-defined phone number in the phone's dialer app.
Make Call	This function allows you to use the Make a Call module in your scenario to dial the phone number specified in the Make a Call module.
Change ringmode	This function allows you to use the Change a Ring Mode module in your scenario to switch the ring mode between silent, vibration, and loud ring modes.

SMS

Caution

SMS functions are available for the non-restricted Ibexa Connect for Android app only.

SMS functions are available for the non-restricted Ibexa Connect for Android app only.

Triggers

New SMS received	This function triggers the Watch Text Messages module in your scenario when your device receives an SMS.
New SMS sent	This function triggers the Sent SMS module in your scenario when your device sends an SMS.

Actions

Send SMS	This function allows you to use the Send Text Message module in your scenario to send a text message. The recipient number and the text message content must be entered into the respective fields of the Send Text Message module.

Web

Actions

Open websites	This function allows you to use the Open a Web Browser module in your scenario to open a specified URL address in a web browser on your device.
Close websites	This function allows you to use the Close a Web Browser module in your scenario to close a web browser on your device.

Running a scenario Using the Ibexa Connect for Android App

You can run the Ibexa Connect scenario by tapping the button created in the Android app.

The button can be placed as a widget on your Android desktop screen.

Creating the Button in the Android App

1. Open the Ibexa Connect for the Android app.

2. Tap on the Buttons option.

3. Tap My first button.

4. Enter the name for your button and ID (you will need this for your Ibexa Connect module), and specify the button properties, if needed.

Save the button by tapping the Save option in the top-right corner.

5. Go to the Ibexa Connect scenario, and add the Watch Button module to the first position in your scenario.

6. Select the device where you have created the button, and enter the ID of the button.

7. Go back to your Ibexa Connect for Android app, and tap the button you have created.

The Watch Button module in your scenario is triggered. Now, you can use this function to trigger your scenario via your mobile device.

Placing the Button on Your Android Screen

1. Tap and hold anywhere on your Android screen to open the Manage Home menu.

Tap on the Apps & widgets option.

2. Open the Widgets tab.

3. Find the Ibexa Connect app.

4. Touch and hold the Ibexa Connect widget to pick it up. Then, move to the desired phone screen, and release it.

5. The button (or buttons) are now placed on your Android screen and ready to execute the scenario.

Scanner

Barcode and QR code scanner.

Allows you to send barcode/QR code information to the module, and trigger the Ibexa Connect scenario (using Watch Barcode/QR Code module) by scanning a barcode or QR code.

Tap this icon to switch between the back and front camera.

Tap this icon to turn the flashlight on your device.

Tap this icon to add the description immediately after the code is captured. The default description from QR/Barcode Scanner Settings is pre-filled when specified.

The Barcode and QR code reader supports the following code formats:

Code 128 (FORMAT_CODE_128)
Code 39 (FORMAT_CODE_39)
Code 93 (FORMAT_CODE_93)
Codabar (FORMAT_CODABAR)
EAN-13 (FORMAT_EAN_13)
EAN-8 (FORMAT_EAN_8)
ITF (FORMAT_ITF)
UPC-A (FORMAT_UPC_A)
UPC-E (FORMAT_UPC_E)
QR Code (FORMAT_QR_CODE)
PDF417 (FORMAT_PDF417)
Aztec (FORMAT_AZTEC)
Data Matrix (FORMAT_DATA_MATRIX)

Versions Comparison

	Non-restricted Ibexa Connect app	Restricted Ibexa Connect app on Google Play
Triggers
Watch Text Messages	Yes	NO
Sent SMS	Yes	NO
Watch Incoming Calls	Yes	NO
Watch Completed Incoming Calls	Yes	NO
Watch Outgoing Calls	Yes	NO
Watch Completed Outgoing Calls	Yes	NO
Barcode / QR code scanner	Yes	Yes
Watch Bluetooth Activations	Yes	Yes
Watch Bluetooth Deactivations	Yes	Yes
Watch Connections to Bluetooth Devices	Yes	Yes
Watch Disconnections from Bluetooth Devices	Yes	Yes
Watch Entrances to/Exits from a Geofence Area	Yes	Yes
Watch Location Changes	Yes	Yes
New Photo	Yes	Yes
WiFi Connection	Yes	Yes
WiFi Disconnection	Yes	Yes
Actions
Send Text message	Yes	NO
Prepare a Phone Call	Yes	NO
Make a Call	Yes	NO
Save a Photo	Yes	Yes
Close a Web Browser	Yes	Yes
Disable Bluetooth	Yes	Yes
Disable WiFi	Yes	Yes
Enable Bluetooth	Yes	Yes
Enable WiFi	Yes	Yes
Change a Ring Mode	Yes	Yes
Open a Web Browser	Yes	Yes
Send a Push Notification	Yes	Yes
Take a Photo	Yes	Yes

Security

The traffic between the mobile device and Ibexa Connect is secured by the Transport Layer Secure (TLS) encryption protocol. The authorization is based on a client certificate that is generated automatically when you log on. The certificate’s private key is generated on the device and securely stored in the System Keychain.

Troubleshooting

If you experience an issue with the app, send us a bug report:

1. Open the app, and click on the settings (cog wheel) icon in the bottom-right corner.

   

2. Scroll down until the Show log link appears in the bottom-left corner, and click on the link.

   

3. Click on the send (paper plane) icon in the top-right corner to open your email client.

4. Write your issue in the body of the email.

5. Click on the send (paper plane) icon in the top-right corner to send us the bug report.

   

Known Issues

Received SMS doesn't trigger My scenario:

• Go to Settings

• Open Apps & notifications

• Open App permissions

• Go to SMS

• In the list of apps, find Ibexa Connect, and turn it off then on again.

This should make the app request the required scope for the received SMS.

Learn More About Mobile Apps

Mobile Apps - Introduction

SMS Automatization - Use cases

Call Management - Use cases

GPS - Use cases

Integrations - Android

Integrations - iOS t.com/en/case-study/gps)

Integrations - Android

Integrations - iOS