Recupere carrinhos abandonados com um agente de IA no WhatsApp (MCP)

A maior parte da recuperação de carrinhos abandonados é um lembrete unidirecional: um template estático é disparado, uma variável é substituída e aí termina a conversa. Ou funciona, ou não funciona. Este guia mostra como fazer melhor usando um agente de vendas com IA de ciclo fechado que tanto envia o lembrete quanto responde quando o cliente reage. Ele lê o carrinho da sua loja, escreve uma mensagem personalizada, envia pela API oficial do WhatsApp Business e depois conduz a troca de mensagens que de fato fecha a venda. Vamos cobrir tanto Shopify quanto WooCommerce, e seremos honestos sobre o que o Wali MCP faz e o que não faz.

O que você vai aprender:

• Como o Wali MCP atua como a camada de ação do WhatsApp para um agente de IA
• Como conectar os dados da sua loja ao agente (Shopify e WooCommerce)
• O ciclo de enviar-e-conversar que recupera mais carrinhos sem quebrar a conformidade

O que o Wali MCP realmente é (e o que ele não pode fazer)

O Wali MCP é um servidor de Model Context Protocol. Em termos simples, é a forma como agentes de IA como Claude, ChatGPT, Cursor e outros chamam as ferramentas de WhatsApp da Wali. É a camada de ação com que o agente pode enviar mensagens e templates, ler conversas e responder na API oficial do WhatsApp Business (WABA). Para conectá-lo bastam uma URL de HTTP-streaming e uma chave de API, e não há nada para instalar.

Aqui vem a parte honesta. O Wali MCP não detecta carrinhos abandonados, não recebe os webhooks da sua loja e não executa agendamentos ou gatilhos por conta própria. Você ainda precisa de duas coisas que ele não pode fornecer: (a) sua loja para detectar o carrinho, e (b) um runtime de agente que dispare quando isso acontecer. O que o MCP acrescenta é transformar o "envio" burro em um envio agentivo e abrir a conversa bidirecional que um template estático jamais terá.

A arquitetura: dois MCPs e um agente

Pense nisso como três partes trabalhando juntas:

• O MCP da loja / Admin API é a fonte dos dados, porque é ali que vive o carrinho abandonado: quem é o cliente, o que ele deixou para trás e a URL de recuperação.
• O Wali MCP é a voz pela qual o agente fala com o cliente no WhatsApp e escuta a resposta.
• O agente de IA é o cérebro e funciona como o runtime que é acionado, lê os dados, decide o que dizer e conduz a conversa até o fechamento.

A loja fornece a metade que o agente precisa para ser relevante; a Wali fornece a metade que ele precisa para ser ouvido. Nenhum dos lados substitui o outro.

Passo 1 - Conecte o Wali MCP

Adicione a Wali como um servidor MCP no seu cliente de IA. A configuração é uma URL e sua chave de API, que você adiciona como um parâmetro de consulta:

{
  "mcpServers": {
    "wali": {
      "url": "https://api.wali.chat/mcp?key=YOUR_API_KEY"
    }
  }
}

Isso funciona com Claude (Desktop, os conectores do claude.ai, Claude Code e a API), ChatGPT e Cursor. Você não instala pacote nenhum nem mantém um processo local, porque tudo passa por um endpoint remoto de HTTP-streaming.

Passo 2 - Dê ao agente os dados da loja

O agente precisa ler o carrinho abandonado. Como você o expõe depende da sua plataforma.

No Shopify, os checkouts abandonados vivem na Shopify Admin API e no Shopify Admin (Dev) MCP, por meio da consulta GraphQL abandonedCheckouts. Use o MCP Admin aqui, e não o Storefront MCP, porque o Storefront MCP público é voltado para o cliente e não expõe os checkouts abandonados. Essa é uma armadilha comum, então configure tudo contra o Admin desde o início.

No WooCommerce, o WooCommerce 10.9 MCP nativo expõe produtos e pedidos, mas não carrinhos abandonados. Então você ainda captura os carrinhos com um plugin de carrinho abandonado (ou seu endpoint REST) e alimenta esses dados ao agente. O plugin detecta o carrinho; o agente o lê.

Passo 3 - O ciclo do agente (enviar + conversar até fechar)

Este é o padrão que recupera mais receita do que um lembrete estático:

1. Gatilho. Sua loja detecta o carrinho abandonado pelo evento nativo de checkouts da Shopify ou pelo plugin do WooCommerce.
2. Leitura. O agente lê o carrinho (cliente, itens, URL de recuperação) por meio do MCP da loja ou da Admin API. Ele pode confirmar o número primeiro com verifyWhatsAppNumberExists.
3. Envio. O agente escreve uma mensagem personalizada que vai muito além de uma simples troca de variável e a envia com send_whatsapp_message. Fora da janela de 24 horas, isso ainda é um template de Marketing pré-aprovado, então a conformidade permanece inalterada.
4. Conversa. O cliente responde. Agora você está dentro da janela de 24 horas, então o agente lê a conversa com get_whatsapp_chat_messages, verifica estoque ou preço por meio do MCP da loja, responde a objeções, oferece um desconto se fizer sentido e envia o link de recuperação para fechar.
5. Marcação e transferência. O agente etiqueta o resultado com manage_whatsapp_labels (recuperado / cancelou opção) e transfere para um humano se não conseguir resolver.

As ferramentas que o agente usa

Exemplo: o agente em ação

Um system prompt curto mantém o agente nos trilhos:

You are a cart-recovery sales agent for our store on WhatsApp.

- Detecting carts is NOT your job. You receive a cart with the customer,
  the items, and a recovery URL. Act on that.
- Personalize every message. Reference the actual items. Never sound like
  a mail merge.
- Respect compliance: outside 24h since the customer's last message you may
  ONLY send a pre-approved Marketing template, and only with opt-in.
  Inside 24h you may speak freely.
- Always include the recovery link when nudging or closing.
- If the customer asks about price or stock, check the store before answering.
- You may offer up to a 10% discount on carts over $80.
- Label the outcome (recovered / opted-out) and hand off to a human if you
  cannot resolve the request.

Uma conversa de exemplo:

Agente: Oi, Maria! Você deixou o Vestido Midi de Linho (tamanho M) no seu carrinho. Ainda quer? Aqui está o seu link para finalizar: store.example/cart/abc123

Maria: Eu não tinha certeza do tamanho, e o frete pareceu caro.

Agente: Totalmente justo. O M veste fiel ao tamanho nesse vestido, e ele está em estoque agora mesmo. Posso adicionar o código LINEN10 com 10% de desconto, e o frete é grátis acima de R$ 75, valor que o seu carrinho já alcança. Quer que eu aplique? Aqui está o seu carrinho: store.example/cart/abc123

Maria: Pronto, acabei de comprar. Obrigada!

Agente: Adorei saber! Seu pedido está confirmado. Aproveite o vestido! 🎉

O agente então etiqueta a conversa como recovered e segue adiante.

Sem plano Enterprise? Use um nó de Agente de IA no Wali Flows

O Wali MCP é um recurso do nível Enterprise. Se você está em um plano inferior, pode obter o mesmo resultado dentro do Wali Flows integrado ou via n8n com um nó de Agente de IA que chama as mesmas ferramentas de WhatsApp. O flow cuida do gatilho e do agendamento; o nó de Agente de IA cuida da personalização e da lógica de resposta. O padrão de enviar-e-conversar continua igual, com a diferença de que quem orquestra passa a ser o Flows e não um cliente MCP autônomo.

Conformidade e custo

As regras não mudam só porque uma IA está conduzindo:

• Para iniciar uma conversa fora da janela de 24 horas, você precisa de um template de Marketing pré-aprovado e de um opt-in válido.
• Dentro de 24 horas da última mensagem do cliente, você pode enviar mensagens de formato livre.
• Quebre isso e você recebe o erro 131047, porque o MCP não tem como burlar as regras da Meta.
• Sempre respeite um STOP em texto livre e etiquete o contato como tendo cancelado a opção.

Sobre o custo: toda mensagem conduzida por IA carrega uma chamada de LLM, então um modelo híbrido é a jogada inteligente. Deixe o agente cuidar dos carrinhos de alto valor e das respostas ao vivo, onde a personalização e o tratamento de objeções se pagam. Use um template simples para a cauda longa de carrinhos de baixo valor. Veja os preços do WABA para o lado das mensagens e as campanhas para envios de templates em massa.

Perguntas frequentes

O Wali MCP detecta carrinhos abandonados?

Não. O MCP é a camada de ação do WhatsApp e serve para enviar, ler e responder. A detecção acontece do lado da loja (o evento de checkouts da Shopify ou um plugin do WooCommerce), e um runtime aciona o agente.

Shopify Storefront ou Admin MCP para checkouts abandonados?

Admin. O Storefront MCP é voltado para o cliente e não expõe os checkouts abandonados. Use o Shopify Admin MCP com a consulta GraphQL abandonedCheckouts.

Ainda preciso de um template de Marketing?

Sim. Fora da janela de 24 horas, a primeira mensagem precisa ser um template de Marketing pré-aprovado com opt-in. O agente personaliza dentro dessas regras, mas não as substitui.

Quanto custa para operar?

Duas camadas: as cobranças de mensagens do WhatsApp pela Meta, mais uma chamada de LLM por mensagem conduzida por IA. Um híbrido mantém o custo sob controle, com IA nos carrinhos de alto valor e nas respostas, e templates na cauda longa.

Isso funciona em um plano que não seja Enterprise?

O MCP em si é do nível Enterprise. Em planos inferiores, use um nó de Agente de IA no Wali Flows (ou n8n) para executar o mesmo ciclo de enviar-e-conversar com as ferramentas integradas.

Recursos

• Wali Flows traz automação integrada e nós de Agente de IA
• Preços do WABA lista os custos de mensagens do WhatsApp
• Campanhas faz envios de templates em massa
• Shopify Admin API expõe a consulta GraphQL abandonedCheckouts
• Documentação para desenvolvedores do WooCommerce cobre REST e MCP
• Visão geral dos templates do WhatsApp e regras de opt-in

O que vem a seguir

Conecte os dados da sua loja a um agente de IA e deixe-o enviar e fechar no WhatsApp. Comece com a Wali.