# Introduction: Mercuri API

The **Mercuri Messaging API** enables businesses to send and manage customer communications across WhatsApp, SMS channels, and other supported platforms. It is designed for seamless integration with systems like Shopify and Wix

#### **When is the API used?**

The API is typically used when businesses want to automate or personalize communication beyond what the dashboard alone can provide. 

Some common use cases include:

* Sending **transactional notifications** (order confirmations, shipping updates, OTPs).
* Triggering **automated campaigns** (cart abandonment recovery, payment reminders).
* Running **marketing campaigns** across multiple channels.
* Integrating Mercuri with third-party tools or CRMs.

#### **Why use this API?**

* **Multi-channel support**: Reach customers via WhatsApp and SMS
* **Dynamic personalization**: Insert customer-specific variables like names, order details, or links.
* **Automation-ready**: Works with e-commerce workflows such as Wix /Shopify abandoned carts.
* **Error handling & delivery tracking**: Get detailed status codes and error responses.
* **Secure authentication**: Uses API keys, recommended to be managed with tools like Wix Secrets Manager.

#### **Prerequisites**

Before using the API, make sure you have:

* A **Mercuri account**.
* Channel setup (e.g., WhatsApp Business templates approved by Meta).
* An **API key** generated from the Mercuri dashboard.
* (Optional but recommended) Secure key storage using a Secret Manager.