# 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.