Riferimento agli strumenti MCP

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.

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?

I quattro strumenti che agiscono sul mondo esterno vengono bloccati: send_message, send_template, create_template e set_webhook_destination. Tutto ciò che legge resta disponibile.

È 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.

Domande frequenti

Continua a leggere