LetsBot Menu
Inizia ora Italiano Lingua

Meta Business Partner Società registrata nel Regno Unito

Lingua

Incluso nel componente aggiuntivo API + MCP

MCP · Streamable HTTP

Collega la WhatsApp Business API a qualsiasi strumento di IA
con LetsBot MCP

Un server MCP ufficiale che permette a ChatGPT, Claude, Cursor e Gemini di leggere le tue conversazioni WhatsApp, creare report giornalieri, individuare i clienti insoddisfatti e monitorare le conversazioni in sospeso. Fa parte del componente aggiuntivo API + MCP ($69.99/mese, IVA inclusa) disponibile su qualsiasi piano, e funziona anche durante la prova gratuita.

Meta Business Partner

  • ∞ Chiamate MCP per piano API
  • 5+ Client di IA compatibili
  • < 90s configurazione completa
  • OAuth 2.1 pienamente conforme agli RFC
Assistente IA letsbot · https://letsbot.net/mcp

Strumenti MCP di LetsBot 93

  • send_text_message
  • get_messages
  • get_contacts
  • get_conversations_awaiting_reply
  • ai_summarize_conversation
  • ai_sentiment_analysis
  • create_campaign
  • toggle_bot
  • + 85

Quante conversazioni attendono la mia risposta in questo momento e quanti messaggi sono arrivati oggi rispetto al totale dei miei contatti?

Chiamata allo strumento get_conversations_awaiting_reply({"page": 1}) fatto

{
  "metric": "conversations_awaiting_reply",
  "metric_definition": "The customer sent the most recent message…",
  "conversations": [
    {
      "id": 4821,
      "name": "Sara M",
      "phone": "966501234567",
      "last_message_date": "2026-09-29 10:24:00",
      "messages_not_opened_in_inbox": 2
    },
    …
  ],
  "pagination": { "current_page": 1, "last_page": 10, "total": 190 }
}

190 conversazioni attendono la tua risposta: in ognuna l’ultimo messaggio è del cliente. La più recente è di Sara M.

Esempio illustrativo con dati di prova: la struttura del risultato corrisponde a quella restituita da get_conversations_awaiting_reply.

Le basi

Che cos’è il Model Context Protocol?

MCP è un protocollo aperto di Anthropic che permette a qualsiasi client di IA (ChatGPT, Claude, Cursor, Gemini o qualsiasi IDE con IA) di dialogare con un server esterno e richiamare strumenti reali invece di inventare risposte.

Il server MCP di LetsBot mette a disposizione strumenti per leggere le conversazioni, inviare messaggi, creare report, gestire il bot e amministrare i contatti, tutto protetto da permessi rigorosi per ogni chiave API.

Autenticazione per singola chiave

Ogni chiamata MCP verifica un token Bearer (lb_api_key). I permessi viaggiano con la chiave, così un utente di ChatGPT vede solo i propri dati.

Streamable HTTP nativo

POST per i messaggi, GET per lo streaming SSE, DELETE per chiudere la sessione: pienamente allineato alla specifica ufficiale MCP, così qualsiasi client compatibile si collega senza adattatori.

Prezzo chiaro: un solo componente aggiuntivo

Il server MCP fa parte del componente aggiuntivo API + MCP: $69.99/mese, IVA inclusa, da aggiungere a qualsiasi piano base (con il piano Starter da $6.35 il totale è $76.34/mese). Non è incluso di default nei piani e funziona anche durante la prova gratuita.

Compatibilità

Collegalo a qualsiasi strumento di IA che già usi

Un unico URL MCP funziona con tutti i client qui sotto. Incolla lo snippet JSON per lo strumento che preferisci, inserisci la tua chiave, salva e inizia a parlare con il tuo bot direttamente da quello strumento.

Claude (Custom Connector)

Anthropic: connettore MCP remoto nativo tramite OAuth (funziona su Claude.ai e nell’app desktop)

// Claude → Settings → Connectors → Add custom connector
URL: https://letsbot.net/mcp
Auth: OAuth 2.1 + PKCE (sign in with your LetsBot account)

ChatGPT (OpenAI Apps)

OpenAI Apps: MCP tramite flusso OAuth

// In ChatGPT Apps → Add a server
URL: https://letsbot.net/mcp
Auth: OAuth 2.1 (PKCE auto-detected)
Bearer scope: workspace_read, conv_read, msg_send

Cursor

Cursor IDE: Impostazioni → MCP (HTTP nativo)

{
  "mcpServers": {
    "letsbot": {
      "url": "https://letsbot.net/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_LB_API_KEY"
      }
    }
  }
}

Continue.dev

Estensione Continue per VS Code / JetBrains

experimental:
  modelContextProtocolServers:
    - name: letsbot
      transport:
        type: http
        url: https://letsbot.net/mcp
        headers:
          Authorization: Bearer YOUR_LB_API_KEY

Gemini CLI / Code

Google Gemini: tramite l’adattatore MCP-Gateway

gemini mcp add letsbot \
  --url https://letsbot.net/mcp \
  --auth-header "Authorization: Bearer YOUR_LB_API_KEY"

VS Code Copilot Chat

GitHub Copilot Chat (Insider): MCP dalla versione 1.95

// .vscode/mcp.json
{
  "servers": {
    "letsbot": {
      "type": "http",
      "url": "https://letsbot.net/mcp",
      "headers": { "Authorization": "Bearer YOUR_LB_API_KEY" }
    }
  }
}

Prompt reali

Chiedi in linguaggio naturale, ottieni il risultato

Sei scenari reali che si ripetono ogni giorno nei team di assistenza e vendita. Ognuno abbina il prompt che scriveresti in ChatGPT o Claude alla risposta attesa dall’IA dopo aver richiamato l’MCP di LetsBot e recuperato i dati reali.

Report giornaliero delle conversazioni

Creami un report di tutte le conversazioni WhatsApp di ieri: nuove conversazioni, risposte del bot, passaggi a un operatore e quante sono ancora aperte.

ai_dashboard_summary

Fatto. Ho richiamato ai_dashboard_summary. 142 nuove conversazioni, 1.287 risposte del bot (tempo medio di risposta 4s), 38 passaggi a un operatore (27%) e 12 ancora aperte dopo 24h.

Individua i clienti insoddisfatti

Ci sono clienti insoddisfatti o arrabbiati per le nostre risposte di oggi? Mandami i primi 5 con il contesto della conversazione.

ai_sentiment_analysis

Ho trovato 7 conversazioni con sentiment negativo. I primi 5 in classifica: 1) Ahmad A — ordine in ritardo da oltre 48h; 2) Sara M — ha ripetuto "nessuna risposta" 3 volte; 3) Mohamed K — ha rifiutato la risposta del bot; 4) Fatima — reclamo per un rimborso; 5) Layla A — ha chiesto più volte un operatore.

Monitoraggio dei carrelli abbandonati

Quanti carrelli del negozio Salla sono stati abbandonati negli ultimi 7 giorni e quanti sono stati recuperati con i messaggi WhatsApp?

get_abandoned_carts

Ho richiamato get_abandoned_carts per il negozio Salla, ultimi 7 giorni. 247 carrelli abbandonati: 186 ancora aperti e 61 recuperati (tasso di recupero del 24,7%) per un valore di SAR 27.400; 49 di questi clienti hanno acquistato dopo un promemoria WhatsApp. Ogni carrello aperto include nome del cliente, telefono, articoli e link al checkout. Lo stesso strumento copre Zid, Shopify e Magento.

Monitora le conversazioni in sospeso

Quante conversazioni attendono la mia risposta in questo momento e quanti messaggi sono arrivati oggi rispetto al totale dei miei contatti?

get_conversations_awaiting_reply

Ho richiamato get_conversations_awaiting_reply. 190 conversazioni in cui l’ultimo messaggio è del cliente e non è ancora partita nessuna risposta, su 974 contatti attivi. Oggi: 63 messaggi in arrivo e 11 nuovi contatti. Una conversazione esce da questo elenco non appena viene inviata una risposta da qualsiasi dispositivo.

Invia una campagna massiva

Invia "Sconto del 20% per Eid" a tutti i clienti che hanno acquistato negli ultimi 3 mesi, personalizzato con il loro nome.

create_campaign

Ho filtrato 2.418 clienti che hanno acquistato dal 2026-02-07. Ho richiamato create_campaign() con il modello approvato da Meta "Sconto Eid". La campagna parte tramite il modello approvato con una breve pausa tra un destinatario e l’altro (Meta consente fino a 80 messaggi al secondo per numero); completata al 12%, avanzamento completo nella dashboard.

I prodotti più richiesti

Quali sono i 5 prodotti su cui i clienti hanno fatto più domande su WhatsApp questo mese? E quante richieste si sono trasformate in ordini veri e propri?

1) Profumo Marca X — 412 domande, 87 ordini (21%); 2) Orologio Y — 298 domande, 41 ordini (14%); 3) Giacca Z — 254 domande, 38 ordini; 4) Borsa W — 207 domande, 23 ordini; 5) Sneaker V — 185 domande, 19 ordini.

Riferimento

93 strumenti che l’IA rileva in automatico

Il catalogo completo di tutti gli strumenti esposti dal server MCP di LetsBot, raggruppati in 16 categorie. Sono esattamente i nomi che l’IA vede quando interroga il server, quindi ogni esempio qui sopra corrisponde direttamente a uno di questi strumenti. Quasi tutti sono strumenti per WhatsApp; alcuni (come send_carousel) sono invece pensati per i canali Messenger e Instagram e richiedono un PSID/IGSID del destinatario anziché un numero di telefono. Altri tre strumenti di pubblicazione sui social compaiono solo nei workspace in cui questa funzione è attiva.

Messaggi e invii

19 strumenti
  • send_text_message Invia un messaggio WhatsApp di solo testo
  • send_image Invia un’immagine con didascalia facoltativa
  • send_video Invia un video con didascalia facoltativa
  • send_audio Invia un file audio o un messaggio vocale
  • send_file Invia un documento o un PDF
  • send_location Invia una posizione geografica
  • send_contact_card Invia una scheda contatto vCard
  • send_template Invia un modello approvato da Meta (fuori dalla finestra di 24 ore)
  • send_buttons Messaggio interattivo con un massimo di 3 pulsanti
  • send_list Messaggio interattivo con elenco / menu
  • reply_to_message Rispondi a un messaggio specifico
  • send_reaction Aggiungi una reazione emoji a un messaggio
  • forward_message Inoltra un messaggio a un’altra chat
  • get_messages Leggi i messaggi di una conversazione
  • search_messages Cerca in tutte le chat o in una sola
  • mark_as_read Segna come letti tutti i messaggi di una chat
  • send_carousel Invia un carosello: solo canali Messenger/Instagram (PSID/IGSID)
  • get_message_status Controlla i messaggi inviati: consegnati, letti, in attesa o non riusciti con il motivo indicato da Meta
  • upload_file Carica un file (PDF, immagine, documento) nello spazio di archiviazione di LetsBot e ottieni un URL diretto da inviare

Contatti

11 strumenti
  • get_contacts Contatti paginati con ricerca + filtri
  • get_contact Dettagli completi del contatto + etichette + ultimo messaggio
  • create_contact Crea un nuovo contatto
  • update_contact Aggiorna i dati del contatto (nome, email, ecc.)
  • get_my_chats Conversazioni assegnate all’operatore attuale
  • get_conversations_awaiting_reply Conversazioni in attesa della tua risposta
  • pin_contact Fissa / sblocca una conversazione in alto
  • archive_contact Archivia / ripristina una conversazione
  • block_contact Blocca / sblocca un contatto
  • assign_label Attiva o disattiva un’etichetta su un contatto
  • assign_moderator Assegna o rimuovi un operatore su un contatto

Etichette e team

7 strumenti
  • get_labels Elenca tutte le etichette / tag dell’account
  • create_label Crea una nuova etichetta
  • get_label_contacts Contatti con un’etichetta specifica
  • get_moderators Operatori disponibili
  • get_quick_replies Risposte predefinite pronte all’uso
  • create_quick_reply Crea un nuovo modello di risposta rapida
  • update_quick_reply Aggiorna una risposta rapida esistente

Analisi con IA

7 strumenti
  • ai_suggest_reply Suggerisci una risposta per la conversazione attuale
  • ai_summarize_conversation Riassumi l’intero storico di una conversazione
  • ai_analyze_contact Analizza un contatto + i modelli di conversazione
  • ai_improve_message Perfeziona un messaggio prima di inviarlo
  • ai_translate_message Traduci un messaggio in qualsiasi lingua
  • ai_sentiment_analysis Valuta il sentiment del cliente (positivo/negativo/neutro)
  • ai_dashboard_summary Riepilogo della dashboard in un colpo solo

E-commerce

3 strumenti
  • get_order_status Stato + dettagli dell’ordine su Salla o Zid
  • search_products Cerca nel catalogo prodotti di Salla / Zid
  • get_abandoned_carts Carrelli abbandonati da Salla, Zid, Shopify e Magento con riepilogo del recupero: aperti vs recuperati, valore, tasso di recupero e recuperati dopo un promemoria WhatsApp

Campagne massive

3 strumenti
  • create_campaign Crea una campagna di invio massivo mirata per etichetta
  • get_campaigns Elenca le campagne + statistiche di consegna
  • get_campaign_status Dettaglio delle consegne per contatto di una campagna

Bot e automazione

8 strumenti
  • get_bot_status Stato del bot + modalità IA + impostazioni di corrispondenza
  • toggle_bot Attiva o disattiva il bot per singolo contatto
  • get_bot_conversations Tutte le conversazioni di risposta automatica configurate
  • create_simple_conversation Regola semplice di risposta automatica (trigger → testo)
  • create_interactive_conversation Albero di conversazione interattivo basato su pulsanti
  • update_bot_conversation Aggiorna una conversazione di risposta automatica esistente
  • get_bot_settings Leggi tutte le impostazioni del bot + IA
  • update_bot_settings Aggiorna le impostazioni del bot / IA (parziale)

Lead dagli annunci

2 strumenti
  • get_ad_lead_settings Leggi le impostazioni di acquisizione dei lead dagli annunci
  • update_ad_lead_settings Aggiorna le impostazioni di acquisizione dei lead dagli annunci

Gruppi WhatsApp (numeri collegati tramite QR)

3 strumenti
  • get_groups Elenca le chat di gruppo WhatsApp con ricerca + filtri (sola lettura)
  • get_group_messages Leggi i messaggi di un gruppo con il mittente di ciascuno, senza segnarli come letti
  • send_group_message Pubblica un messaggio di testo in un gruppo dopo la tua conferma: non è uno strumento di invio massivo

Trattative e pipeline

7 strumenti
  • list_deals Elenca le trattative filtrate per fase o responsabile
  • get_deal Una trattativa con lo storico delle attività
  • create_deal Crea una trattativa con un importo per un contatto
  • update_deal Sposta una trattativa tra le fasi o modificane l’importo
  • win_deal Segna una trattativa come vinta
  • lose_deal Segna una trattativa come persa indicando il motivo
  • get_pipeline_summary Totali per fase e previsione ponderata

Attività

4 strumenti
  • list_tasks Elenca le attività scadute o di oggi
  • create_task Crea un’attività con scadenza e promemoria
  • update_task Modifica o riassegna un’attività
  • complete_task Segna un’attività come completata

Ticket

6 strumenti
  • list_tickets Elenca i ticket per stato, priorità o violazione dello SLA
  • get_ticket Un ticket con le sue note
  • create_ticket Apri un ticket per un cliente dopo la tua conferma
  • update_ticket_status Modifica lo stato di un ticket dopo la tua conferma
  • assign_ticket Assegna un ticket a un operatore o a un team
  • add_ticket_note Aggiungi una nota interna che il cliente non vede mai

Soddisfazione dei clienti

2 strumenti
  • get_csat_summary Riepilogo CSAT e NPS per un periodo
  • list_low_scores Punteggi bassi con i relativi commenti

Appuntamenti

6 strumenti
  • list_services Elenca i servizi prenotabili
  • get_available_slots Orari liberi per un servizio o un membro dello staff
  • book_appointment Prenota un appuntamento dopo la tua conferma
  • reschedule_appointment Sposta un appuntamento dopo la tua conferma
  • cancel_appointment Annulla un appuntamento
  • list_appointments Appuntamenti di oggi o di questa settimana

Reparti e carico di lavoro

3 strumenti
  • get_workload Carico di lavoro in tempo reale per operatore e reparto
  • list_departments Elenca i reparti e i loro orari
  • transfer_to_department Trasferisci una conversazione a un reparto

Libreria multimediale

2 strumenti
  • search_media Cerca nella libreria multimediale
  • get_media_item Un file e dove viene utilizzato

Totale strumenti: 93, e il catalogo cresce ogni settimana. Riferimento completo nella documentazione per sviluppatori.

Configurazione

Attiva MCP in 3 passaggi

Qualsiasi cliente con un piano WhatsApp Business API attivo su LetsBot può completare la configurazione in meno di 90 secondi. Nessuna libreria da installare, nessun file da configurare al di fuori del tuo client di IA.

Attiva un piano API
  1. Genera una chiave API

    Nella dashboard di LetsBot: Impostazioni → Chiavi API → Nuova chiave. Scegli l’ambito di lettura/scrittura che ti serve e conserva la chiave in un luogo sicuro.

  2. Aggiungi MCP al tuo client di IA

    Copia lo snippet per il tuo client dalla sezione compatibilità e sostituisci YOUR_LB_API_KEY con la tua chiave. L’URL MCP è lo stesso ovunque: https://letsbot.net/mcp.

  3. Chiedi in qualsiasi lingua

    Apri ChatGPT o Claude e prova con "Creami un report delle conversazioni di oggi": il client rileva gli strumenti in automatico, li richiama e risponde con i tuoi dati reali. Nessun prompt di supporto aggiuntivo.

Domande frequenti

Cosa chiedono i clienti su MCP

Che cos'è esattamente MCP?
Model Context Protocol: uno standard aperto di Anthropic che consente a client IA come ChatGPT o Claude di richiamare strumenti reali su un server esterno. LetsBot mette a disposizione 93 strumenti per leggere e inviare messaggi WhatsApp, creare report, analisi, gestire i contatti, oltre a trattative, attività, ticket e appuntamenti.
Quanto costa MCP?
Il server MCP fa parte del componente aggiuntivo a pagamento "API + MCP": $69.99 al mese, IVA inclusa, da aggiungere a qualsiasi piano base. Con il piano più economico, Starter ($6.35), il totale è di $76.34 al mese. Il componente aggiuntivo non è incluso nei piani per impostazione predefinita, ma MCP funziona durante la prova gratuita di 14 giorni.
Quali sono gli URL ufficiali di MCP?
L'URL canonico è https://letsbot.net/mcp. Per retrocompatibilità è attivo anche un URL legacy: https://letsbot.net/gpt-mcp. Entrambi eseguono lo stesso codice con la stessa autenticazione tramite Bearer token (lb_api_key).
Devo essere uno sviluppatore per usare MCP?
No. Basta copiare lo snippet del client (Claude/ChatGPT/Cursor/Gemini) dalla sezione sulla compatibilità e sostituire YOUR_LB_API_KEY con la tua chiave: il tuo strumento di IA potrà dialogare con LetsBot in linguaggio naturale, senza scrivere codice.
I miei dati WhatsApp sono al sicuro quando li collego a ChatGPT?
Sì. Ogni chiamata MCP convalida il tuo Bearer token legato all'account, i permessi sono associati alla chiave e i dati delle conversazioni transitano tramite OAuth 2.1 + HTTPS tra il client IA e LetsBot. Non condividiamo mai i tuoi dati con OpenAI, Anthropic o altre terze parti.
In che cosa MCP si differenzia dalla WhatsApp Business API?
La WhatsApp Business API è il canale ufficiale di Meta per inviare e ricevere messaggi. MCP è un livello superiore che permette a un client IA di dialogare con quella API in linguaggio naturale, invece di scrivere manualmente richieste curl. I due strumenti si completano a vicenda.
MCP funziona con Claude Desktop?
Sì: Claude Desktop offre un supporto MCP nativo ed è il modo più semplice per iniziare. Nella sezione sulla compatibilità qui sopra trovi uno snippet pronto da incollare.
Funziona con Cursor IDE?
Sì. Cursor ha una configurazione MCP integrata in Settings → MCP. Copia il JSON dalla scheda Cursor qui sopra e inserisci la tua chiave.
Quali strumenti mette a disposizione il vostro server MCP?
93 strumenti che coprono: lettura delle conversazioni, invio di messaggi singoli, campagne massive, contatti ed etichette, risposte rapide, ordini e ricerca prodotti (Salla e Zid), carrelli abbandonati e relativo tasso di recupero, analisi del sentiment, controllo del bot e delle risposte automatiche, modelli Meta, impostazioni dei lead dalle inserzioni, trattative e pipeline di vendita, attività, ticket, soddisfazione dei clienti, prenotazione di appuntamenti, reparti e carico di lavoro, e libreria multimediale. L'elenco completo è nella sezione "Strumenti disponibili".
Posso limitare un client IA alla sola lettura e impedirgli di inviare messaggi?
Sì. Quando generi una chiave API nella dashboard scegli l'ambito: sola lettura o accesso completo. Usa la sola lettura con ChatGPT per i flussi di reportistica e l'accesso completo solo quando intendi inviare campagne.
C'è un limite giornaliero alle chiamate MCP?
Non esiste un limite MCP separato. Tutto ciò che l'IA richiama viene conteggiato nell'utilizzo del tuo piano attuale. Se il tuo piano include 75.000 messaggi al mese, MCP attinge alla stessa quota mensile insieme al resto della piattaforma.
Come inizio oggi stesso?
Registrati a un piano API tramite "Inizia la prova gratuita" in alto, genera una chiave API nelle Impostazioni e incolla lo snippet per il tuo client. La configurazione completa richiede meno di 90 secondi e la prova gratuita non richiede la carta di credito.

MCP è incluso nel componente aggiuntivo API + MCP

Pronto a collegare WhatsApp all’IA?

Prova MCP gratis durante la prova di 14 giorni, senza carta di credito, poi aggiungi al tuo piano il componente aggiuntivo API + MCP ($69.99/mese). Meta Business Partner ufficiale, assistenza in arabo 24/7.