Elbuz sends email newsletters to your contact list without a third-party service: you filter people in “Contacts”; the system collects addresses with consent and sends the emails itself, with pauses against spam filters.
When you need this:
- A promotion for Kyiv wholesale buyers only — two filters and one command, “Create a newsletter”.
- A customer unsubscribed — consent is removed; later newsletters skip them.
- Started by mistake — “Stop Newsletter” cuts the queue at the next recipient.
- A run broke off halfway — restart “for those not yet sent”: the rest get it, no repeats.
Where to start: Contacts → filter → paper plane icon → “Create a newsletter…”.
What newsletters can do
- Newsletter from a filter — recipients come from the filtered set you made in contacts.
- Clean list — only addresses with consent, nothing from the Trash, no duplicates.
- Queue with pauses — up to 20 emails per pass, a random pause between emails.
- Report for every recipient — “Sent”, “Seen”, error text.
- Stop and resume — no repeat emails to those who already got one.
- Unsubscribe — the “Unsubscribe from the mailing list” link at the bottom of the email is added automatically, plus a button in Gmail and Yahoo.
How to create a newsletter from a filtered set of contacts
A newsletter starts in the “Contacts” window, not in mail. Pick people with filters, stats or checkboxes in the “Selection” column. Then: paper plane icon in the header → “Create a newsletter based on the filter set in the contact grid”. The same command is the “Newsletter” button on the bar that pops up when records are selected.
Filtering by group and city. For example, an email just for wholesale buyers in Kyiv:
- The “Contact group” filter is on the filter bar above the contact list from the start — it lists the roles from the group directory.
- If there's no separate role for wholesale buyers, rename a group you don't use (“Partner” or “Other”) to “Wholesale” in the “Contacts” window menu → “References” → “Contact groups” and assign it to those customers. The “+” button in this directory doesn't create a new group (contact groups).
- The “City” filter isn't on the bar by default: filter settings gear → the “City” filter → the “Above the grid” switch.
- Check the values you need in both filters — the list keeps only wholesale buyers from Kyiv — and then create the newsletter.
The filter takes the city from the card's “City” field: contacts with an empty field won't make it into the filtered set.
One click makes the system do three things: create the newsletter (stopped for now), collect the recipient list, and open the “Newsletter setup” window — the email form, the same one templates use.
There's no way to undo this step. The newsletter and an empty template, “New Template ‹date›”, are created before you write anything — just by clicking the menu item. If you change your mind and close the window, the row stays in “Newsletters”, and you have to remove it by hand.
Who ends up on the recipient list
The list is collected once, at the moment of creation. It includes records that all at once:
- match your filter (or were selected with checkboxes);
- have the main email field filled in — the second and third addresses aren't used;
- aren't in the Trash;
- have newsletter consent.
Identical addresses are merged: if one email address is saved in three contacts, the email goes out once.
The list is a snapshot, not a live query. Changing the filter later, adding customers or giving someone an address won't change a newsletter you already created. You can add a person only by hand, with the “+” button on the “List of recipients” tab. If the database changed a lot, just create the newsletter again.
How to start a newsletter and how fast emails go out
The “Newsletters” window opens with the same paper plane in contacts. Its columns are “In Progress”, “Finished”, “Channel” (Email or SMS), “Newsletter Name”, and dates; its buttons are “Add”, “New SMS campaign”, “Start Newsletter”, copy and delete. While a newsletter is running, “Stop Newsletter” appears.
1
Start Newsletter2
In Progress column3
Finished column- Start Newsletter — launches the selected newsletter.
- In Progress — shows whether a newsletter is currently being sent.
- Finished — shows whether a newsletter has completed.
“Start Newsletter” asks who to send to: “Send to everyone” or “Send to those not yet sent”. The first option resets the newsletter's whole history — sent marks, error counters and views — and starts from scratch.
So “to everyone” after a partial run means some people get the email a second time. The dialog selects “Send to everyone” by default, so after a partial run you have to switch the option by hand.
Then the queue takes over. Right after you start it, the browser sends the first two emails — so you can see the mechanism is working. The background queue picks up the rest, and it has built-in pauses:
- the queue is checked by a background job on the server — usually once a minute;
- one run takes no more than 20 recipients;
- there's a 5-second pause before the first email of a run;
- between emails there's a random pause of 5 to 30 seconds. These two numbers are set in the email template, in the “Flood protection: dynamic pause when sending emails” block, with the “Pause from, seconds” and “Pause to, seconds” fields.
The pauses keep the mail service from treating the sending as spam. Don't reduce them to zero.
What the newsletter results show
The “List of recipients” tab in the newsletter form shows each recipient as a separate row: “Sent”, “Recipient name”, “Recipient address”, “Delivered”, “Seen”, “Seen date”, “Errors (retry count)”, “Error text”. The menu exports the list to a file — “All” or “Only viewed”. The file gets the rows matching the grid filter, with the “Sent” mark in the status column.
What to make of it:
- “Sent” — the system handed the email to the SMTP server without an error. It doesn't mean the email reached the recipient's mailbox.
- “Seen” and “Seen date” — the transparent pixel in the email body fired: the recipient opened the email and their mail app loaded images. Many clients don't load images, so real opens are always higher than the column shows. One more condition: if the newsletter template has a specific mailbox selected, the pixel is added only when that mailbox has “Track opens” on. The connection wizard turns this switch on itself; if the mailbox was added without the wizard or the switch was turned off, the column stays empty until you turn it on in the mailbox card. When the template has no mailbox selected, the pixel is always added.
- “Errors (retry count)” and “Error text” — the mail server's reply, word for word. If the email didn't go out because the sending mailbox isn't set up or the template has an empty subject or body, it says “Email not sent: no usable mailbox or required fields are empty” with a list of what's missing, and this also counts as an attempt. After three failed attempts the recipient isn't picked up anymore — until the newsletter is restarted.
- “Delivered” — this column is never filled in. There's no point in looking at it.
If a run breaks off halfway (the server rebooted, sending hung), a recipient already taken into work is left hanging: later runs skip them until 30 minutes have passed since they were taken, and then the “in progress” mark clears by itself.
You don't have to wait — restart instead: “Start Newsletter” clears the “in progress” mark from all rows at once. Choose “Send to those not yet sent” so you don't resend to those who already got the email.
The same option also returns recipients who used up their three attempts to the queue: everyone who never got the email has the error counter reset and gets three more attempts. Those marked “Sent” get no repeat. “Send to everyone”, by contrast, resets everything, including “Sent” marks, and emails all of the newsletter's recipients again.
- Start
- State
- End
- Note
How to stop a newsletter started by mistake
Click “Stop Newsletter” in “Newsletters” — it doesn't ask for confirmation. The newsletter is marked as stopped and also as “Finished”, even if not everyone got the email: the “Finished” checkbox after a stop doesn't mean the list was completed. Background runs don't pick up a stopped newsletter anymore.
A run that's already going at that moment checks for a stop before each email: it halts at the next recipient, and those it took but didn't get to go back to the queue without the “in progress” mark. The email that was being sent at the moment you clicked will still go out.
You can remove a single recipient who hasn't been emailed yet from the list: the “List of recipients” tab, the row, the trash icon. The row is deleted, and the queue won't pick it up again.
The “List of recipients” tab gives you the full list of who was emailed: in the filter row of the “Sent” column, keep the checked ones. To get this list as a file, after filtering export it from the menu with the “All” option: the file gets only the filtered rows, and the “Sent” mark is in the status column.
If you later need to finish the newsletter, start it with the “Send to those not yet sent” option: those marked “Sent” won't get a repeat email.
How to let a customer unsubscribe
Consent is controlled by a switch in the “Marketing” section of the contact card. An important detail: it's on by default — both in a new card and for everyone added by import. So in practice the “has consent” filter excludes exactly those who unsubscribed themselves.
The system adds the “Unsubscribe from the mailing list” link itself
At the bottom of every newsletter email, the system adds the line “Unsubscribe from the mailing list” in the recipient's language (Ukrainian, Russian or English; English for other languages). You don't need to put the link in the template. If the template already has its own unsubscribe link, the system doesn't add a second one.
The same link goes in a service header of the email, which Gmail and Yahoo use to show their own “Unsubscribe” button in their interface.
Both the line and the header go only to contacts with an internal ID. Records added in recent versions of the system have it automatically; older contacts don't — those recipients get the email without an unsubscribe link.
Your own link design
Want a button in your brand style or different wording? Put the {unsubscribe_url} placeholder in the template: the system replaces it with that recipient's ready-made unsubscribe address. For example:
<a href="{unsubscribe_url}">I don't want these emails</a>
Then the automatic line at the bottom won't be added. The same placeholder also works in the text of an SMS campaign. The other template fields are in the section on templates.
What a person who unsubscribed sees
The link opens a page in the recipient's language: “You have unsubscribed” and a note that order emails will still arrive as usual. The page has a “Resubscribe” button — if the person clicked the link by mistake, it restores their consent in one click. If the link passes a website address, “Back to the website” appears below as well.
When a person unsubscribes — with the mail client button or the email link — the system removes consent, records the date and method, and adds an “Unsubscribed” event to the card's feed. That's the record to point to if a spam complaint comes in. “Resubscribe” turns consent back on, and the feed gets a “Resubscribed to the newsletter” event.
Scenarios
Send an email to those who agreed, from a separate mailbox
What to turn on. In “Contacts”, filter the people you need, then paper plane icon → “Create a newsletter based on the filter set in the contact grid”. In the “Newsletter setup” window, choose the mailbox in the “Sender's E-Mail” field and, if needed, change “Pause from, seconds” and “Pause to, seconds”. Then in “Newsletters” — “Start Newsletter”.
What you get. The list includes records with the main email filled in, with newsletter consent and not in the Trash, one per address. After the start the browser sends two emails, and the background queue takes the rest — up to 20 recipients per run, with a random pause between emails within the range of the two fields.
Zero in a pause field means the standard 5 and 30 seconds, not sending without pauses. The email goes from the selected mailbox; if its SMTP server, login, password or sender address is empty — from the “Default” mailbox, and without one, from any active mailbox.
What won't happen. Anyone who unsubscribed or was moved to the Trash after the newsletter was created won't get the email: the queue checks consent and the Trash on every run. But a customer added after creation won't join the list by themselves — only with the “+” button on the “List of recipients” tab.
First newsletter: test it on your own addresses
What to do. Write the email template — the system adds the “Unsubscribe from the mailing list” link at the bottom by itself (unsubscribing). Send your first newsletter to a dozen of your own addresses.
What you get. The “List of recipients” tab shows who the email went to, who opened it, and the error text if the mail server refused. After that, send to your database.
Finish a newsletter that broke off
What to do. In “Newsletters”, click “Start Newsletter” and switch the option to “Send to those not yet sent”.
What you get. The “in progress” mark clears from all rows, and recipients without “Sent” get three more attempts. Those who already got the email won't get a repeat.
What to do when a recipient didn't get the email
| What you see | Why | What to do |
|---|---|---|
| A recipient in the newsletter has no “Sent” mark and doesn't move | either the run broke off and the recipient was left “in progress”, or the three attempts are used up — these are different cases, and they're fixed differently | read the “Error text” in their row. In both cases, restarting the newsletter with “Send to those not yet sent” helps: it clears the “in progress” mark and resets the attempt counter for those who didn't get the email; read the “Error text” first so you don't repeat the same refusal (newsletter results) |
| The “Delivered” column is empty for all recipients | the system doesn't set the delivery mark at all | go by “Sent” and “Seen” (newsletter results) |
| “Error text” says “Email not sent: no usable mailbox or required fields are empty” | the template's mailbox is missing the SMTP server, login, password or sender address, or the template has an empty subject or body — the brackets say what exactly | fill in the mailbox or the template (several mailboxes) and restart with “Send to those not yet sent” |
FAQ
How many emails go out in one newsletter run?
No more than twenty. Between emails there's a random pause of 5 to 30 seconds; these numbers are set by the “Pause from, seconds” and “Pause to, seconds” fields in the template (starting and speed).
Why is the “Delivered” column always empty?
The system doesn't set the delivery mark at all. Look at “Sent” — the email was handed to the mail server without an error — and at “Seen” (newsletter results).
Can I send a newsletter via Viber or SMS?
Yes, SMS: “Contacts” → paper plane icon → “SMS campaign by filter or selection”. If Viber is turned on in the SMS settings, the message goes to Viber first, and if it isn't delivered — by SMS (SMS campaign).
A customer was added after the newsletter was created — will they get the email?
No: the recipient list is collected once, at the moment of creation. Add them with the “+” button on the “List of recipients” tab or create the newsletter again (who ends up on the list).
Does the system add an “Unsubscribe” button by itself?
Yes. “Unsubscribe from the mailing list” appears at the bottom of a newsletter email in the recipient's language, and Gmail and Yahoo show their own button. Both only for contacts with an internal ID (how to let a customer unsubscribe).
Where it is and who has access
- Menu
- Contacts → paper plane icon in the header → “Newsletters”
- Other ways in
- the “Newsletter” button on the bar that pops up under selected contacts
- Access right
- “Newsletters”; in the “Contacts” rights — “Button “Contact groups””
- Prepare
- a mailbox to send from and an email template
The “Contact groups” button in the “Contacts” window rights controls both the newsletter icon in the header and the “Newsletter” button. Creating a newsletter doesn't check a right of its own.
Related topics
- If you need the big picture of mail — Mail in Elbuz.
- If the email template isn't written yet — an email template with placeholders.
- If the newsletter should go from a separate mailbox — several mailboxes: which one the email goes from.
- If the email should go out on an event rather than to everyone at once — trigger rules.
- If you need to pick recipients by other card fields — the contact list and the contact card.
