# 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.&#x20;

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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mercuri.cx/features/introduction-mercuri-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
