SMTP configurations¶
Requires the "General settings" permission.
The SMTP tab of the Email page (menu CONFIGURATION → Email) lists the mailboxes Thelgo sends emails from: those operators send to contacts with the email templates and the notification email to agents (see Emails to agents). You can register several configurations, for example one per department or brand, and choose which one to use in each template.
It is the first tab of the Email page, which opens right on it. The + New configuration button is in the page header, at the top right.
The list¶
| Column | Content |
|---|---|
| Description | The name you give the configuration: it is the one you see in the SMTP configuration menus |
| Type | Password (manual SMTP), Google or Microsoft |
| Host | The SMTP server; for Google and Microsoft, the connected account |
| Sender email | The address the emails are sent from |
On the right of each row you find the Test icon (paper airplane) and the Delete icon (trash can).
Adding a configuration¶
Press + New configuration: Thelgo asks "How do you want to send emails for this configuration?" and offers three ways.
Google or Microsoft (recommended for Gmail and Outlook/Microsoft 365)¶
- Choose Google or Microsoft.
- You are taken to the Google or Microsoft sign-in page: sign in with the account you want to send from and grant Thelgo permission to send emails on your behalf.
- Back in Thelgo you see at the bottom the green message "Account connected successfully." and the new row in the list, with description "Google - address" or "Microsoft - address".
You do not have to enter a password or server settings: the sender is always the connected account. If you connect the same account again, Thelgo updates the existing configuration instead of creating another one: it is the way to reconnect an account if sending stops working (e.g. after a password change or an access revocation).
If the connection fails
A red message appears at the bottom with one of the following messages (or "Unable to complete the account connection.").
- "The OAuth provider has not been set up by the system administrator.": the connection with Google or Microsoft is not enabled for the service. Contact the provider or use manual SMTP.
- "The link has expired, try again.": you took more than 10 minutes to complete the sign-in. Repeat the procedure.
- "The provider did not return a refresh token…": remove Thelgo's access from the security settings of your Google/Microsoft account and connect it again.
Manual SMTP¶
Choose Manual SMTP and fill in the New SMTP configuration form:
| Field | Notes |
|---|---|
| Description | Required |
| Host | Required, e.g. smtp.yourdomain.com |
| Port | Default 587 |
| Username / Password | The mailbox credentials. Leave them empty only if the server does not require authentication |
| Sender email | Required: the address shown as sender |
| Use SSL/TLS connection | On by default. Leave it on with port 587 or 465, unless your provider says otherwise |
The password is saved encrypted and is no longer visible.
Editing and deleting¶
- Click a Password row to edit it. The password field shows "Leave blank to keep unchanged". Google and Microsoft rows cannot be edited: to update them, reconnect the account.
- With the trash can you delete a configuration after confirmation. You cannot delete it if it is used by an email template: "This SMTP configuration is used by a campaign email format and cannot be deleted." appears at the bottom, as a red message. First change the SMTP configuration in the template.
Testing sending¶
After creating a configuration, always verify it:
- Press the row's Test icon.
- In the Send test window write one of your email addresses.
- Press Send test email.
If all goes well, the green message "Test email sent successfully." appears at the bottom and you receive an email with the subject "Email di test - Thelgo" (Test email - Thelgo). Otherwise the red message "Sending failed: …" appears, followed by the mail server's message (wrong credentials, blocked port, account not connected…), useful to understand what to correct.
Attachments and formatting with Google and Microsoft¶
With Google and Microsoft configurations, template attachments and HTML formatting are sent as with manual SMTP. Try them with a test template before using them in a campaign: Google and Microsoft providers may set limits on the total size of the email (check with a large attachment).
The test email (Test), instead, is always sent as plain text and without attachments.
Thelgo's SMTP¶
Besides your own configurations, the service can provide a shared SMTP, which appears as Thelgo SMTP only in the New agent appointment tab (see Emails to agents), for the email to agents. It does not appear in this list and cannot be used in email templates.