booking.created).
Minimo keeps the rules (which email, when) and the clock:
- a rule sends an email right away, or at an offset from a date in the event (“2 hours before
booking_at”); - a
booking.cancelledwith the samecancellationKeycancels what is still pending; abooking.updatedmoves it; - each restaurant can switch a rule off in the automatic messages widget;
- the email is the restaurant’s own copy of the template when it personalized one.
Before you start
- An API key with the Events permission (
events) to send events, and Widgets (widgets) to manage the rules. Keep it on your server. - The email templates (masters) your tenants use, e.g. confirmation, reminder, review request. Create them in the
Minimo dashboard (Templates → Create new template → Create email template) or with your API key
(
POST /public/v1/ai/transactional-templates, permission Transactional). Put the template’suidinmasterTemplateIdsand in your rules. - Every template needs a subject. In the dashboard you type it. The API always saves one. A template without a subject
is never sent: the send is recorded as
failedwith the reasonempty_subject. Add a subject in the editor and the next sends go out.
Define the rules once (for every restaurant)
booking.cancelled first cancels what is still pending for the booking (reminder, review request), then sends the emails of the rules it triggers.
PUT adds or updates the rules you send (by key) and returns every rule with a readable timing (“Immediately”, “2 hours before”) and the template’s templateUid; GET /public/v1/automation-rules lists them, DELETE /public/v1/automation-rules/{key} removes one (204). A rule with an offset and no dateField is refused (422 INVALID_AUTOMATION_RULE).
Guests who speak different languages
A rule cannot choose the template by the guest’s language. So use one master and one event name per language. This is about the guests’ emails. The widgets your restaurants use stay in English or Italian. SetcancelOn and rescheduleOn yourself. The defaults come from the event name: with booking.created.de the
rule would wait for booking.created.cancelled.
booking.created.<language> and booking.updated.<language> with the guest’s language. One
booking.cancelled (same cancellationKey) cancels what is pending in every language.
Every restaurant sees all these masters and rules, in every language, in the
Automatic messages widget. There is no filter by language.
If your app already writes its emails in every language, send your own HTML with POST /public/v1/emails. It is
simpler: see Senders and sending.
Per restaurant: switch off or change a rule
The automatic messages widget shows each tenant an Automatic sends list with an on/off switch per rule. The choice is saved by Minimo for that tenant and your page receivesautomation.toggled with { tenant, rule, enabled }. A send of a rule that is off is recorded as skipped / disabled_by_tenant.
By API (any field of a default can be overridden for one tenant, using the default’s key; a key without a default is the tenant’s own rule and needs event, template and the timing, with "offset": null for an immediate one, otherwise 422 INVALID_AUTOMATION_RULE):
GET /public/v1/tenants/{tenant}/automations returns the tenant’s effective rules (source: default, override or tenant); DELETE /public/v1/tenants/{tenant}/automations/{key} goes back to the default (204, 404 when the tenant has no override for that key).
Limits
- Email only; one event gives one email per rule. No multi-step flows, waits or conditions (use the workspace automations for those).
- Changing a rule’s offset does not move sends already planned: send the update event.
- Offsets up to one year.
If something fails
A rule that is not valid answers422 INVALID_AUTOMATION_RULE: userMessage says which field. Every code:
Errors and limits. Reference:
Save Default Rules.