> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ofatoura.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Email and Push Notification Settings

> Configure which email notifications oFatoura sends, set up your SMTP or Resend mail connection, manage sales report subscriptions, and connect Beamer and Pusher for real-time in-app alerts.

Three separate settings pages work together to control how oFatoura communicates with your team and customers: **Email & Notification Settings** controls which events trigger emails, **Email Configuration** sets up the mail connection those emails travel over, and **Push Notification Settings** connects Beamer and Pusher for live, in-app alerts.

<Note>
  You need the **Manage Settings** permission to change any of these settings.
</Note>

***

## Email & notification settings

Go to **Settings → Email & Notification Settings** in the web admin.

This page lets you choose which order and operational events send an email, add up to five addresses to receive a recurring sales report, and send a quick test message to confirm everything is working.

### Per-event email toggles

Each notification type has its own on/off toggle. Events you can enable or disable include:

* New order received
* Order confirmation
* Order cancellation
* Payment received
* Refund processed
* Reservation created
* Waiter request submitted

Turn the toggle on for any event you want your team to receive an email about, and off for events you would rather not notify by email.

### Sales report subscriptions

<Steps>
  <Step title="Add a subscription email">
    In the **Subscription Emails** field, type a valid email address and save. You can add up to **five addresses** per branch.
  </Step>

  <Step title="Remove an address">
    Click the remove control next to any address you no longer want to receive the report.
  </Step>
</Steps>

<Tip>
  Subscription emails receive recurring sales summaries for the branch. If you manage multiple branches, set subscriptions separately for each branch.
</Tip>

### Test email

Enter a recipient address in the **Test Email** field and click **Send Test Email**. If the message arrives, your notification settings and mail connection are working correctly. If it does not arrive, check your Email Configuration (below).

***

## Email configuration

Go to **Settings → Email Configuration** in the web admin.

This page sets up the mail connection that all notification emails use. You must save a valid configuration here before notification emails can be delivered.

<Steps>
  <Step title="Choose a mail driver">
    Select **SMTP** or **Resend** from the **Mail Driver** dropdown. SMTP works with any standard mail provider (Gmail, SendGrid, Mailgun, your own server, etc.). Resend is a transactional email service that requires only an API key.
  </Step>

  <Step title="Enter your credentials">
    Fill in the fields that appear for your chosen driver:

    **For SMTP:**

    | Field      | What to enter                                     |
    | ---------- | ------------------------------------------------- |
    | SMTP Host  | Your mail server hostname (e.g. `smtp.gmail.com`) |
    | SMTP Port  | Typically 465 (SSL) or 587 (TLS)                  |
    | Encryption | **TLS** or **SSL**                                |
    | Username   | Your mail account username or address             |
    | Password   | Your mail account password or app password        |

    **For Resend:**
    Enter your Resend API key in the **Mail Password** field. No host or port is needed.
  </Step>

  <Step title="Set the sender identity">
    Fill in **Mail From Name** (the display name recipients see, e.g. "Your Restaurant Name") and **Mail From Email** (the address emails are sent from).
  </Step>

  <Step title="Enable queue (optional)">
    Toggle **Enable Queue** on if you want emails to be sent in the background rather than immediately. This is recommended on busy systems to avoid slowing down order processing.
  </Step>

  <Step title="Test the connection">
    Click **Send Test Email**, enter a recipient address in the modal, and send. A successful delivery confirms your configuration is correct.
  </Step>
</Steps>

<Warning>
  If you change your mail driver or credentials, send a test email immediately to confirm delivery before relying on live notification emails.
</Warning>

***

## Push notification settings

Go to **Settings → Push Notifications** in the web admin.

This page connects two real-time notification services: **Beamer** for in-app announcement banners, and **Pusher** for live order-update broadcasting to the web dashboard and waiter app.

### Beamer (in-app announcements)

Beamer displays notification banners inside the oFatoura dashboard for your team.

<Steps>
  <Step title="Enable Beamer">
    Turn on the **Beamer Status** toggle.
  </Step>

  <Step title="Enter your Beamer credentials">
    Paste your **Beamer Instance ID** and **Beamer Secret** from your Beamer account dashboard.
  </Step>

  <Step title="Save">
    Click save. In-app announcements will now appear for staff logged in to the web admin.
  </Step>
</Steps>

### Pusher (real-time broadcasting)

Pusher powers live order-status updates on the dashboard and the waiter app. Without it, staff must refresh manually to see new orders.

<Steps>
  <Step title="Enable Pusher">
    Turn on the **Pusher Broadcast Status** toggle.
  </Step>

  <Step title="Enter your Pusher credentials">
    Copy the four values from your Pusher app dashboard and paste them here:

    | Field   | Where to find it                               |
    | ------- | ---------------------------------------------- |
    | App ID  | Pusher dashboard → App Keys                    |
    | Key     | Pusher dashboard → App Keys                    |
    | Secret  | Pusher dashboard → App Keys                    |
    | Cluster | Pusher dashboard → App Keys (e.g. `ap2`, `eu`) |
  </Step>

  <Step title="Save">
    Click save. Real-time updates will begin flowing immediately for active sessions.
  </Step>
</Steps>

<Note>
  Pusher credentials are per-restaurant. If you have multiple branches, all branches under the same restaurant share this Pusher configuration.
</Note>

***

## Related

* [Waiter App (ePOS) Settings](/settings/waiter-app-settings) — control what staff see and can do in the waiter app
* [WhatsApp Notification Preferences](/whatsapp/notification-preferences) — send order and reservation updates via WhatsApp
* [Branches and Operating Hours](/settings/branches-and-operating-hours) — manage branch details relevant to per-branch notification subscriptions