Skip to content

SMS

Requires the "General settings" permission.

The SMS page (menu CONFIGURATION → SMS) is used to prepare the sending of SMS by operators while handling a campaign. It has three tabs, with the subtitle "Sender alias and templates for sending SMS" (on the Appointment reminder template tab the subtitle instead shows "N reminder templates registered"):

Tab What it contains
Sender alias The names (up to 11 characters) shown as the SMS sender on the recipient's phone
SMS template for campaign The SMS templates: the ready-made texts the operator chooses to send an SMS, each linked to a sender alias
Appointment reminder template The templates of the SMS Thelgo automatically sends to contacts to remind them of an appointment. See Appointment reminder

The path is the same as for emails: you prepare aliases and templates here, then enable the templates campaign by campaign in the Preset SMS module (see Campaign configuration).

Remaining SMS. At the top right, on the same row as the tabs, you see Remaining SMS followed by a number: these are the SMS your account can still send. The number is re-read from the SMS service every time the page is opened and stays visible in all three tabs. If the service does not respond or the data is not available, the indicator simply does not appear, with no message. When it reaches zero sending stops ("Credito SMS esaurito." (SMS credit exhausted.)): to top up, contact support (see Help).

The SMS entry only appears if the service is active

The SMS entry in the menu is only there if the SMS sending service has been activated for your account. If you do not see it, or if when opening the page you read "SMS sending is not yet active for this account. Contact support to activate it.", the service is not active: ask support for it (see Help). Until it is active you cannot even enable the SMS module in a campaign. The service status is re-read from the server: the SMS page checks it every time it is opened and the menu when the administration area loads, so if support activates it while you are logged in, just reopen the page or reload the browser, without logging out and back in.

The Sender alias tab shows "1 registered aliases" (the count of aliases), the table with Alias, Status (here Verified) and Requested on, the trash can on the right and the + New alias button at the top. The Pending and Rejected statuses have a different badge.

Sender alias

The alias is the "name" with which the SMS reaches the recipient (for example the name of your business). Before it can be used it must be approved: every new alias starts as Pending and is checked by the moderators of the SMS service.

The list

Column Content
Alias The alias text
Status Pending (under review), Verified (approved, usable) or Rejected
Requested on When the alias was created

The trash can on the right deletes the alias. Click the headers to sort. The status of Pending aliases is re-read from the SMS service every time you open the page: to know whether an alias has been approved, just reopen it.

Creating an alias

  1. Press + New alias: the New alias form opens.
  2. Read the guidelines shown in the form. To be approved the alias must follow them:
    • it must not be a generic name (e.g. pharmacy), but must reflect the name of your shop or business;
    • it must not reference phone carriers or brand names;
    • you must provide all the requested data, including the PEC (certified email).
  3. Write the Alias (at most 11 characters: under the field you see the count "n/11").
  4. Fill in the holder's data: Company name, VAT number, Tax code, Address, City, Postcode, Province (2 letters), Country (2 letters, "IT" suggested), Email, Phone, Certified email (PEC).
  5. Tick the declaration of compliance with the AGCOM resolutions shown at the bottom of the form.
  6. Press Save. The button stays disabled until you have written the alias and ticked the declaration.

The alias cannot be edited

After creation the alias cannot be changed: it is verified with exactly the text you wrote. If you made a mistake, delete it and create another. Before it can be used it must be approved by the moderators ("Before it can be used, the alias must be approved by our moderators.").

If creation fails, a red message appears at the bottom with the reason ("The alias is required and cannot be longer than 11 characters.", the SMS service's message or "Unable to create the sender alias.").

In the New alias form (lower part: the guidelines are higher up) the Alias field has the counter (for example "7/11"), followed by the holder's data, the Certified email (PEC) and the AGCOM declaration. Until the declaration is ticked, Save stays off.

Aliases already present on the SMS service

If on your account's SMS service there are aliases Thelgo does not know yet (for example created by support), they appear at the bottom of the list with the text Not imported yet and an Import button. Press it to bring them into Thelgo: from then on you can use them in templates. If the import fails, "Unable to import the alias." appears (or "This alias is already in Thelgo.", or "This alias does not exist (anymore) on the SMS service.").

Deleting an alias

  1. Press the trash can on the row.
  2. In the Delete sender alias window read the warning ("This action cannot be undone and will also remove the alias from the SMS service.") and write the word delete under "Type delete to confirm:" (upper and lower case do not matter; the word is in the interface language).
  3. Press Delete permanently, which becomes active only when the word matches.

You cannot delete an alias still chosen in one or more SMS templates: "Cannot delete an alias still selected in one or more SMS templates: remove it from there first." appears. First change or delete the templates.

SMS templates

An SMS template is a ready-made text, linked to a sender alias. It does not belong to a campaign: you prepare it once and enable it in all the campaigns you want (like email templates).

The list

At the top you see "N registered templates". The columns are Description, Sender alias and Associated campaigns (how many campaigns enable the template; the number is clickable and opens the Associated campaigns: … popup with the campaign list, click a campaign to open it; with 0 the button is disabled); if the template's alias is not yet Verified, a warning icon appears next to it ("Alias not verified yet: sending will stay blocked until it is approved."). Click a row to edit the template, the trash can deletes it (after the browser confirmation "Delete template "…"?").

A template already used to send SMS cannot be deleted

If at least one SMS has already been sent from that template, deletion fails with the red message "Cannot delete a template already used to send one or more SMS: the history of sent SMS refers to this template." and the template stays. The mere fact that the template is ticked in a campaign is not enough to block it: an associated template that was never used can be deleted without problems. If you no longer need it, leave it (or untick it in the campaigns).

Creating or editing a template

+ New template is disabled until at least one alias exists (even if not yet verified): hovering over it you read "You must first create a sender alias (even if not yet verified) before you can create an SMS template.".

Field Notes
Description Required. It is the name the operator sees in the SMS template menu
Sender alias Required. Aliases not yet verified have the status in brackets (e.g. "(Pending)") and, if you choose one, "This alias is not verified yet: you can save the template, but sending will stay blocked until it is approved." appears
Text Required. Under the field the counter shows "N characters · M SMS": it counts one SMS every 160 characters

Under the text there are the placeholder buttons: clicking them adds the placeholder at the end of the text, where you can move it. At sending time Thelgo replaces it with the real data.

Placeholder Value
{{Nominativo}} The contact's first and last name, or the company name if missing
{{RagioneSociale}}, {{Nome}}, {{Cognome}} The contact's personal data
{{Indirizzo}}, {{Cap}}, {{Comune}}, {{Provincia}} The contact's address
{{Telefono1}}, {{Email}} The contact's first phone number and email
{{Operatore.Nome}}, {{Operatore.Cognome}} The operator sending the SMS
{{Agente.Nome}}, {{Agente.Cognome}} The agent of the booked appointment
{{Appuntamento.DataOra}}, {{Appuntamento.Data}}, {{Appuntamento.Ora}} Date and time (dd/mm/yyyy hh:mm), date only (dd/mm/yyyy) or time only (hh:mm) of the booked appointment

The agent and appointment placeholders are only filled in if the appointment is already booked: under the buttons you read "The agent and appointment placeholders are only filled in when the appointment is already booked: operators will be able to send a template that contains them only after booking it." The time written in the SMS is that of the account's time zone. For the details (what the operator sees, the rejection messages) see Templates with appointment details.

The same rules as email templates apply: names must be written exactly like this, and an unknown placeholder or one for an empty field stays in the message as it is. The database's dynamic fields can be written by hand with their name ({{Field name}}), even if they have no button.

Press Save. If it fails, the reason appears at the bottom ("The description is required.", "The message text is required.", "Unable to save the SMS template.").

The Edit template form of the SMS template for campaign tab has Description, Sender alias, Text with the counter (for example "78 characters · 1 SMS"), the placeholder buttons (including {{Appuntamento.DataOra}}, {{Appuntamento.Data}} and {{Appuntamento.Ora}}) and the grey note: the agent and appointment placeholders are only filled in if the appointment is already booked.

With an unverified alias the SMS is not sent

You can save a template with a Pending or Rejected alias, but the operator who tries to send it gets "The sender alias of this template has not been verified yet.". Before using the template in a campaign, check that the alias is Verified.

Enabling a template in a campaign

SMS templates are enabled in the configuration of each campaign, in the Preset SMS module (see Campaign configuration): you tick the templates to offer to the operators of that campaign and, with the eye icon, you see their preview. The operator sees in the SMS template menu only those enabled in their campaign and sends with Send SMS.

Appointment reminder template

The third tab gathers the reminder templates: a template has a description, the time the SMS is sent, a sender alias and a text with the contact, agent and appointment placeholders (for example {{Appuntamento.DataOra}}). + New reminder template is disabled until at least one alias exists, and a template with an alias not yet Verified can be saved but the SMS is not sent. How sending works, the fields, the messages and how to enable it in a campaign are on the Appointment reminder page.