Configuring the module the SMS widget for the online store {SEO-Shop}, OpenCart 2.x, 3.x, ocStore

1. Module installation “NeoSeo SMS informer”

To install the module “NeoSeo SMS informer” for OpenCart, you must:

1. Go to admin panel and click on “Extras”->”Modules”:
2. In the list of modules that opens, select “NeoSeo SMS Informer” and click the “Install” button:
3. Go to the "Add-ons" -> "Add-ons Manager" section and click on the "Update" button in the window that opens.

This completes the installation of the module and you can proceed to editing the module settings.

2. Editing module settings

To edit the module’s settings, go to the site’s administrative panel and select the “Add-ons” -> ”Modules” section. In the list of modules for OpenCart that opens, select “NeoSeo SMS Informer” and click on the “Edit” button:

After that, the window for editing module settings will appear on the screen:

The “General” tab is used to configure the following parameters:

Turn on / off the module. In order to connect the module to the store, you need to select “Enabled” in the “Status” field:

Recipients of admin messages. This field is used to indicate the phone numbers of recipients of order notifications:

If you need to send SMS notifications to several recipients, enter their phone numbers, separated by commas:

• Auto completion. For the gateway to work correctly, you need a full phone number, for example, 38 095 111 11 11. But clients often enter only part of the number, for example, 095 111 11 11. In this field, specify the mask of the full value, for example 38 000 000 00 00, and the module itself will add the entered number with the missing numbers:
• Customer group. This field is used to indicate groups of customers to whom they should send SMS notifications:

In order for the SMS notification system to work, it is necessary:

Choose your preferred sms-mailing service and specify it in the “SMS-gateway” field;

Register on the official website of the selected service, get data for the API distribution and specify them in the fields “Login for SMS gateway”, “Password for SMS gateway”, “Sender for SMS gateway”.

The tab “Email templates” is used to configure SMS notification templates for each order status:

In this system, 7 order statuses are defined for which you can configure SMS notifications: new, processed, sent by new mail, sent by Ukrposhta, sent by courier, waiting for self-delivery, order completed.

For the order status “New” it is possible to configure the following parameters:

• Message. This module allows you to configure the SMS notification of the client in all languages of the store (in the example, English, Russian and Ukrainian languages):

And also an SMS notification for the administrator:

In this example, messages contain tags that can be used to populate fields. For example, the tag {order_id} contains the current order number. Using these tags, you can create a message in the desired form. Description of tags can be viewed on the “Fields” tab:

• Sending messages to the client and administrator. This module suggests sending an order notification to both the client and the administrator.

In order to configure sending messages, it is necessary to select one of three possible values in the “Send” field: “Disabled”, “Enabled”, “Forced”.

If you select “Disabled”, the message will not be sent.

If you select “Enabled”, a message will be sent if the notice of buyer notification is selected. In order to deliver it, you need to select the “Sales” -> ”Orders” -> “Order Overview” section in the site’s administrative panel and check the box “Notify the buyer”:

If you select “Forced”, the message will always be sent.

For the status of the order “Processing” it is possible to configure the following parameters:

• Message. This module allows you to configure the SMS notification of the client in all languages of the store (in the example, English, Russian and Ukrainian languages):

And also an SMS notification for the administrator:

Messages contain tags that you can use to fill in the fields. For example, the tag {order_id} contains the current order number. Using these tags, you can create a message in the desired form. Description of tags can be viewed on the “Fields” tab:

• Sending messages to the client and administrator. This module suggests sending an order notification to both the client and the administrator.

In order to configure sending messages, it is necessary to select one of three possible values in the “Send” field: “Disabled”, “Enabled”, “Forced”.

If you select “Disabled”, the message will not be sent.

If you select “Enabled”, a message will be sent if the notice of buyer notification is selected. In order to deliver it, you need to select the “Sales” -> ”Orders” -> “Order Overview” section in the site’s administrative panel and check the box “Notify the buyer”:

If you select “Forced”, the message will always be sent.

For the order status “Sent by new mail” it is possible to configure the following parameters:

• Message. This module allows you to configure the SMS notification of the client in all languages of the store (in the example, English, Russian and Ukrainian languages):

And also an SMS notification for the administrator:

Messages contain tags that you can use to fill in the fields. For example, the tag {order_id} contains the current order number. Using these tags, you can create a message in the desired form. Description of tags can be viewed on the “Fields” tab:

• Sending messages to the client and administrator. This module suggests sending an order notification to both the client and the administrator.

In order to configure sending messages, it is necessary to select one of three possible values in the “Send” field: “Disabled”, “Enabled”, “Forced”.

If you select “Disabled”, the message will not be sent.

If you select “Enabled”, a message will be sent if the notice of buyer notification is selected. In order to deliver it, you need to select the “Sales” -> ”Orders” -> “Order Overview” section in the site’s administrative panel and check the box “Notify the buyer”:

If you select “Forced”, the message will always be sent.

For the order status “Sent by Ukrposhta” it is possible to configure the following parameters:

• Message. This module allows you to configure the SMS notification of the client in all languages of the store (in the example, English, Russian and Ukrainian languages):

And also an SMS notification for the administrator:

Messages contain tags that you can use to fill in the fields. For example, the tag {order_id} contains the current order number. Using these tags, you can create a message in the desired form. Description of tags can be viewed on the “Fields” tab:

• Sending messages to the client and administrator. This module suggests sending an order notification to both the client and the administrator.

In order to configure sending messages, it is necessary to select one of three possible values in the “Send” field: “Disabled”, “Enabled”, “Forced”.

If you select “Disabled”, the message will not be sent.

If you select “Enabled”, a message will be sent if the notice of buyer notification is selected. In order to deliver it, you need to select the “Sales” -> ”Orders” -> “Order Overview” section in the site’s administrative panel and check the box “Notify the buyer”:

If you select “Forced”, the message will always be sent.

For the order status “Sent by courier” it is possible to configure the following parameters:

• Message. This module allows you to configure the SMS notification of the client in all languages of the store (in the example, English, Russian and Ukrainian languages):

And also an SMS notification for the administrator:

Messages contain tags that you can use to fill in the fields. For example, the tag {order_id} contains the current order number. Using these tags, you can create a message in the desired form. Description of tags can be viewed on the “Fields” tab:

• Sending messages to the client and administrator. This module suggests sending an order notification to both the client and the administrator.

In order to configure sending messages, it is necessary to select one of three possible values in the “Send” field: “Disabled”, “Enabled”, “Forced”.

If you select “Disabled”, the message will not be sent.

If you select “Enabled”, a message will be sent if the notice of buyer notification is selected. In order to deliver it, you need to select the “Sales” -> ”Orders” -> “Order Overview” section in the site’s administrative panel and check the box “Notify the buyer”:

If you select “Forced”, the message will always be sent.

For the order status “Pending pickup” it is possible to configure the following parameters:

• Message. This module allows you to configure the SMS notification of the client in all languages of the store (in the example, English, Russian and Ukrainian languages):

And also an SMS notification for the administrator:

Messages contain tags that you can use to fill in the fields. For example, the tag {order_id} contains the current order number. Using these tags, you can create a message in the desired form. Description of tags can be viewed on the “Fields” tab:

• Sending messages to the client and administrator. This module suggests sending an order notification to both the client and the administrator.

In order to configure sending messages, it is necessary to select one of three possible values in the “Send” field: “Disabled”, “Enabled”, “Forced”.

If you select “Disabled”, the message will not be sent.

If you select “Enabled”, a message will be sent if the notice of buyer notification is selected. In order to deliver it, you need to select the “Sales” -> ”Orders” -> “Order Overview” section in the site’s administrative panel and check the box “Notify the buyer”:

If you select “Forced”, the message will always be sent.

For the order status “Order Complete” it is possible to configure the following parameters:

• Message. This module allows you to configure the SMS notification of the client in all languages of the store (in the example, English, Russian and Ukrainian languages):

And also an SMS notification for the administrator:

Messages contain tags that you can use to fill in the fields. For example, the tag {order_id} contains the current order number. Using these tags, you can create a message in the desired form. Description of tags can be viewed on the “Fields” tab:

• Sending messages to the client and administrator. This module suggests sending an order notification to both the client and the administrator.

In order to configure sending messages, it is necessary to select one of three possible values in the “Send” field: “Disabled”, “Enabled”, “Forced”.

If you select “Disabled”, the message will not be sent.

If you select “Enabled”, a message will be sent if the notice of buyer notification is selected. In order to deliver it, you need to select the “Sales” -> ”Orders” -> “Order Overview” section in the site’s administrative panel and check the box “Notify the buyer”:

If you select “Forced”, the message will always be sent.

The tab “New reviews” is used to configure the text of notifications of new reviews on products:

This tab contains the following fields:

• Status. In order for the administrator of your site to receive sms notifications of new reviews on products, in this field, select the value “Enabled”:
• Notification text. This field is intended for the formation of the text of the notification about a new review, for the site administrator. When composing a message, you can use special tags:

{product_name} - product name;

{product_sku} - product code;

{product_model} - product model;

{product_id} - product code.

For example, enter the following text: New product review {product_name}, model {product_model}:

Important!!! After adding all the changes, click the “Save” button:

As a result, when placing orders, the recipient of admin messages will receive the following SMS notifications:

SMS-notifications for the client when placing an order are as follows:

UPDATE from 08/19/2019

Added the ability to send messages to site administrators via Telegram messenger.

Sending messages to Telegram

The module provides the ability to send notifications to administrators via the Telegram messenger. Configuring the sending of notifications is carried out in several stages.

Training. To send messages via Telegram you need to register a bot - a robot that has access to the Telegram API and will send you messages. To do this, you need to find a bot in Telegram named BotFather and ask him to create a bot for us.

Bots themselves cannot start a chat, so you need to initiate a conversation. After starting the conversation, you need to give the command:

BotFather - / newbot - create a new bot.

After that, you will need to enter the name of your bot twice. There is a restriction on the name of the bot - it must end in “bot”. When the bot is successfully created BotFather will give you the API key of the new bot. Using this key, you will send requests to your bot. Keep this key a secret, because then anyone can connect to your bot and use it for unknown purposes (including bad ones).

Setting up the bot. So, the bot is created. Now we need our bot to start sending notifications. According to Telegram rules, a bot cannot initiate chats with people on its own, so we need to do this on our own. We find our bot in a telegram and initiate a conversation with him (by clicking the start button). After that, we need to send the bot a request of the following form:

https://api.telegram.org/bot<API_KEY>/getUpdates

This can be done through a browser or Postman program, or something similar. In response, the bot should send us a message in JSON format

We are interested in the chat identifier in this message, we will use it to receive messages - or rather, we will send messages to this chat. Each new person who connects to the bot will initiate a new chat with a new identifier. Therefore, if you need to send messages to several people, one of them must create a chat with the bot and then add other people to the conversation, otherwise each one will create a separate chat with the bot and the bot will send notifications to only one recipient.

Configuring the sending of notifications in the module. After we have received all the necessary data, it's time to configure our module. In the module settings on the “Notifications to administrators” tab, set the following parameters:

choose notification options - via SMS or via Telegram;

for SMS notifications, enter recipient numbers separated by commas;

we enter the API key and the identifier of our chat bot to receive notifications in Telegram.

Done. You will receive notifications in telegrams of new orders, changes in order status, as well as new reviews.

UPDATE from 08/20/2019

A button for sending notifications via SMS has been added to the header of the administrative zone.

After installing the module and updating the modifiers cache in the admin panel header, a button for sending notifications via SMS appears.

For the correct operation of sending SMS, it is necessary in the settings to grant the rights to the respective user groups to view and change “marketing / neoseo_sms_notify”

By clicking on the send SMS button in the header, the message sending form will be displayed:

Enter the recipient’s mobile number, enter the message text and click the “Send message” button.

You will be informed about the results of sending by pop-up message.