Elbuz sends SMS through your own SMS service: enter its key once, and SMS go out automatically — from processes, orders, customer campaigns and AI support.
When you need this:
- A customer should know the order shipped — a process sends an SMS with the order number once a manager changes the status.
- Customers read Viber, not SMS — Viber goes first, undelivered ones as SMS.
- You're announcing a promotion — an SMS campaign by filter in Contacts.
- An SMS “didn't arrive” — the send log shows every attempt and the service's response.
Where to start: choose a service and paste the key, then click “Send test”.
What SMS sending can do
- Connect one of seven services — TurboSMS, AlphaSMS, eSputnik, SendPulse, Kyivstar Business, Infobip or Twilio; you enter the key once for all sends.
- Send on behalf of your store — an alpha name instead of a phone number.
- Send via Viber first, and anything undelivered as a regular SMS.
- Check the connection with a test SMS to your own number, or in test mode without sending.
- See every send from anywhere in Elbuz, and the reason if the service refused.
- Send SMS campaigns to your customer base — by filter in Contacts, with a sending window and a per-minute limit.
- Send SMS from processes, orders and AI support — through the same connection.
How to connect an SMS service
Connecting takes three fields: service, key and sender. The form saves changes automatically, there is no “Save” button: “Saved” appears at the bottom of the window.
- In the “Service” list, choose your service. The form shows the fields for that service.
- Paste the key from your service account — field names are in the table below.
- Enter the “Sender (alpha name)” (more details).
- Send a test SMS to your own number.
1
Service2
API token3
Sender (alpha name)4
Transliteration5
Service API documentation- Service — choose the SMS provider.
- API token — the field stays empty once the key is saved (placeholder says to leave it empty).
- Sender (alpha name) — the name recipients see, registered with the service.
- Transliteration — sends Latin letters so the SMS is shorter.
- Service API documentation — link to the provider's documentation.
| Service | Key fields | Viber |
|---|---|---|
| TurboSMS | “API token” | yes |
| AlphaSMS | “API key” | yes |
| eSputnik | “API key” | yes |
| SendPulse | “Client ID” and “Client Secret” | no |
| Kyivstar Business | “Client ID” and “Client Secret” | yes |
| Infobip | “Base URL (xxxxx.api.infobip.com)” and “API key” | yes |
| Twilio | “Account SID” and “Auth Token” | no |
Below the fields there is a “Service API documentation” link — it opens the selected service's page that explains where to get the key.
The key after saving
A saved key is not shown in the form again: the field is empty, with the hint “saved — leave empty”. An empty field means “keep unchanged”. To replace the key, paste a new one.
If you change the service without entering a new key, the old key is erased: one service's key doesn't work with another.
Sender (alpha name)
An alpha name is the name the customer sees instead of a number, for example your store name in Latin letters. Enter the one registered in your service account, up to 20 characters. Services usually reject an unregistered name, and the reason appears in the log.
For Twilio, enter your Twilio number in this field.
Transliteration
The “Transliteration” switch converts SMS and Viber text to Latin letters. It is off by default. One Cyrillic SMS holds 70 characters, a Latin one holds 160, so long messages in Latin letters are split into fewer parts.
How to send Viber first, then SMS
A message can go via Viber first and, if Viber is not delivered, as a regular SMS. TurboSMS, AlphaSMS, eSputnik, Kyivstar Business and Infobip support this; for other services the form has no “Viber” card.
- Turn on “Send via Viber”.
- Enter the “Viber sender” — the name the service registered for you.
- If needed, set “Lifetime, s” — how many seconds the service waits for Viber delivery before sending an SMS.
The Viber text is the same as the SMS text. The Viber sender is registered by the service itself; you can't create it in Elbuz.
1
Send via Viber2
Viber sender3
Lifetime, s- Send via Viber — Viber goes first, SMS is the fallback if it is not delivered.
- Viber sender — the sender name registered for Viber with the service.
- Lifetime, s — how long the Viber message stays valid before falling back to SMS.
How to check that SMS arrive
In the “Test” card, enter your number in the 380XXXXXXXXX format and click “Send test”. You'll get an SMS reading “Test message from” followed by your store name.
The test takes the same path as SMS from processes and orders. If the service refuses, “SMS not sent” and the reason appear under the button, and the log gets an “error” row.
To set up processes without spending money, choose “Test mode (log only)” in the “Service” list. SMS then go nowhere, and every send is logged as sent. Switch back to a real service before working with customers.
1
Phone2
Send test3
Sent row4
Error row with reason- Phone — the number for the test message (380670000001).
- Send test — sends a test SMS the same way processes do.
- Sent row — a message accepted (here, in Test mode, written only to the log).
- Error row — shows the reason the service refused: no SMS service selected.
How to find out why an SMS didn't arrive
The “Send log” card in the same form shows the last 30 sends from anywhere in Elbuz, newest first: time, service, phone and result. An “error” row shows the reason next to it — an Elbuz message or the service's response.
“sent” means the service accepted the message. Whether it reached the phone is shown in your service account.
Common reasons are covered in “What to do when SMS are not sent”.
How to send an SMS campaign to your customer base
SMS campaigns use the same queue as email newsletters: you filter people in “Contacts”, write the text and start it — Elbuz sends the messages through the connected SMS service, with pauses and within the sending window.
Where: Contacts → paper plane icon → “SMS campaign by filter or selection”
The same is available from the “SMS” button next to “Newsletter” in the bar that pops up below selected contacts. The “New SMS campaign” button in “Newsletters” creates an empty SMS campaign with no recipients.
Who gets the SMS
The list includes filtered or checked records that have a phone, newsletter consent and are not in the Trash. The number is the first filled of the card's three phone fields. Duplicates are merged: a phone on several contacts gets the message once. The list is built once, when the campaign is created — as with email newsletters.
Message text
The SMS template form is simpler than an email: no addresses, subject or layout, only “Message text” for each language. Contact fields are inserted the same way as in emails, for example {{pc.name}}. Next to the field name there is a characters · SMS counter:
| Text | One SMS | Longer — in parts of |
|---|---|---|
| with Cyrillic | 70 characters | 67 |
| Latin only | 160 characters | 153 |
The service charges for each part, so the counter shows the real price of one message. For marketing SMS, add {unsubscribe_url} to the text — Elbuz inserts a personal unsubscribe link — or the word “STOP”.
1
Message text2
Character and SMS counter3
List of fields- Message text — the SMS body;
{{pc.name}}inserts the contact name and{unsubscribe_url}adds the opt-out link. - Counter — shows characters and how many SMS parts the text takes.
- List of fields — the contact fields available for insertion.
Starting and sending speed
Starting, stopping and “Flood protection” work the same as for email newsletters (starting a newsletter). In “Newsletters”, the “Channel” column shows which campaign is Email and which is SMS.
1
Channel: Email2
Channel: SMS- Email row — an email newsletter in the Channel column.
- SMS row — an SMS newsletter, listed in the same window and marked SMS.
The limits are set in the “Bulk campaigns” card of the SMS settings form:
- “Send from, hour” and “until, hour” — the sending window in the account's time, 9 to 20 by default. Outside the window, messages wait in the queue and go out as soon as the window opens.
- “Max per minute” — 20 messages by default.
If Viber is on, a message goes via Viber first, and if undelivered, as a regular SMS (Viber, then SMS). An error response from the service is written to the recipient's row; after three failed attempts the number is no longer used.
Where Elbuz sends SMS from
All sends go through the service in this form. If no service is selected, no SMS goes out, and each place shows an error.
| From | When the SMS goes | To |
|---|---|---|
| Processes, the “Send SMS” action | when a rule fires, for example the order status changed | the phone from the order, or from the customer card if the order has none |
| Order card, “Send” → SMS | a manager edits the text and sends it manually | the phone in the send window |
| Customer card or the row menu in “Contacts”, “Message” → SMS | a manager writes to the customer manually, without an order | the phone in the send window, filled in from the card's “Phone” field |
| SMS campaign from “Contacts” | after “Start Newsletter”, within the sending window | the first filled phone on the contact card |
| AI support, confirmation code | a customer asks to change an order from a channel that doesn't verify identity | the phone from the order |
- How to build a rule with the “Send SMS” action — SMS when an order reaches the right status.
- Manual sending from an order works only with a customer selected. To write to a customer without an order, use the card — “Message” in the customer card.
- How AI support sends the code — Confirmation code.
Scenarios
Connecting TurboSMS for the first time
What to do. Choose “TurboSMS”, paste the “API token” from your TurboSMS account, enter the alpha name registered there and send a test to your own number.
What you get. A test SMS from your alpha name arrives on your phone, and a “sent” row appears in the log. From then on, processes and orders send SMS.
Customers read Viber more often
What to do. With TurboSMS or AlphaSMS, turn on “Send via Viber” and enter the “Viber sender”.
What you get. Customers with Viber get the message in Viber, everyone else gets a regular SMS. The service sends the SMS itself if Viber is not delivered.
Setting up processes at no cost
What to do. Choose “Test mode”, set up the process rules and check the send log.
What you get. You see who would have received an SMS and when, while customers get nothing. Then switch back to a real service.
What to do when SMS are not sent
| What you see | Why | What to do |
|---|---|---|
| “No SMS service selected” | the “Service” list is set to “Not selected” | choose a service and paste the key (connecting) |
| “No phone number.” | the phone is empty in both the order and the customer card, or the test number is shorter than 10 digits | add a phone to the order or the customer card |
| “SMS text is empty.” | the text is not filled in the process action or the send window | enter the message text |
| “Document or contact not found.” | the order or customer was deleted before sending | check that the record exists |
| “The SMS service did not confirm the send.” | the service did not reply “accepted” | check the key, balance and alpha name in your service account |
| English text from the service | the service refused: wrong key, no funds, unregistered alpha name | fix the cause in your service account and send the test again |
FAQ
How much does an SMS cost?
Elbuz charges nothing for SMS: you pay the service at its rates from your own account. Costs are shown in your service account.
The service list says “no longer supported”. What should I do?
This is a service that was connected earlier and is no longer in the list. Choose a service from the list and paste its key (connecting).
Can I connect two services at once?
No. All sends go through the one selected service; you can't set a backup service.
The log says “sent”, but the customer didn't get the SMS. Why?
The service accepted the message, and delivery is handled on its side. Check the delivery status in your service account.
Can I send an SMS to all customers at once?
Yes: “Contacts” → paper plane icon → “SMS campaign by filter or selection”. Contacts with a phone number and newsletter consent get the message (SMS campaign).
Can I include the order number and total in an SMS?
Yes, order and customer fields are inserted in the process action text — the same way as in an email template (command fields).
Where it is and who has access
There is no separate menu item for SMS sending: the form sits among the other integrations, in the “Telephony” group.
- Open
- Account → System settings → “Other settings” → “External services and integrations”
- Row
- the “Telephony” group → “Рассылка SMS” (SMS sending) → the pencil in the row
- Access right
- the “API & access tokens” window in “Group permissions”
- Prepare
- an account with the SMS service, its API key and a registered alpha name
1
SMS messaging row2
Edit (pencil)- SMS messaging — the SMS gateway row in the Telephony group, next to the phone-system operators.
- Edit button — opens the SMS messaging setup form.
Related topics
- If the SMS must go out exactly when the status changes — process rules and the “Send SMS” action.
- If AI support should send a confirmation code by SMS — How AI handles customer order requests on its own.
- If you need an email rather than an SMS — email in Elbuz.
- If you're looking for telephony in the same list — Telephony in Elbuz.
