Telegram notifications and Viber/SMS for customers for OpenCart

The module does two things. It sends your OpenCart store events to you in Telegram — a new order, a status change, a product’s stock dropping. And, since version 1.1.0, it messages the customer on Viber or by SMS when their order changes status: “received”, “shipped, tracking number 2045…”, “cancelled”.

Telegram notifications for you stay free, as before. Viber and SMS messages to customers are a Pro feature: they go through your own TurboSMS, Alpha SMS, or SMS-Fly account, and the first 7 days of Pro unlock with a button in the module settings, no payment needed.

What the customer sees

The customer checks out as usual, with nothing extra to fill in — the module uses the phone number they already enter at checkout. As soon as a manager moves the order to a status you enabled messages for, the customer gets a short Viber message from your store’s name. If the number has no Viber or the message isn’t delivered, the service sends the same text by SMS on its own.

• Processing: “My Store: Olena, order #64 received, total 1,250 UAH. Thank you!”
• Shipped: “My Store: order #64 has been shipped. Tracking number: 20450000000000” — the module takes the tracking number from the comment the manager adds along with the status change.

Each status is sent to a customer only once: if the order is moved back to “Processing” and forward again, or the manager clicks “Add history” twice, there won’t be a second paid message.

How it works, step by step

1. A manager changes the order status in the admin panel (or a payment module moves it automatically) — OpenCart fires the order history event.
2. The module checks whether messages are enabled for that status, whether Pro is active, and whether this customer has already been sent this status.
3. The phone number is normalised to the international E.164 format based on the order country: 093 123 45 67 in an order from Ukraine becomes 380931234567, +48 731 234 567 becomes a Polish number, and a number without a code is read as a number from the order’s address country rather than guessed from the first digits.
4. The number’s country picks the SMS sender name and the Viber sender; the *= line covers all other countries.
5. The text is built from your template: {tracking_number} is the first 11–14 digit number in the status comment, {comment} is the comment itself. A line where every tag is empty is simply dropped.
6. First a “sending” line is written to the log — so a parallel save of the same status can’t cause a duplicate. Then the request goes to the service, and the log shows the message ID or the rejection reason.

Under the hood

• Three integrations built to the services’ official documentation: TurboSMS (message/send.json, Viber+SMS hybrid), Alpha SMS (JSON protocol, type viber+sms), SMS-Fly (REST API v2, channels ["viber","sms"]).
• The service key and the bot token are stored encrypted; the key field never displays the saved value.
• The licence and Viber/SMS settings live in a separate settings group — the regular “Save” on the Telegram tab doesn’t touch them, and vice versa.
• Customer messages work even when Telegram notifications are switched off: these are two independent parts of one module.
• A service error never breaks checkout or a status change in the admin panel — it’s only written to the log.
• Numbers in the log are masked (+38093***4567).
• In the OpenCart 3 build the database connection temporarily switches to utf8mb4, so emoji in Telegram templates don’t turn into “?”.

Download

• For OpenCart 4.x — cc_telegram.ocmod.zip, version 1.1.1
• For OpenCart 3.0.x — cc_telegram-oc3-1.1.2.ocmod.zip, version 1.1.2
• For OpenCart 2.3.0.x — cc_telegram-oc2-1.0.4.ocmod.zip, version 1.0.4, Telegram notifications only (no Viber / SMS)

How to install

1. Admin panel → Extensions → Installer → “Upload” → choose the archive for your OpenCart version. You can update over the previous version — the Telegram settings are kept.
2. In OpenCart 3: Extensions → Modifications → “Refresh”. OpenCart 4 doesn’t need this step.
3. Extensions → Extensions → type “Modules” → “Telegram Order Notifications” → “Install” (if not installed yet), then “Edit”.
4. For Telegram: paste the bot token from @BotFather, click “Find chat_id”, and send a test.
5. For customers: the Viber / SMS to customers tab → “Start 7 days free”, or paste a purchased key.
6. Pick the service, paste the API key, choose the channel and per-country sender names (UA=MyStore, *=MyStore), tick the statuses and adjust the texts if needed. Click “Check key and balance”, then send a test to your own number.