Server MCP per gestire le chat di WhatsApp Business Platform da assistenti IA come Meta Muse e Claude
Resta nell’assistente IA che usi già. Collegalo a TimelinesAI per leggere le tue chat di WhatsApp Business Platform, rispondere ai clienti, inviare modelli approvati e assegnare ed etichettare le chat per il tuo team.
Il server MCP di TimelinesAI funziona con qualsiasi assistente IA che supporta server MCP remoti con accesso OAuth. Non c’è software da installare, nessun server da gestire e nessuna password da condividere. L’assistente può fare solo ciò che il tuo ruolo in TimelinesAI consente.
Cosa può fare il connettore
- Leggere chat, cronologia dei messaggi e stato dei messaggi su tutti i tuoi numeri WhatsApp Business Platform
- Rispondere con testo libero finché la finestra di 24 ore del cliente è aperta
- Inviare modelli approvati da Meta e avviare nuove chat con un modello
- Assegnare e rimuovere l’assegnazione, aprire e chiudere chat, e aggiungere o rimuovere etichette
- Reagire ai messaggi e vedere i membri del tuo team e i tuoi modelli
Cosa ti serve
- Un account TimelinesAI. I nuovi account iniziano con una prova gratuita di 10 giorni, senza carta di credito.
- Almeno un numero WhatsApp Business Platform (Cloud API) collegato al tuo workspace. Scopri di più su WhatsApp Business API in TimelinesAI.
- Almeno un modello approvato, se vuoi che l’assistente avvii nuove chat o scriva ai clienti fuori dalla finestra di 24 ore.
Come configurarlo
Passo 1: Aggiungi il connettore.
Nel tuo assistente IA, aggiungi un nuovo connettore (o un server MCP personalizzato) e incolla
https://mcp.services.timelines.ai/mcp/waba.Passo 2: Accedi con TimelinesAI.
L’assistente apre la pagina di accesso di TimelinesAI. Accedi o crea un account.
Passo 3: Approva l’accesso.
Controlla i permessi nella pagina “Authorize timelines-mcp?” e fai clic su Authorize.
Passo 4: Fai la tua prima domanda.
Prova con “Elenca i miei numeri WhatsApp Business” o “Mostra le chat in attesa di risposta”.
Dettagli di connessione
| Impostazione | Valore |
|---|---|
| URL del server MCP | https://mcp.services.timelines.ai/mcp/waba |
| Trasporto | Streamable HTTP |
| Accesso | OAuth 2.1 con PKCE (S256) e registrazione dinamica dei client |
| Server di autorizzazione | https://mcp.services.timelines.ai |
| Scope | openidchats:readchats:writemessages:readmessages:writelabels:readlabels:writeaccounts:readworkspace:readtemplates:read |
Strumenti (18)
Gli strumenti di lettura si limitano a consultare i dati. Gli strumenti di scrittura modificano una chat in TimelinesAI. Gli strumenti di scrittura sensibile inviano qualcosa che il cliente vede, e Meta addebita l’invio dei modelli.
| Strumento | Cosa fa | Accesso |
|---|---|---|
waba_accounts | Elenca i numeri WhatsApp Business Platform da cui puoi inviare | Lettura |
waba_list_chats | Elenca le chat che puoi vedere, con filtri (per esempio, per numero di telefono) | Lettura |
waba_chat_details | Mostra una chat: se la finestra di 24 ore è aperta, l’assegnatario, le etichette e il numero di invio | Lettura |
waba_chat_history | Mostra i messaggi di una chat, dal più recente | Lettura |
waba_message_details | Mostra un messaggio, incluso il motivo se non è andato a buon fine | Lettura |
waba_templates | Elenca i modelli di messaggio che puoi usare | Lettura |
waba_template_details | Mostra un modello: contenuto, variabili, stato e i numeri da cui può essere inviato | Lettura |
workspace_team | Elenca i membri del team, così una chat può essere assegnata a uno di loro | Lettura |
waba_chat_open | Riapre una chat chiusa | Scrittura |
waba_chat_close | Chiude una chat | Scrittura |
waba_chat_assign | Assegna una chat a un membro del team | Scrittura |
waba_chat_unassign | Rimuove l’assegnatario da una chat | Scrittura |
waba_chat_set_label | Aggiunge un’etichetta a una chat | Scrittura |
waba_chat_remove_label | Rimuove un’etichetta da una chat | Scrittura |
waba_chat_send_message | Invia una risposta di testo libero in una chat esistente, solo finché la finestra di 24 ore è aperta | Scrittura sensibile |
waba_chat_send_template | Invia un modello approvato in una chat esistente | Scrittura sensibileMeta addebita i modelli |
waba_start_chat | Avvia una nuova chat con un numero di telefono usando un modello approvato | Scrittura sensibileMeta addebita i modelli |
waba_message_react | Aggiunge o rimuove una reazione emoji su un messaggio | Scrittura sensibileIl cliente lo vede |
Ogni strumento è contrassegnato come di sola lettura o come uno che apporta modifiche, così gli assistenti IA possono chiederti conferma prima di una scrittura.
Cosa può vedere l’assistente
L’assistente agisce come l’utente TimelinesAI che ha effettuato l’accesso, con i permessi di quell’utente. Non vede mai più di quanto quell’utente può vedere in TimelinesAI.
- Proprietari e amministratori vedono tutti i numeri WhatsApp Business Platform del workspace e tutte le loro chat.
- Supervisori di team e membri del team vedono i numeri il cui team è il loro, e le chat di quei numeri.
- Agenti vedono i numeri assegnati a loro, e le chat di quei numeri.
- Collaboratori vedono solo le chat assegnate a loro. Possono rispondere lì, ma non possono avviare nuove chat.
- Chat assegnate: chiunque sia assegnato a una singola chat può vederla e rispondere. Questo non dà accesso al resto di quel numero.
Regole dei messaggi
- Dentro la finestra di 24 ore (il cliente ha scritto nelle ultime 24 ore), l’assistente può inviare risposte di testo libero.
- Fuori dalla finestra, o per una nuova chat, si possono inviare solo modelli approvati da Meta. Un modello non riapre la finestra per il testo libero.
- I modelli con intestazione multimediale (immagine, video o documento) non possono ancora essere inviati tramite il connettore. Usa modelli con variabili di testo.
- Consegna: un invio riuscito significa che Meta ha accettato il messaggio. La consegna può comunque fallire in seguito, e l’assistente può verificarne il motivo.
Prezzi
L’uso del connettore è incluso in ogni piano TimelinesAI senza costi aggiuntivi. Meta addebita i messaggi modello alle sue tariffe standard di WhatsApp Business Platform, e l’assistente ti avvisa prima di inviarne uno.
Privacy e sicurezza
- L’accesso usa OAuth, quindi il tuo assistente IA non vede mai la tua password di TimelinesAI.
- L’assistente può usare solo i dati a cui ha accesso l’utente collegato, entro gli scope indicati sopra.
- Per scollegarlo, rimuovi il connettore nel tuo assistente IA.
- Consulta la nostra Informativa sulla privacy e i Termini. Assistenza: help.timelines.ai.
Domande frequenti sul server MCP per WhatsApp Business Platform
Ultimo aggiornamento: