Can I replace my MultiModem® iSMS smoothly with a SMS Gateway?



The 2G network cut-off and various functions of the SMS Gateway are good reasons to think about a change. We strive to make the change as easy as possible.


At the beginning follow our Quick Start Guide for the first steps with the SMS Gateway.


Setting up users


In the follow-up you should set up the users for a seamlessly replace of the MultiModem® iSMS. Log in at the web interface of your MultiModem® iSMS. You will find an overview of the existing users under SMS Services - Users.


Instructions how to set up these users at the SMS Gateway you will find here.


Grant at least the following permissions to send SMS via the web interface and the HTTP API:


  • Access to the web interface
  • Access to the HTTP API


You should also import the contacts of the addressbook of your MultiModem® iSMS (SMS Services - Address Book) and groups (SMS Services - Groups).




All functions of the HTTP API of the MultiModem® iSMS are also provided by the SMS Gateway.


The SMS Gateway accepts API calls on the ports 80 and 443. Proceed the following steps to find out which API port is configured in your MultiModem® iSMS:


  1. Log in at the web interface of the MultiModem® iSMS
  2. Navigate to SMS Services - SMS API


If the HTTP Port under HTTP API Configuration is configured to 80 or 443, you can use the API as usual:


The parameter cat is optional and only accepts the value 1.


If an error occurs, you will get one of the following error codes:

error code Description
601 Authentication failed
602 Parse error
603 Invalid category
604 SMS message size is greater than 160 chars
605 Recipient overflow
606 Invalid recipient
607 No recipient
608 MultiModem® iSMS is busy, can’t accept this request
609 Timeout waiting for a TCP API request
610 Unknown action trigger
611 Error in broadcast trigger
612 System error - memory allocation failure
613 Invalid modem index
614 Invalid device model number
615 Invalid encoding type
616 Invalid time/date input
617 Invalid count input
618 Service not available
619 Invalid addressee receive
620 Invalid priority value
621 Invalid SMS text


(Only the yellow colored messages can occur at the SMS Gateway)


Further information about the HTTP API is provided here.



Connection to Nagios or Icinga


If you already connected your MultiModem® iSMS to your monitoring system with the script from the Netways isms Nagios Plugin, you have to update it to the latest version.



i The latest script can be downloaded here:



Please consider the references to the HTTP API. If you configured a deviant HTTP Port, the script needs to be adjusted.



Acknowledge problems


To acknowledge problems via SMS you will need to configure a rule in the Message Routing of the SMS Gateway. This function requires the licensing of the Message Routing module.


  1. Log in at the web interface of the MultiModem® iSMS.

  2. Navigate to SMS Services - SMS API.

  3. Note down or print out the configuration under Non Polling Receive API Configuration:
    1. Server
    2. Port
    3. Server Default Page

  4. Log in at the web interface of the SMS Gateway.

  5. Navigate to Configuration - Message Routing.

  6. Add a new rule.

  7. Use HTTP Request (iSMS Protokoll) as destination.

    Fill in the URL to the script smsack.cgi.

    The URL results from the noted configuration: http://<Server>:<Port><Server Default Page>





At least configure the networking settings.


  1. Log in at the web interface of the MultiModem® iSMS.

  2. Navigate to Network Setup in the top menu.

  3. Note down or print out the network settings.

  4. Disconnect the MultiModem® iSMS from from the power supply.

  5. Log in at the web interface of the SMS Gateway.

  6. Navigate to Configuration - Network.

  7. Configure the network settings as you noted them down.

  8. After clicking the Save button you need to restart the SMS Gateway.


That's it! Your SMS Gateway now assumes all tasks from the MultiModem® iSMS.





i Multi-Tech®, MultiModem® and iSMS® are registered trademarks of Multi-Tech Systems, Inc. in Mounds View, Minnesota.







Related articles