# Introdução: Mercuri API

A **Mercuri Messaging API** permite que as empresas enviem e gerenciem comunicações com os clientes por meio do WhatsApp, SMS e outras plataformas compatíveis. Ela foi projetada para integração perfeita com sistemas como Shopify e Wix.

**Quando a API é usada?**

A API é normalmente utilizada quando as empresas desejam **automatizar** ou **personalizar** a comunicação além do que o painel (dashboard) sozinho pode oferecer.

Alguns casos de uso comuns incluem:

* Envio de **notificações transacionais** (confirmações de pedidos, atualizações de envio, OTPs).
* Disparo de **campanhas automatizadas** (recuperação de carrinho abandonado, lembretes de pagamento).
* Execução de **campanhas de marketing** em vários canais.
* Integração da Mercuri com ferramentas de terceiros ou CRMs.

**Por que usar esta API?**

* **Suporte multicanal**: Alcance os clientes via WhatsApp e SMS.
* **Personalização dinâmica**: Insira variáveis específicas do cliente, como nome, detalhes do pedido ou links.
* **Pronta para automação**: Funciona com fluxos de trabalho de e-commerce, como carrinhos abandonados no Wix/Shopify.
* **Tratamento de erros e rastreamento de entrega**: Receba códigos de status detalhados e respostas de erro.
* **Autenticação segura**: Utiliza chaves de API, recomendando-se o gerenciamento delas com ferramentas como o Wix Secrets Manager.

**Pré-requisitos**

Antes de usar a API, certifique-se de ter:

* Uma **conta Mercuri**.
* Canal configurado (por exemplo, modelos de mensagens do WhatsApp Business aprovados pela Meta).
* Uma **chave de API** gerada no painel da Mercuri.
* (Opcional, mas recomendado) Armazenamento seguro de chaves usando um 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/mercuri-docs-pt/caracteristicas/introducao-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.