Riferimento agli strumenti MCP
Il connettore espone più di 30 strumenti su ogni connessione dell'account. list_numbers viene prima per WhatsApp, i cui strumenti richiedono il suo connection_id, e list_social_accounts per gli altri canali, i cui strumenti richiedono un account_id. Sei vengono bloccati quando la fatturazione scade: i quattro strumenti WhatsApp che agiscono sul mondo esterno, get_api_credentials, che restituisce il token di accesso, e create_connect_link. Gli altri restano disponibili.
Strumenti esposti dal connettore.
Strumenti bloccati quando la fatturazione scade, incluso get_api_credentials, che restituisce il token di accesso.
Accesso OAuth per tutti i numeri dell'account.
Cosa fa ogni strumento?
Lettura: list_numbers restituisce i numeri connessi con stato, valutazione della qualità e livello di messaggistica, ed è il punto di partenza per ogni altra chiamata. get_number_health restituisce insieme un'istantanea aggiornata di Meta, la cronologia recente del monitoraggio, gli eventi webhook e i controlli del poller. get_api_credentials restituisce l'URL di base della Graph API, l'ID WABA, l'ID del numero di telefono e, quando disponibile, il token di accesso dell'account.
Invio: send_message invia testo libero nella finestra di 24 ore, durante la quale le risposte sono gratuite. send_template invia un template approvato ed è il modo per iniziare una conversazione con chi non ha ancora scritto. list_templates, create_template e get_template_status coprono l'intero ciclo di vita del template.
Collegamento: set_webhook_destination indirizza i messaggi in entrata e i riscontri dell'app al tuo sistema; passare null lo reimposta. get_connect_link restituisce il link alla dashboard e i passaggi per collegare un nuovo numero. get_docs restituisce la documentazione del prodotto in formato markdown.
Partner API, per software o agenzie i cui clienti collegano i propri numeri: get_partner_setup mostra lo stato della fatturazione, la chiave API, l'URL degli eventi e il passo successivo. create_api_key emette la chiave della Partner API e la mostra una sola volta, e non sostituisce una chiave esistente senza conferma esplicita. revoke_api_key la revoca, sempre dopo conferma. set_partner_events_url imposta dove arrivano gli eventi di stato e restituisce una sola volta il segreto di firma. create_connect_link crea un link di collegamento ospitato per un cliente, valido 1 ora, come POST /api/v1/connect-sessions.
Perché connection_id è importante?
Perché collega un'istruzione a un numero specifico e un assistente non può indovinarlo.
Ogni strumento che agisce su un numero richiede un connection_id, e list_numbers è l'unico punto da cui ottenerlo. In pratica, quando gli viene chiesto di inviare un messaggio, l'assistente chiamerà prima list_numbers: per questo la prima richiesta di una sessione è spesso più lenta delle successive.
Questo rende inoltre non ambiguo un account con più numeri. Non esiste un numero predefinito né una selezione implicita, quindi, se un'istruzione non identifica il numero, l'assistente chiede quale sia invece di fare supposizioni.
Cosa succede quando scade la fatturazione?
Vengono bloccati sei strumenti: send_message, send_template, create_template e set_webhook_destination, che agiscono sul mondo esterno; get_api_credentials, perché restituisce il token di accesso dell'account, con cui un account bloccato potrebbe inviare direttamente tramite la Graph API; e create_connect_link, che collega un nuovo numero. Ogni altra lettura resta disponibile, così come la configurazione della Partner API: get_partner_setup, create_api_key, revoke_api_key e set_partner_events_url.
È una scelta deliberata, non una svista. Un account che non può vedere perché è bloccato o verificare se i propri numeri sono operativi non avrebbe altra strada se non aprire una richiesta di assistenza. Le stesse letture servono anche al monitoraggio dello stato di salute, quindi bloccarle disattiverebbe il monitoraggio proprio quando è più necessario.
In pratica, un account con fatturazione scaduta continua a rispondere alle domande sul proprio stato e resta monitorato. Si ferma solo ciò che raggiunge un cliente.
Errori comuni
- Aspettarsi che il connettore riceva messaggi. MCP funziona con richieste e risposte; il traffico in entrata richiede un webhook.
- Impostare connection_id in modo rigido. Proviene da list_numbers e non va annotato come valore fisso.
- Pensare che un account con fatturazione scaduta sia completamente offline. Letture e monitoraggio continuano intenzionalmente, tranne le credenziali, che contengono il token con cui si invia.
Un connettore copre tutti i numeri di un account, autorizzato tramite OAuth senza chiavi da incollare. Da US$ 9 per numero connesso al mese, fino a US$ 0,75 man mano che aggiungi numeri, con i primi 3 giorni gratuiti.
Domande frequenti
Devo scegliere quale strumento chiamare?
No. Fai la richiesta in linguaggio naturale e l'assistente sceglie lo strumento, proprio per questo sono scritte le descrizioni.
Può leggere le mie conversazioni?
No. I messaggi in entrata vengono indirizzati alla destinazione webhook che indichi. Il connettore legge lo stato dell'account e dei numeri.
get_docs è utile?
Più di quanto sembri. Fornisce all'assistente la nostra documentazione in formato markdown, così le risposte sulle regole di Coexistence provengono dai nostri documenti e non dalla memoria.
Un connettore può coprire più clienti?
Sì. Un account può contenere tutti i numeri necessari e list_numbers li restituisce tutti.
Continua a leggere
Pronto per iniziare?
Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.
Inizia la prova gratuitaVerificato il