FAQ
=================

Why is the Route Not Triggering?
--------------------------------

There are a few key conditions that must be met for a route to trigger properly:

- **✅ Domain is Verified**
  Make sure you've added the DNS TXT token correctly. Your domain should show as **Verified** inside the MailTrigger UI.

- **✅ Route is Enabled**
  Double-check that the route’s **Enabled** toggle is turned on.

- **✅ Rule Filters Pass**

  - If **Match All** is selected: all rules must match.
  - If **Match Any** is selected: at least one rule must match.
  - If there are no rules and **Match Any** is selected: the route triggers on **every** message.

- **✅ Authentication Checks Pass (or are allowed)**

  .. note::

     If SPF/DKIM fails **and** the domain’s DMARC policy is set to ``reject``,
     the message will be **rejected immediately** by the SMTP server.
     → No route logs. No actions.

     If DMARC is set to ``quarantine`` or ``none``,
     the message is still **accepted**, but:

     - Route logs will show status: ``quarantined``
     - Actions will **not** be executed

What Are SPF / DKIM / DMARC Checks?
-----------------------------------

These are email authentication technologies used to combat spoofing and phishing:

- **SPF (Sender Policy Framework)**
  Declares which IP addresses or servers are authorized to send email for your domain.
  Receiving servers check if the sender’s IP is allowed.

- **DKIM (DomainKeys Identified Mail)**
  Adds a digital signature to your emails.
  Receivers verify it using your domain’s **public DKIM key** in DNS.
  This ensures the message wasn't tampered with.

- **DMARC (Domain-based Message Authentication, Reporting & Conformance)**
  Defines what to do if SPF and/or DKIM checks **fail**.
  It enforces policy (`none`, `quarantine`, or `reject`) and lets domain owners receive failure reports.

Why Was a Route Marked as Quarantined?
--------------------------------------

This happens when:

- The message **fails** SPF or DKIM,
- And the domain’s **DMARC policy** is set to ``quarantine`` or ``none``.

.. important::

   In this case, MailTrigger:

   - Accepts the email
   - Logs the route as ``quarantined``
   - **Skips** action execution

Why Are There Default "SMTP to Origin" and "Relay to Origin" Routes?
---------------------------------------------------------------------

To ensure mail keeps flowing even without extra setup, MailTrigger adds two default routes when you create a new mailbox:

- **SMTP to Origin**
  Handles **outgoing** mail via your mailbox’s original SMTP host.
  So you can send mail right away, no need for extra config.

- **Relay to Origin**
  For **receiving** mailboxes: this forwards incoming mail to your original mail provider.
  Ideal if you still want to keep your old inbox while using MailTrigger.

.. note::

   These default routes are optional. You can disable or customize them anytime to build advanced logic.