Skip to Content

Nimba SMS

by
Odoo
In-App Purchases
v 19.0 Third Party 1
Download for v 19.0 Deploy on Odoo.sh
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies Discuss (mail)
Lines of code 667
Technical Name nimbasms
LicenseLGPL-3
Websitehttps://github.com/nimbasms/odoo-integration
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies Discuss (mail)
Lines of code 667
Technical Name nimbasms
LicenseLGPL-3
Websitehttps://github.com/nimbasms/odoo-integration

Nimba SMS Provider for Odoo

Send SMS directly from Odoo using Nimba SMS, a reliable SMS provider with coverage across Guinea and other African countries. This module integrates seamlessly with Odoo's SMS infrastructure using the official Nimba SMS Python SDK.

Note: This module requires an external service (Nimba SMS) to function. You will need to create an account at www.nimbasms.com and configure your API credentials. For API documentation, visit developers.nimbasms.com.
Data Privacy: When using this module, SMS messages, recipient phone numbers, and delivery status information are sent to Nimba SMS service for processing and delivery. This is necessary for the module to function. Please review Nimba SMS Privacy Policy for information on how your data is handled.

Key Features

  • Official SDK Integration - Uses the official Nimba SMS Python SDK for reliable communication
  • Batch Sending - Send SMS to multiple recipients in a single request, perfect for marketing campaigns
  • Delivery Tracking - Real-time delivery status updates via webhooks
  • Multi-tenant Support - Per-database configuration for multi-company setups
  • Phone Number Validation - Automatic validation and formatting for African countries (default: Guinea)
  • Account Management - Easy configuration wizard with connection testing
  • Error Handling - Clear error messages and comprehensive troubleshooting
  • Balance Checking - Verify your account balance before sending

Installation

1. Install Python Dependencies

pip install nimbasms phonenumbers

2. Install the Module

  1. Place the module in your Odoo addons directory
  2. Restart Odoo server
  3. Go to Apps menu
  4. Click Update Apps List
  5. Search for "Nimba SMS"
  6. Click Install

Configuration

Step 1: Get Your Nimba SMS Credentials

  1. Sign up at www.nimbasms.com
  2. Log in to your Nimba SMS dashboard
  3. Navigate to Dashboard → Développeurs or visit developers.nimbasms.com for API documentation
  4. Copy your Service ID and Secret Token
  5. Register and get your Sender Name approved (usually takes 24-48 hours)
  6. Add credits to your account

Step 2: Configure in Odoo

  1. Go to Settings → General Settings
  2. Scroll to the SMS section
  3. Select "Nimba SMS" as your SMS Provider
  4. Click the "Manage Account" button
  5. Enter your Service ID, Secret Token, and Sender Name
  6. Click "Test Connection" to verify your credentials
  7. Click "Save" to apply the configuration

Usage

Sending SMS

Once configured, you can send SMS from anywhere in Odoo:

  • From Contacts: Open any contact record and click the SMS icon
  • From Marketing Campaigns: Create SMS marketing campaigns and send to multiple recipients
  • From Other Modules: Any module that supports SMS functionality (Sales, CRM, Events, etc.)

Phone Number Format

Phone numbers should be in international E.164 format:

  • ✅ Correct: +224620000000 (Guinea)
  • ✅ Correct: 624000000 (Guinea, auto-formatted)

The module automatically formats numbers when possible.

Webhook Configuration (Optional)

Webhooks enable real-time delivery status updates from Nimba SMS to Odoo.

Setup

  1. Get your webhook URL: https://your-odoo-domain.com/sms/webhook/nimba
  2. Log in to Nimba SMS Portal
  3. Navigate to API → Webhooks or check developers.nimbasms.com for documentation
  4. Enter your webhook URL and save

Note: Webhooks work automatically across all databases in multi-tenant setups.

Requirements

  • Odoo 19.0 or higher
  • Python packages: nimbasms, phonenumbers
  • Nimba SMS account (sign up at www.nimbasms.com)

Troubleshooting

Common Issues

  • SDK not installed: Run pip install nimbasms phonenumbers and restart Odoo
  • Invalid credentials: Double-check Service ID and Secret Token in Dashboard → Développeurs
  • Invalid Sender Name: Ensure Sender Name is approved and spelling matches exactly
  • Insufficient balance: Top up your Nimba SMS account
  • Invalid phone number: Use international format: +224620000000

Check Logs

Go to Settings → Technical → Logging and filter by "nimba" or "sms" to see error messages.

Important:
  • Your Sender Name must be approved by Nimba SMS before use
  • Test your connection before sending SMS to customers
  • Keep your API credentials secure
  • Ensure you have sufficient account balance

Support

For issues, questions, or support requests:

Nimba SMS Provider for Odoo

This module integrates Nimba SMS (https://www.nimbasms.com/) into Odoo's SMS infrastructure using the official Python SDK.

Data Privacy

When using this module, SMS messages, recipient phone numbers, and delivery status information are sent to Nimba SMS service for processing and delivery. This is necessary for the module to function. Please review the Nimba SMS Privacy Policy for information on how your data is handled.

Features

  • Send SMS through official Nimba SMS SDK
  • Batch sending - multiple recipients in one request
  • Webhook support for delivery status callbacks
  • Multi-tenant support with per-database configuration
  • Phone number validation for African countries (default: Guinea)
  • Account balance checking

Installation

  1. Install Python dependencies:

    pip install nimbasms phonenumbers

  2. Place the module in your Odoo addons directory

  3. Restart Odoo server

  4. Go to Apps menu, click Update Apps List, search for "Nimba SMS" and click Install

Configuration

Step 1: Get Your Nimba SMS Credentials

  1. Sign up at https://www.nimbasms.com
  2. Log in to your Nimba SMS dashboard
  3. Navigate to Dashboard → Développeurs or visit https://developers.nimbasms.com for API documentation
  4. Copy your Service ID and Secret Token
  5. Register and get your Sender Name approved (usually takes 24-48 hours)
  6. Add credits to your account

Step 2: Configure in Odoo

  1. Go to Settings → General Settings
  2. Scroll to the SMS section
  3. Select "Nimba SMS" as your SMS Provider
  4. Click the "Manage Account" button
  5. Enter your Service ID, Secret Token, and Sender Name
  6. Click "Test Connection" to verify your credentials
  7. Click "Save" to apply the configuration

Usage

Sending SMS

Once configured, you can send SMS from anywhere in Odoo:

  • From Contacts: Open any contact record and click the SMS icon
  • From Marketing Campaigns: Create SMS marketing campaigns and send to multiple recipients
  • From Other Modules: Any module that supports SMS functionality (Sales, CRM, Events, etc.)

Phone Number Format

Phone numbers should be in international E.164 format:

  • ✅ Correct: +224620000000 (Guinea)
  • ✅ Correct: 624000000 (Guinea, auto-formatted)

The module automatically formats numbers when possible.

Webhook Configuration (Optional)

Webhooks enable real-time delivery status updates from Nimba SMS to Odoo.

Setup:

  1. Get your webhook URL: https://your-odoo-domain.com/sms/webhook/nimba
  2. Log in to https://www.nimbasms.com
  3. Navigate to API → Webhooks
  4. Enter your webhook URL and save

Note: Webhooks work automatically across all databases in multi-tenant setups.

Requirements

  • Odoo 19.0 or higher
  • Python packages: nimbasms, phonenumbers
  • Nimba SMS account (sign up at https://www.nimbasms.com)

Troubleshooting

Common Issues

  • SDK not installed: Run pip install nimbasms phonenumbers and restart Odoo
  • Invalid credentials: Double-check Service ID and Secret Token in Dashboard → Développeurs
  • Invalid Sender Name: Ensure Sender Name is approved and spelling matches exactly
  • Insufficient balance: Top up your Nimba SMS account
  • Invalid phone number: Use international format: +224620000000

Check Logs

Go to Settings → Technical → Logging and filter by "nimba" or "sms" to see error messages.

Support

  • Email: support@nimbasms.com
  • Website: https://www.nimbasms.com
  • API Documentation: https://developers.nimbasms.com

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.
Please choose a rating from 1 to 5 for this module.
There are no ratings yet!
Here you go !
by
Harouna Diallo
on 12/25/25, 3:04 PM Author