Mobile Connect install
What is Mobile Connect?
Mobile Connect is a mobile application for Android that allows you to connect your phone to the BulkGate Portal use your mobile phone plan in the business communication with your customers. In practice, you can create an SMS campaign on the Portal and then send it to your phone by selecting the right sender, which will then distribute the SMS campaign to your customers from your mobile plan.
When it comes to Mobile Connect app, if the phone is not being used by the user (ie. screen is turned off), phone can switch to sleep mode (for saving battery life) which could cause SMS not being send on time or not at all. Phone must be in active state during usage - which means app must be on and active.
Sleep mode can also be set by default on some devices (depends on manufacturer, OS distribution, or agressivity of sleep mode when it comes to turning off applications).
If you send the first MT SMS (original message), the MO SMS (incoming message) is automatically assigned to your wallet. If you plan to send the first MO SMS without MT SMS, please contact us so that we can assign your default wallet in the system. This will automatically assign the MO SMS to the correct account.
Please note that when using the Mobile Connect app, this is a machine text messaging service. Mobile operators do not allow machine text messaging in some countries. Always follow your mobile operator's terms and conditions.
Installation
The first step is to download the Android application from here.
After the installation, the basic screen appears.
There you will see a Key
and PIN
which you subsequently enter into the Portal.
Linking the application
- Go to
Modules & APIs
in the left menu on BulkGate Portal - Select
Mobile Connect
in the list - Click
Create API
Now type the Key
and PIN
from the phone screen into the portal in the appropriate fields and click Save.
The installation is now completed.
Sender settings
- Go to the second step of the SMS campaign.
- On the right side of the SMS text editor, click on the
Sender Type
menu and selectMobile Connect
. - Another menu
Mobile Connector
will appear - Select which connector you want to use
Use
There is a big Start
button on the main screen that turns on and off sending of messages.
After activation, the application switches to the Idle
state, waiting for messages from the Portal.
Settings
The application has the following settings:
- Randomize delay - Allows to delay the sending of a message in the range of 1s-20s (user defines the interval e.g. 5s-18s).
- Process SMS replies - All responses received by the phone are transferred to the Portal.
- Support long messages - Messages that exceed 160 characters (or 70 in Unicode) are sent in batch (split message into more 160/70 character messages), and the recipient's phone receives more parts of the message separately.
The Sent daily
/Sent total
statistics are calculated according to the number of text messages (i.e. 1 message received from the API and divided into several SMS messages will be counted as 1 message in the statistics).
Sending
To send SMS from the application, it is necessary to select Mobile Connect
sender type in the campaign and then the appropriate mobile phone. Then everything happens just like with a regular campaign.
If the application is sending, it is in the Running
state.
PUSH Notifications
The app can only receive messages to your phone without forwarding them. Click on the bell in the top right menu to get to the list of received messages.
API settings
To start using the Mobile Connect API you need:
- Install the Mobile Connect App. Download here.
- Create an API on the BulkGate Portal
- Choose Sender ID type:
sender_iD: gMobile
. - Insert key:
sender_ID_value: KEY
, where you get theKEY
from the Mobile Connect App in the phone you want to use to send the message.
Example of a complete HTTP Advanced API v2 request (applies to HTTP Advanced API v1 and v2 (transactional and marketing), and HTTP Simple API):
POST /api/2.0/advanced/transactional HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json
Cache-Control: no-cache
{
"application_id": "APPLICATION_ID",
"application_token": "APPLICATION_TOKEN",
"number": "420111222333",
"text": "example text <first_name>",
"variables": {"first_name": "John Doe"},
"country": "cz",
"schedule": "2018-05-14T18:30:00-01:00",
"channel": {
"sms": {
"sender_id": "gMobile",
"sender_id_value": "KEY",
"unicode": true,
"text": "example text"
}
}
}