Nota: Non è disponibile alcuna documentazione legacy per questo elemento, pertanto viene visualizzata la documentazione corrente.
PushEngage registers a set of WordPress Abilities so AI assistants and MCP clients can operate your push notifications directly from your WordPress site. Each ability is a single, well-described action, such as sending a notification, listing segments, or pulling an analytics report, that an assistant can discover and call with your permission. This guide explains what the abilities are, what is required to use them, and everything an agent can do.
Prima di iniziare
- You need the PushEngage plugin version 4.2.3 or later. This release registers PushEngage’s abilities against the WordPress Abilities API.
- Your site needs WordPress 7.0 or later. The Abilities API is part of WordPress core starting in 7.0.
- You must be an administrator. Every PushEngage ability requires the
manage_optionscapability, and the assistant authenticates as a WordPress user through an application password. - To expose the abilities to an external AI client over MCP, add the free WP MCP Adapter plugin. You can see its status and the rest of your AI toolkit on the PushEngage Tools page at PushEngage » Tools.
- Some abilities are only available when WooCommerce is active.
How PushEngage Abilities Work
When your site loads, the PushEngage plugin registers a pushengage ability category and its abilities through the WordPress Abilities API. Each ability declares a single capability that an AI assistant can discover and call, in a machine-readable, MCP-compatible format.
Access is inherited from WordPress, not a separate system PushEngage built:
- Permission. Every ability requires the
manage_optionscapability, declared through the Abilities APIpermission_callback. The assistant is authenticated against a WordPress user with an application password, the standard WordPress mechanism since 5.6. An assistant connected as an administrator can run the abilities. One connected as a contributor cannot. - Confirmation. Only one ability is marked destructive, Send Notification, so an MCP-aware assistant confirms with you before firing a send. Settings updates and segment creation are non-destructive.
- Least privilege. Get Debug Log returns admin-grade content such as URLs and request payloads, and is gated to the same administrator permission as everything else. The assistant has the same access as the human admin running it, and no more.
Per raggiungere le funzionalità da un assistente esterno, installa il WP MCP Adapter gratuito, che collega le funzionalità registrate al protocollo MCP parlato dal tuo assistente. Finché non viene collegato un adattatore o un client MCP, le funzionalità sono registrate ma nessun agente può ancora raggiungerle.
Cosa può fare un agente
PushEngage registra 22 funzionalità, raggruppate di seguito in base al lavoro che svolgono. Il numero esatto mostrato nella pagina Strumenti può variare in base a ciò che è attivo sul tuo sito, poiché alcune funzionalità si registrano solo quando WooCommerce è presente. "Tipo" indica se una funzionalità legge solo i dati o apporta anche modifiche.
Invia notifiche push
| Funzionalità | Cosa fa | Tipo |
|---|---|---|
| Invia notifica | Invia una notifica push agli iscritti. | Scrivi |
| Ottieni notifica | Restituisce i dettagli di una singola notifica. | Sola lettura |
| Elenca notifiche | Elenca le notifiche, con filtro di stato opzionale e paginazione. | Sola lettura |
| Ottieni stato connessione | Restituisce se il sito è connesso a un account PushEngage. | Sola lettura |
Crea e targettizza segmenti
| Funzionalità | Cosa fa | Tipo |
|---|---|---|
| Elenca segmenti | Elenca i segmenti di iscritti. | Sola lettura |
| Elenca gruppi di pubblico | Elenca i gruppi di pubblico disponibili per il targeting. | Sola lettura |
| Crea segmento | Crea un nuovo segmento di iscritti. | Scrivi |
| Aggiungi iscritti al segmento | Aggiunge iscritti a un segmento esistente. | Scrivi |
Leggi le tue analisi
| Funzionalità | Cosa fa | Tipo |
|---|---|---|
| Ottieni riepilogo notifiche | Restituisce conteggi aggregati di invii, visualizzazioni e clic su tutte le notifiche. | Sola lettura |
| Ottieni panoramica analisi | Restituisce iscritti, impression e clic in un intervallo di date, raggruppati per giorno, settimana o mese. | Sola lettura |
| Ottieni analisi iscritti | Restituisce gli abbonati attivi settimanali e totali. | Sola lettura |
Configura push automatico
| Funzionalità | Cosa fa | Tipo |
|---|---|---|
| Ottieni impostazioni push automatico | Restituisce la configurazione del push automatico, inclusi i tipi di post abilitati e i flag delle funzionalità. | Sola lettura |
| Aggiorna impostazioni push automatico | Aggiorna il push automatico, inclusi l'interruttore, i tipi di post, l'icona e i flag delle funzionalità. | Scrivi |
| Elenca categorie | Elenca le categorie dei post di WordPress, più le categorie dei prodotti WooCommerce quando WooCommerce è attivo. | Sola lettura |
| Elenca mappature di segmenti di categorie | Elenca la mappatura delle categorie di WordPress ai segmenti PushEngage. | Sola lettura |
| Ottieni mappature attributi | Restituisce la mappatura degli attributi degli abbonati PushEngage alle chiavi meta utente di WordPress. | Sola lettura |
Esegui automazioni WooCommerce e WhatsApp
Queste funzionalità sono disponibili solo quando WooCommerce è attivo. Ottieni stato WhatsApp richiede anche credenziali WhatsApp valide.
| Funzionalità | Cosa fa | Tipo |
|---|---|---|
| Elenca campagne di automazione push | Elenca le campagne di automazione push di WooCommerce con configurazioni admin e cliente. | Sola lettura |
| Aggiorna campagna di automazione push | Abilita, disabilita o configura una campagna di automazione push di WooCommerce. | Scrivi |
| Elenca campagne di automazione WhatsApp | Elenca le campagne di automazione WhatsApp configurate per gli eventi WooCommerce. | Sola lettura |
| Ottieni stato WhatsApp | Restituisce se le credenziali di integrazione WhatsApp sono valide. | Sola lettura |
Diagnostica e verifica
| Funzionalità | Cosa fa | Tipo |
|---|---|---|
| Ottieni informazioni sul plugin | Restituisce la versione del plugin, lo stato della connessione e la configurazione chiave. | Sola lettura |
| Ottieni ambiente sito | Restituisce dettagli su WordPress, PHP e server per la diagnostica. | Sola lettura |
| Ottieni registro di debug | Elenca i file di registro di debug e legge un file specifico quando viene fornito un nome file. Solo amministratore, poiché il contenuto del registro potrebbe includere URL e payload delle richieste. | Sola lettura |
Cosa puoi chiedere al tuo assistente
Una volta che un client MCP è connesso, descrivi il lavoro in linguaggio semplice e l'assistente chiama le giuste funzionalità. Ad esempio:
- “Trova il mio segmento di acquirenti impegnati, quindi invia a tutti al suo interno una notifica push intitolata ‘Saldi lampo finiscono a mezzanotte’ che rimanda alla mia pagina saldi.” L'assistente elenca i segmenti per trovare l'ID, quindi invia la notifica, confermando prima di attivarla.
- “Mostrami un report di analisi settimanale per gli ultimi 30 giorni e quali campagne hanno generato più clic.” L'assistente recupera la panoramica delle analisi e mappa gli invii ai titoli.
- “Disabilita la mia campagna di abbandono del carrello di WooCommerce fino a martedì.” L'assistente elenca le campagne di automazione e aggiorna quella giusta.
- “Crea un segmento chiamato visitatori-pagina-prezzi che catturi chiunque abbia visitato /pricing negli ultimi sette giorni.” L'assistente crea il segmento dalla tua descrizione.
Domande Frequenti
Chi può usare queste funzionalità?
Solo gli amministratori. Ogni funzionalità di PushEngage richiede la capacità manage_options e l'assistente si autentica come utente WordPress tramite una password applicativa. Un assistente connesso come amministratore può eseguire le funzionalità, mentre uno connesso come collaboratore no.
Ho bisogno dell'adattatore MCP?
Ne hai bisogno per raggiungere le funzionalità da un client AI esterno tramite MCP. Le funzionalità si registrano automaticamente con l'API delle funzionalità di WordPress, ma l'adattatore MCP gratuito per WP è ciò che le collega al protocollo MCP con cui parla il tuo assistente. Puoi controllare il suo stato nella pagina Strumenti di PushEngage.
Perché la mia pagina Strumenti mostra un numero diverso di funzionalità?
PushEngage registra 22 funzionalità in totale, ma l'automazione push di WooCommerce e le funzionalità di WhatsApp si registrano solo quando WooCommerce è attivo, quindi il conteggio mostrato sul tuo sito dipende da ciò che è attivo.
Un agente cambierà il mio account senza chiedere?
Le funzionalità di sola lettura restituiscono solo dati. Solo Invia Notifica è contrassegnata come distruttiva, quindi un assistente consapevole di MCP conferma con te prima di attivare un invio. Gli aggiornamenti delle impostazioni e la creazione di segmenti non sono distruttivi e vengono eseguiti senza richiesta.
Quali versioni di plugin e WordPress sono necessarie?
PushEngage 4.2.3 o successivo per le funzionalità e WordPress 7.0 o successivo per l'API delle funzionalità. Si consiglia di mantenere aggiornato il plugin, poiché le versioni successive perfezionano le funzionalità e le loro risposte AI e MCP.
Se riscontri problemi, non esitare a contattarci cliccando qui. Il nostro team di supporto sarà in grado di aiutarti.
