↑↓ selectEnter openEsc close

    1. Elbuz

    How to send SMS to customers: connecting a service

    5 min readUpdated

    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

    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.

    1. In the “Service” list, choose your service. The form shows the fields for that service.
    2. Paste the key from your service account — field names are in the table below.
    3. Enter the “Sender (alpha name)” (more details).
    4. Send a test SMS to your own number.
    SMS service card: TurboSMS selected, saved API token, sender name, transliteration switch, API documentation link
    1Service
    2API token
    3Sender (alpha name)
    4Transliteration
    5Service API documentation
    1. Service — choose the SMS provider.
    2. API token — the field stays empty once the key is saved (placeholder says to leave it empty).
    3. Sender (alpha name) — the name recipients see, registered with the service.
    4. Transliteration — sends Latin letters so the SMS is shorter.
    5. Service API documentation — link to the provider's documentation.
    What to enter for each service
    ServiceKey fieldsViber
    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.

    1. Turn on “Send via Viber”.
    2. Enter the “Viber sender” — the name the service registered for you.
    3. 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.

    Viber card: switch to send via Viber, Viber sender and lifetime in seconds
    1Send via Viber
    2Viber sender
    3Lifetime, s
    1. Send via Viber — Viber goes first, SMS is the fallback if it is not delivered.
    2. Viber sender — the sender name registered for Viber with the service.
    3. 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.

    Test phone field with Send test button and the send log with sent and error rows
    1Phone
    2Send test
    3Sent row
    4Error row with reason
    1. Phone — the number for the test message (380670000001).
    2. Send test — sends a test SMS the same way processes do.
    3. Sent row — a message accepted (here, in Test mode, written only to the log).
    4. 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:

    TextOne SMSLonger — in parts of
    with Cyrillic70 characters67
    Latin only160 characters153

    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”.

    SMS newsletter setup: message text with a contact field and unsubscribe link, character counter
    1Message text
    2Character and SMS counter
    3List of fields
    1. Message text — the SMS body; {{pc.name}} inserts the contact name and {unsubscribe_url} adds the opt-out link.
    2. Counter — shows characters and how many SMS parts the text takes.
    3. 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.

    Newsletters window listing an SMS and an Email newsletter with the Channel column
    1Channel: Email
    2Channel: SMS
    1. Email row — an email newsletter in the Channel column.
    2. 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.

    If the service reports that the balance has run out, the campaign is paused and the attempt is not counted. Top up the balance in your service account and click “Start Newsletter” with the “Send to those not yet sent” option.

    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.

    FromWhen the SMS goesTo
    Processes, the “Send SMS” actionwhen a rule fires, for example the order status changedthe phone from the order, or from the customer card if the order has none
    Order card, “Send” → SMSa manager edits the text and sends it manuallythe phone in the send window
    Customer card or the row menu in “Contacts”, “Message” → SMSa manager writes to the customer manually, without an orderthe phone in the send window, filled in from the card's “Phone” field
    SMS campaign from “Contacts”after “Start Newsletter”, within the sending windowthe first filled phone on the contact card
    AI support, confirmation codea customer asks to change an order from a channel that doesn't verify identitythe phone from the order

    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

    Errors in the send log
    What you seeWhyWhat 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 digitsadd 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 windowenter the message text
    “Document or contact not found.”the order or customer was deleted before sendingcheck 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 servicethe service refused: wrong key, no funds, unregistered alpha namefix 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
    External services window with the Telephony group expanded and the SMS messaging row
    1SMS messaging row
    2Edit (pencil)
    1. SMS messaging — the SMS gateway row in the Telephony group, next to the phone-system operators.
    2. Edit button — opens the SMS messaging setup form.

    Related topics

    Was this article helpful?

    Missing a feature? Tell us.

    We will add it for free if other users need it too.

    If only you need it, we will agree on it separately.

    Article contents

    Suggest an improvement

    Try Elbuz free