Skip to content

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 (61d5a80dde04b.png).

  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.

61d5a80f31db9.png

3. Install the Ibexa Connect application.

61d5a810b86b7.png

4. Open the installed application.

61d5a81228eb3.jpg

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.

61d5a814d5125.png

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.

61d5a816dfa60.png

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.

61d5a81836b16.png

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.

61d5a8199285f.png
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.

61d5a81b2dae8.png

3. Tap My first button.

61d5a81d18fa4.png

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.

61d5a81ecaf15.png

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.

61d5a8207ca33.png

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

61d5a822149b0.png

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.

61d5a8241adc8.jpg

2. Open the Widgets tab.

61d5a825c5496.jpg

3. Find the Ibexa Connect app.

61d5a827778f6.png

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.

61d5a8299ec2f.jpg

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.

61d5a82b5c0cc.png

61d5a83094503.png

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

61d5a831c945b.png

Tap this icon to turn the flashlight on your device.

61d5a816dfa60.png

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:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
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.

    2019-09-10-14_57_43-screenshot_20190909-130355.png

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

    2019-09-10-15_08_46-screenshot_20190910-150540.png

  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.

    untitled.png

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