# Notification Providers

<p class="doc-lead">Providers store connection details for outbound messaging — <b>Email (SMTP)</b>, <b>WhatsApp Cloud</b>, and <b>WATI</b> — used by the Notification System.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<div class="doc-toc-links">
<a href="#/settings/notification-providers?id=overview">Overview &amp; List View</a>
<a href="#/settings/notification-providers?id=email-fields">Email Provider Fields</a>
<a href="#/settings/notification-providers?id=whatsapp-fields">WhatsApp Provider Fields</a>
<a href="#/settings/notification-providers?id=actions">Actions</a>
<a href="#/settings/notification-providers?id=faq">FAQ</a>
<a href="#/settings/notification-providers?id=related">Related</a>
</div>
</div>
</div>

<hr class="doc-section-divider">

<h2 id="overview">Overview &amp; List View</h2>

Go to <b>Settings → Notification System → Providers</b>.

<!-- screenshot pending -->

<b>List columns</b>: Id, Name, Provider Type, API Endpoint, Phone Number ID.

<b>Quick filters</b>: Active (default), Suspended.

<b>Filters</b>: Name, Provider Type, Created Date.

<b>List actions</b>: New, View, Edit, Delete (multi).

<hr class="doc-section-divider">

<h2 id="email-fields">Email Provider Fields</h2>

Select <b>Provider Type = Email</b> on New or Edit. The <b>Email Configuration</b> section appears; WhatsApp sections are hidden.

| **Field** | **Description** |
|-----------|-----------------|
| Name * | Friendly label (e.g. Company Sales Mail). |
| Provider Type * | Email |
| SMTP Host * | Mail server hostname. |
| SMTP Port * | Usually 587 (TLS) or 465 (SSL). |
| Username * | SMTP login — often full email address. |
| Password | SMTP password. On edit, leave blank to keep existing password. |
| Encryption | TLS, SSL, or None. |
| From Email * | Sender address on outgoing mail. |
| From Name | Display name with From Email. |
| Reply-To | Optional reply address. |
| Test Email To | Address for inline <b>Send Test</b> button on edit form. |
| Email Signature | HTML appended to all emails (manual and automatic). |

<b>Send Test</b> on the edit form uses current field values (including unsaved changes) so you can verify SMTP before clicking Update.

<p>Full walkthrough: <a href="#/features/email-notifications?id=provider-setup">Email Notifications → Provider setup</a></p>

<hr class="doc-section-divider">

<h2 id="whatsapp-fields">WhatsApp Provider Fields</h2>

<h3>WhatsApp Cloud</h3>

| **Field** | **Description** |
|-----------|-----------------|
| Name * | Friendly label. |
| Provider Type * | WhatsApp Cloud |
| API Endpoint | Meta Graph API URL (default https://graph.facebook.com/v18.0). |
| Phone Number ID * | Meta sender phone number ID. |
| Access Token * | Meta API token with send permissions. |

<h3>WATI</h3>

| **Field** | **Description** |
|-----------|-----------------|
| Provider Type * | WATI |
| API Endpoint * | https://api.wati.io |
| Phone Number ID * | WATI phone identifier. |
| API Token * | WATI bearer token. |

<p>Full walkthrough: <a href="#/features/whatsapp?id=provider-setup">WhatsApp Messaging → Provider setup</a></p>

<hr class="doc-section-divider">

<h2 id="actions">Actions</h2>

| **Action** | **Description** |
|------------|-----------------|
| New | Create provider. |
| View | Read-only details. |
| Edit | Change credentials and settings. Email providers: <b>Send Test</b> on Test Email To field. |
| Delete | Remove unused provider — reassign Transaction Configs first. |
| Activate / Suspend | Enable or disable without deleting. |

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<p><b>Can I have multiple providers?</b></p>
<p>Yes — separate records per SMTP account, WhatsApp number, or vendor. Link each on <a href="#/settings/notification-transaction-configs">Transaction Configs</a>.</p>

<p><b>Where do API credentials go?</b></p>
<p>On the provider edit form. Passwords and tokens are stored securely and never shown again after save — use <b>SMTP Password Set</b> / has-password indicator on view.</p>

<p><b>What is Phone Number ID?</b></p>
<p>WhatsApp Cloud API sender identifier from Meta Business Manager — not the display phone number customers see.</p>

<p><b>Test email says authentication failed (535).</b></p>
<p>Use app-specific passwords for Gmail/Microsoft; match port and encryption; verify username is full email. See <a href="#/features/email-notifications?id=faq">Email FAQ</a>.</p>

<p><b>Can I suspend a provider temporarily?</b></p>
<p>Suspend stops new sends using that provider. Update or suspend Transaction Configs that reference it before deletion.</p>

<p><b>Do providers send in-app notifications?</b></p>
<p>No. Providers are for outbound WhatsApp/email. In-app inbox uses <a href="#/settings/notification-settings">Notifications</a> subscriptions.</p>

<p><b>Why are messages failing in Transaction History?</b></p>
<p>Check credentials, template approval (WhatsApp), recipient format, and Failed row error text in <a href="#/settings/notification-transaction-history">Transaction History</a>.</p>

<hr class="doc-section-divider">

<h2 id="related">Related Topics</h2>

<ul>
<li><a href="#/features/email-notifications">Email Notifications</a></li>
<li><a href="#/features/whatsapp">WhatsApp Messaging</a></li>
<li><a href="#/settings/notification-templates">Templates</a></li>
<li><a href="#/settings/notification-transaction-configs">Transaction Configs</a></li>
</ul>
