Recuperare i carrelli abbandonati con un agente AI su WhatsApp (MCP)

La maggior parte dei recuperi di carrelli abbandonati è un promemoria a senso unico: si attiva un template statico, viene sostituita una variabile e la conversazione finisce lì. Funziona oppure no. Questa guida ti mostra qualcosa di migliore: un agente di vendita AI a ciclo chiuso che invia il sollecito e risponde quando il cliente replica. Legge il carrello dal tuo negozio, scrive un messaggio personalizzato, lo invia tramite la WhatsApp Business API ufficiale e poi gestisce il botta e risposta che chiude davvero la vendita. Tratteremo sia Shopify sia WooCommerce e saremo onesti su ciò che il Wali MCP fa e non fa.

Cosa imparerai:

• Come il Wali MCP funge da livello di azione WhatsApp per un agente AI
• Come collegare i dati del tuo negozio all'agente (Shopify e WooCommerce)
• Il ciclo invia-e-conversa che recupera più carrelli senza violare la compliance

Cos'è davvero il Wali MCP (e cosa non può fare)

Il Wali MCP è un server Model Context Protocol. In parole semplici, è il modo in cui gli agenti AI come Claude, ChatGPT o Cursor chiamano gli strumenti WhatsApp di Wali. È il livello di azione con cui l'agente può inviare messaggi e template, leggere le conversazioni e rispondere sulla WhatsApp Business API ufficiale (WABA). Per collegarlo bastano un URL HTTP-streaming e una chiave API, senza nulla da installare.

Ecco la parte onesta. Il Wali MCP non rileva i carrelli abbandonati, non riceve i webhook del tuo negozio e non esegue pianificazioni o trigger da solo. Ti servono comunque due cose che non può fornire: (a) il tuo negozio per rilevare il carrello e (b) un runtime dell'agente che si attivi quando ciò accade. Ciò che l'MCP aggiunge è il passaggio da un banale "invia" a uno agentico, insieme alla conversazione bidirezionale che un template statico non potrà mai avere.

L'architettura: due MCP e un agente

Pensala come tre parti che lavorano insieme:

• L'MCP del negozio / Admin API porta i dati, perché è lì che vive il carrello abbandonato: chi è il cliente, cosa ha lasciato e l'URL di recupero.
• Il Wali MCP ci mette la voce con cui l'agente parla al cliente su WhatsApp e ne ascolta la risposta.
• L'agente AI fa da cervello, ossia il runtime che si attiva, legge i dati, decide cosa dire e guida la conversazione verso la conclusione.

Il negozio fornisce la metà di cui l'agente ha bisogno per essere pertinente; Wali fornisce la metà di cui ha bisogno per essere ascoltato. Nessuna delle due parti sostituisce l'altra.

Passo 1 - Collega il Wali MCP

Aggiungi Wali come server MCP nel tuo client AI. Tutta la configurazione si riduce a un URL con la tua chiave API passata come parametro della query:

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

Funziona con Claude (Desktop, i connettori di claude.ai, Claude Code e l'API), ChatGPT e Cursor. Trattandosi di un endpoint HTTP-streaming remoto, non ci sono pacchetti da aggiungere né processi locali da avviare.

Passo 2 - Fornisci all'agente i dati del negozio

L'agente deve leggere il carrello abbandonato. Il modo in cui lo esponi dipende dalla tua piattaforma.

Su Shopify i checkout abbandonati vivono nella Shopify Admin API e nell'MCP Shopify Admin (Dev), tramite la query GraphQL abandonedCheckouts. Qui ti serve l'MCP Admin, perché lo Storefront MCP pubblico è rivolto al cliente e non espone i checkout abbandonati. È un tranello comune, quindi configuralo su Admin fin dall'inizio.

Su WooCommerce l'MCP nativo della 10.9 espone prodotti e ordini, ma non i carrelli abbandonati. Quindi devi comunque catturare i carrelli con un plugin per carrelli abbandonati (o il suo endpoint REST) e fornire quei dati all'agente. Il plugin rileva il carrello; l'agente lo legge.

Passo 3 - Il ciclo dell'agente (invia + conversa per concludere)

Questo è lo schema che recupera più fatturato di un semplice promemoria statico:

1. Trigger. Il tuo negozio rileva il carrello abbandonato tramite l'evento checkout nativo di Shopify o il plugin di WooCommerce.
2. Leggi. L'agente legge il carrello (cliente, articoli, URL di recupero) tramite l'MCP del negozio o l'Admin API. Può prima confermare il numero con verifyWhatsAppNumberExists.
3. Invia. L'agente scrive un messaggio personalizzato invece di limitarsi a sostituire una variabile, poi lo invia con send_whatsapp_message. Al di fuori della finestra di 24 ore questo è comunque un template Marketing pre-approvato, quindi la compliance resta invariata.
4. Conversa. Il cliente risponde. Ora sei dentro la finestra di 24 ore, quindi l'agente legge il thread con get_whatsapp_chat_messages, verifica disponibilità o prezzo tramite l'MCP del negozio, risponde alle obiezioni, offre uno sconto se ha senso e invia il link di recupero per concludere.
5. Etichetta e passa la mano. L'agente contrassegna l'esito con manage_whatsapp_labels (recuperato / disiscritto) e passa la conversazione a un umano se non riesce a risolverla.

Gli strumenti che usa l'agente

Esempio: l'agente in azione

Un breve system prompt mantiene l'agente sui binari:

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.

Un esempio di conversazione:

Agente: Ciao Maria! Hai lasciato l'Abito Midi di Lino (taglia M) nel carrello. Lo vuoi ancora? Ecco il link per completare l'acquisto: store.example/cart/abc123

Maria: Non ero sicura della taglia e la spedizione mi sembrava cara.

Agente: Più che comprensibile. La M veste fedele alla taglia per quell'abito ed è disponibile in questo momento. Posso aggiungere il codice LINEN10 per il 10% di sconto e la spedizione è gratuita sopra i 75$, soglia che il tuo carrello supera già. Vuoi che lo applichi? Ecco il tuo carrello: store.example/cart/abc123

Maria: Fatto, ho appena ordinato. Grazie!

Agente: Fantastico! Il tuo ordine è confermato. Buon divertimento con l'abito! 🎉

L'agente poi etichetta la chat come recovered e prosegue.

Niente piano Enterprise? Usa un nodo AI Agent in Wali Flows

Il Wali MCP è una funzionalità di livello Enterprise. Se sei su un piano inferiore, puoi ottenere lo stesso risultato dentro i Wali Flows integrati o tramite n8n con un nodo AI Agent che chiama gli stessi strumenti WhatsApp. Il flow gestisce il trigger e la pianificazione; il nodo AI Agent gestisce la personalizzazione e la logica di risposta. È lo stesso schema invia-e-conversa, solo orchestrato dai Flows invece che da un client MCP autonomo.

Compliance e costi

Le regole non cambiano perché alla guida c'è un'AI:

• Per avviare una conversazione al di fuori della finestra di 24 ore ti serve un template Marketing pre-approvato e un opt-in valido.
• Entro 24 ore dall'ultimo messaggio del cliente puoi inviare messaggi in formato libero.
• Viola questa regola e ottieni l'errore 131047, perché l'MCP non ha modo di aggirare le regole di Meta.
• Rispetta sempre uno STOP in testo libero ed etichetta il contatto come disiscritto.

Sul fronte dei costi, ogni messaggio guidato dall'AI comporta una chiamata all'LLM, quindi un approccio ibrido è la mossa intelligente. Lascia che l'agente gestisca i carrelli ad alto valore e le risposte dal vivo, dove personalizzazione e gestione delle obiezioni si ripagano da sole. Usa un semplice template per la coda lunga dei carrelli di basso valore. Vedi i prezzi WABA per il lato messaggistica e le campagne per gli invii massivi di template.

Domande frequenti

Il Wali MCP rileva i carrelli abbandonati?

No. L'MCP è il livello di azione WhatsApp: invia, legge e risponde. Il rilevamento avviene dal lato del negozio (l'evento checkout di Shopify o un plugin di WooCommerce) e un runtime attiva l'agente.

Shopify Storefront o Admin MCP per i checkout abbandonati?

Admin. Lo Storefront MCP è rivolto al cliente e non espone i checkout abbandonati. Usa l'MCP Shopify Admin con la query GraphQL abandonedCheckouts.

Mi serve comunque un template Marketing?

Sì. Al di fuori della finestra di 24 ore, il primo messaggio deve essere un template Marketing pre-approvato con opt-in. L'agente personalizza entro queste regole senza sostituirle.

Quanto costa farlo funzionare?

Due livelli: i costi di messaggistica WhatsApp da parte di Meta, più una chiamata all'LLM per ogni messaggio guidato dall'AI. Un approccio ibrido tiene a bada i costi, perché riserva l'AI ai carrelli ad alto valore e alle risposte e lascia la coda lunga ai template.

Funziona su un piano non Enterprise?

L'MCP in sé è di livello Enterprise. Sui piani inferiori, usa un nodo AI Agent in Wali Flows (o n8n) per eseguire lo stesso ciclo invia-e-conversa con gli strumenti integrati.

Risorse

• Wali Flows per l'automazione integrata e i nodi AI Agent
• Prezzi WABA con i costi di messaggistica WhatsApp
• Campagne per gli invii massivi di template
• Shopify Admin API con la query GraphQL abandonedCheckouts
• Documentazione per sviluppatori WooCommerce su REST e MCP
• Panoramica dei template WhatsApp e regole di opt-in

Cosa fare dopo

Collega i dati del tuo negozio a un agente AI e lascia che invii e concluda su WhatsApp. Inizia con Wali.