How to monitor an SMPP connection and get an E-mail alert when it goes down

This handy guide details how to configure email alerts for SMPP client connectivity changes. Ozeki SMS Gateway's user-friendly interface empowers you to set up customizable notifications in no time. Whether you prefer a quick visual overview, a step-by-step walkthrough with screenshots, or a handy FAQ section, this guide has you covered. Invest just 10 minutes and gain peace of mind knowing you'll receive timely email updates on the status of your SMPP clients. Take control of your SMPP client monitoring today!

What is an SMPP connection?

SMPP, which stands for Short Message Peer-to-Peer, is a technical protocol that defines how applications and messaging services communicate with Short Message Service Centres (SMSCs) over a TCP/IP connection. Think of it as a set of rules for exchanging SMS data. This industry standard allows devices and software to securely send and receive text messages through the mobile network.

What is an e-mail alert?

An e-mail alert is an automatic response to a certain event occurring. When that event happens, Ozeki SMS Gateway sends a custom e-mail to a designated e-mail address, letting the owner know the event has occurred.

Monitoring SMPP connection and getting an E-mail alert when it goes down

Figure 1 explains how the alarm works. Ozeki SMS Gateway monitors your SMPP connection. When the SMPP client's status changes from online to offline or vice versa, Ozeki SMS Gateway sends an alert message to the e-mail server, which upon the alert message's arrival, sends an e-mail to the system admin's e-mail address.

email alert
Figure 1 - Monitoring SMPP connection with E-mail alert

Monitoring an SMPP connection and getting an E-mail alert when it goes down (video tutorial)

The following video shows setting up and testing an e-mail alert about an SMPP client's status changing. It is not even 100 seconds long, but contains all the necessary steps and information for you to replicate it, making it a worthwhile watch. Not only that, but it also demonstrates just how many settings are available to you inside Ozeki SMS Gateway.

Video 1 - How to monitor SMPP connection and get an E-mail alert when it goes down (Video tutorial)

Monitoring an SMPP connection and getting an E-mail alert when it goes down (quick steps)

  1. Setup Gmail client
  2. Test Gmail client
  3. Create new alarm
  4. Set up alarm
  5. Turn SMPP client offline
  6. Check alarm if it sent out the e-mail
  7. Check Gmail client if it received the e-mail
  8. Turn SMPP client back online
  9. Check if alarm sent the e-mail
  10. Check if Gmail client received the e-mail

Monitoring an SMPP connection and getting an E-mail alert when it goes down (step-by-step guide)

Inside Ozeki SMS Gateway, click on the Connect icon as shown in Figure 2, and install the Gmail client.

Install Gmail client
Figure 2 - Install Gmail client

Configure the Gmail client by entering your desired credentials, as you can see in Figure 3.

Configure Gmail account
Figure 3 - Configure Gmail account

To see if everything is working so far, head over to the Test tab, highlighted in red in Figure 4, and send a test e-mail. If done correctly, you should see a similar pop-up window saying 'Success!'.

Test Gmail client
Figure 4 - Test Gmail client

Select the Edit option in the toolbar and click on Alarms in the dropdown menu (Figure 5).

Open alarm menu
Figure 5 - Open alarm menu

Click the Create new Alarm button and select Any offline in the appearing right panel (Figure 6).

Create new alarm
Figure 6 - Create new alarm

Configure the alarm to your liking. When you are finished, click on Ok as shown in Figure 7.

Configure alarm details
Figure 7 - Configure alarm details

When your SMPP client goes offline, the green dot next to it will turn red, similarly to Figure 8.

SMPP client offline
Figure 8 - SMPP client offline

Heading over to the Details page of your freshly set up alarm, you can see if your alert e-mail was sent out or not, as seen in Figure 9.

Offline alarm sent
Figure 9 - Offline alarm sent

On your Gmail client's page, you can check whether the alarm e-mail has been received (Figure 10).

Offline email sent
Figure 10 - Offline email sent

Upon your SMPP client coming back online, the red dot next to it will turn to green, highlighted by the arrow in Figure 11.

SMPP client online
Figure 11 - SMPP client online

You can check if the online alarm has been sent via the alarm's Details page, as it can be seen on Figure 12.

Online alarm sent
Figure 12 - Online alarm sent

In a similar way to one of the previous steps, going to the Gmail client's page, you can tell if the online alert has been received (Figure 13).

Online email sent
Figure 13 - Online email sent

Can I personalize the contents of the alert e-mail?

Ozeki SMS Gateway allows you to personalize the alert e-mail's content to include specific details relevant to your needs. During the configuration process, you can define the message template. This template can include dynamic elements such as the name of the disconnected/reconnected SMPP client or timestamps for added context.

Are there other ways to be notified about an SMPP connectivity changing?

Yes, you can choose to send such notifications to a phone number in the form of an SMS or a WhatsApp message.

More information