Skip to Content

Setting Up SMS Gateway — Step by Step

Setting Up SMS Gateway

Complete setup guide from installation to first test SMS

In this lesson you will walk through the complete setup of Varyshop SMS Gateway. By the end, your Android phone will be connected to Odoo and ready to send SMS campaigns automatically.

Step 1: Install the Module

1

Varyshop Docker Users

Go to Apps, remove the Apps filter, search for SMS Gateway, click Install.

2

Custom Odoo Installations

Install the Python dependency, copy the module to addons, restart Odoo, update module list.

MANUAL INSTALLATION
pip install qrcode[pil]
cp -r sms_gateway /path/to/odoo/addons/

Dependencies

The sms_gateway module requires sms, mass_mailing_sms, and phone_validation modules. They install automatically as dependencies.

Step 2: Create a Gateway Phone

1

Navigate

Go to Email Marketing, then SMS Gateway, then Gateway Phones, click New.

2

Required Fields

Name (e.g. Phone 1 - O2) and Phone Number in international format (+420777123456).

3

Optional Fields

Phone Number 2 (dual SIM), Daily Limit (500), SMS per Minute (100), Heartbeat Timeout (5).

4

Generate API Key

Click Save, then Generate API Key. A QR code appears containing server URL and API key.

QR CODE CONTENT
{
    "type": "sms_gateway",
    "url": "https://www.your-server.com",
    "api_key": "randomly_generated_secure_token"
}

Step 3: Install the Android App

Option A: Pre-built APK

Download the APK from the releases page and install. Enable Install from unknown sources in Android settings.

Option B: Build from Source

Clone the repo, run npm install, then npx expo prebuild and npx expo run:android.

Step 4: Pair the Phone

1

Open the App

Launch SMS Gateway on your Android phone.

2

Scan QR Code

Go to Settings tab, tap Scan QR Code, point camera at the QR in Odoo.

3

Automatic Connection

The app reads the server URL and API key, connects, and starts sending heartbeats.

Step 5: Verify Connection

Gateway Phone state changes from Offline to Online (green badge)
Last Heartbeat shows a recent timestamp
SIM card phone numbers are visible in the Odoo record
Send a test SMS to verify end-to-end delivery

Troubleshooting

Phone Stays Offline

Check internet connection, verify HTTPS URL, re-scan QR code, increase Heartbeat Timeout.

SMS Not Sending

Check SEND_SMS permission, verify daily limit, ensure recipient number is in international format.

Android Blocks After 30 SMS

Connect via USB and run: adb shell settings put global sms_outgoing_check_max_count 10000

Key Takeaway

Setting up the SMS Gateway takes five steps: install the module, create a gateway phone, install the Android app, scan the QR code to pair, and verify the connection. Once set up, your phone sends SMS campaigns automatically.

Kompletní návod: instalace modulu SMS Gateway, vytvoření gateway telefonu, instalace Android aplikace a spárování zařízení.

Rating
0 0

There are no comments for now.

to be the first to leave a comment.