Strumenti · Vendite e piani
Strumenti MCP per vendere: elencare piani, prodotti e coupon, creare opzioni di fatturazione e piani con componenti aggiuntivi in bozza, pubblicare e ritirare dalla vendita, cambiare prezzi, creare, modificare ed eliminare coupon e offerte di downsell, eliminare prodotti e piani e riordinare i piani, con conferma per ciò che tocca il denaro.
Ciò che la community vende: piani con le opzioni di fatturazione e i componenti aggiuntivi, prodotti singoli, coupon. Tutto nasce in bozza e va in vendita solo quando lo chiedi; cambiare un prezzo, creare o modificare un coupon, creare o modificare un'offerta di ultima occasione ed eliminare chiedono il tuo sì, con un riepilogo dei valori. Cambiare un piano (update_plan) viene eseguito alla prima chiamata.
Bozza prima dell'approvazione
Puoi preparare tutto prima che le informazioni aziendali siano approvate: prodotti, opzioni, piani, componenti aggiuntivi, coupon e offerte di downsell nascono in bozza e si possono modificare liberamente. Ciò che aspetta l'approvazione è pubblicare e vendere:
publish_productin una community senza approvazione viene rifiutato con il messaggio di Memberfy: "Per pubblicare e iniziare a vendere, la community deve avere le informazioni aziendali approvate. Nel frattempo puoi creare e configurare tutto come bozza: compilale in Impostazioni › Informazioni Aziendali e inviale per la revisione."- Negli strumenti composti (
create_course,create_eventecreate_plancon pubblicazione), il rifiuto non annulla nulla: il corso, l'evento, il biglietto, il piano e le opzioni restano in bozza, la risposta riporta il motivo inpublish_blocked, e il passo successivo suggerito è compilare le informazioni aziendali e poi pubblicare conpublish_product. - Il prezzo di una bozza è nella valuta del paese delle informazioni aziendali (in qualsiasi stato) oppure, se non ci sono, in reais. Se la valuta approvata è un'altra, la pubblicazione viene rifiutata ("Questo prodotto è in …, ma la valuta delle informazioni aziendali approvate è …"): sistema prima valuta e prezzo.
Ogni strumento ha un'etichetta: Solo lettura non cambia nulla, Modifica crea o cambia qualcosa subito, e Chiede conferma agisce solo dopo il tuo sì a un riepilogo. Vedi Denaro e conferma.
In sintesi
| Strumento | Cosa fa | Ruolo minimo | Tipo |
|---|---|---|---|
list_plans | Piani, opzioni e componenti aggiuntivi | Admin o Finanza | Solo lettura |
list_products | Opzioni di fatturazione e prodotti, con prezzo e stato | Admin o Finanza | Solo lettura |
list_coupons | Coupon con stato e utilizzi | Admin o Finanza | Solo lettura |
create_product | Crea un prodotto o un'opzione di fatturazione, in bozza | Admin | Modifica |
create_plan | Opzioni, piano e componenti aggiuntivi, in una volta | Admin | Modifica |
publish_product | Mette in vendita un prodotto | Admin | Modifica |
unpublish_product | Ritira un prodotto dalla vendita | Admin | Modifica |
update_price | Cambia un prezzo, con conferma | Admin | Chiede conferma |
create_coupon | Crea un coupon, con conferma | Admin | Chiede conferma |
update_plan | Cambia nome, indirizzo, opzioni e componenti aggiuntivi di un piano | Admin | Modifica |
update_product | Cambia titolo, spazi, giacenza, rate, prova e link diretto | Admin | Modifica |
update_coupon_status | Mette in pausa o riattiva un coupon | Admin | Chiede conferma |
update_coupon | Cambia nome, sconto, durata, limiti, validità e prodotti di un coupon | Admin | Chiede conferma |
delete_coupon | Elimina un coupon | Admin | Chiede conferma |
get_coupon_usage | Chi ha usato un coupon | Admin o Finanza | Solo lettura |
list_downsell_offers | Le offerte dell'ultima occasione di un piano, con la conversione | Admin | Solo lettura |
create_downsell_offer | Crea un'offerta dell'ultima occasione | Admin | Chiede conferma |
update_downsell_offer | Cambia o mette in pausa un'offerta dell'ultima occasione | Admin | Chiede conferma |
delete_downsell_offer | Elimina un'offerta dell'ultima occasione | Admin | Chiede conferma |
delete_product | Elimina un prodotto o un'opzione di fatturazione | Admin | Chiede conferma |
delete_plan | Elimina un piano | Admin | Chiede conferma |
reorder_plans | Mette i piani in un nuovo ordine nella pagina dei prezzi | Admin | Modifica |
get_storefront | Cosa mostra uno spazio Negozio | Admin | Solo lettura |
update_storefront | Sceglie i prodotti di un Negozio | Admin | Modifica |
list_plans
Solo lettura
Elencare i piani. I piani della community, con le opzioni di fatturazione e i componenti aggiuntivi di ciascuno. Ruolo minimo: Admin o Finanza.
Parametri: nessuno.
Restituisce: i piani (id, nome, indirizzo), le opzioni di ciascuno (id, titolo, prezzo, intervallo, stato) e i componenti aggiuntivi.
Chiedi così: "Quali piani abbiamo, e quanto costa ogni opzione?"
list_products
Solo lettura
Elencare opzioni di fatturazione e prodotti. Tutti i prodotti: opzioni di abbonamento, prodotti singoli, a rate e componenti aggiuntivi. Ruolo minimo: Admin o Finanza.
Parametri: nessuno.
Restituisce: ogni prodotto con id, titolo, tipo, prezzo, intervallo, stato (bozza o pubblicato) e gli spazi che sblocca. L'id è quello che chiedono create_plan (in add_on_ids), update_price, publish_product e create_coupon.
Chiedi così: "Quali prodotti sono in bozza?"
list_coupons
Solo lettura
Elencare i coupon. I coupon, con stato e utilizzi. Ruolo minimo: Admin o Finanza.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
status | ACTIVE, INACTIVE, EXPIRED | No | Un solo stato |
search | testo | No | Parte del codice o del nome |
page, limit | numero | No | Paginazione |
Restituisce: i coupon, con codice, tipo, valore, durata, validità, limite e utilizzi.
Chiedi così: "Quali coupon sono attivi e quante volte è stato usato ciascuno?"
create_product
Modifica
Creare un'opzione di fatturazione o un prodotto. Crea un prodotto in bozza: un'opzione di abbonamento, un prodotto singolo (biglietto, corso) o a rate. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
title | testo, da 3 a 255 | Sì | |
type | SUBSCRIPTION, ONE_TIME, INSTALLMENT | Sì | Opzione di abbonamento, prodotto singolo o a rate |
price | numero, nella valuta della community | Sì | Nell'abbonamento, l'importo di ogni ciclo; nell'annuale a rate, l'importo dell'anno |
interval | MONTHLY, YEARLY | No | Solo in SUBSCRIPTION: mensile o annuale |
max_installments | da 1 a 12 | No | In quante rate al massimo con carta (prodotto singolo, o annuale) |
commitment_months | da 1 a 36 | No | Durata del contratto; solo nel mensile |
trial_days | da 0 a 365 | No | Prova gratuita |
description | testo semplice, fino a 5.000 | No | Senza formattazione: i segni di Markdown vengono tolti |
space_ids | elenco di id | No | Gli spazi che l'acquisto sblocca |
stock | numero | No | Quantità in vendita (biglietti). Vuoto: senza limite |
direct_link | sì o no | No | Un prodotto singolo vendibile tramite link diretto, fuori dal Negozio |
Restituisce: il prodotto creato, in bozza, con l'id.
Chiedi così: "Crea il prodotto Mentoring singolo, R$ 450, fino a 3 rate, che sblocca lo spazio Mentoring. Lascialo in bozza."
Note: non si vende nulla finché non c'è publish_product, e la creazione non dipende dalle informazioni aziendali approvate (vedi Bozza prima dell'approvazione). Per un piano con più opzioni, create_plan fa tutto in una volta. Le regole di ogni campo sono quelle del pannello: vedi Prodotti e Opzioni di fatturazione.
create_plan
Modifica
Creare un piano con opzioni e componenti aggiuntivi. Opzioni di fatturazione → piano con le opzioni → componenti aggiuntivi collegati. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
name | testo, fino a 120 | Sì | Il nome del piano |
description | testo semplice | No | Senza formattazione: i segni di Markdown vengono tolti |
slug | testo, fino a 60 | No | L'indirizzo del piano, per il link /pricing/<indirizzo> |
options | elenco, da 1 a 6 | Sì | Le opzioni di fatturazione (vedi sotto) |
add_on_ids | elenco di id | No | Prodotti mensili esistenti che non sono opzioni di un piano, da list_products |
publish | sì o no | No | Pubblica tutte le opzioni. Predefinito: bozza |
idempotency_key | testo, fino a 100 | No |
Ogni opzione:
| Campo | Tipo | Descrizione |
|---|---|---|
title | testo, da 3 a 255 | Obbligatorio. Es.: Mentoring · Mensile |
price | numero, nella valuta della community | Obbligatorio. Nell'annuale, l'importo dell'anno |
interval | MONTHLY, YEARLY | Predefinito: MONTHLY |
max_installments | da 1 a 12 | Nell'annuale, in quante rate al massimo con carta |
commitment_months | da 1 a 36 | Contratto minimo, nel mensile |
trial_days | da 0 a 365 | Prova gratuita |
description | testo semplice | Senza formattazione: i segni di Markdown vengono tolti |
space_ids | elenco di id | Gli spazi che l'opzione sblocca |
Restituisce: il piano (id, nome, indirizzo), le opzioni (id, titolo, prezzo, intervallo, stato) e i componenti aggiuntivi collegati.
Chiedi così: "Crea il piano Mentoring con mensile da R$ 390 con contratto di 6 mesi e annuale da R$ 3.900 fino a 12 rate, entrambi che sbloccano lo spazio Mentoring, e collega la Sessione individuale come componente aggiuntivo."
Note: se un passaggio fallisce, il piano viene annullato per ultimo, perché Memberfy non elimina un piano che ha ancora opzioni. Vedi Piani, Componenti aggiuntivi e Annuale a rate.
publish_product
Modifica
Pubblicare un prodotto (metterlo in vendita). Mette in vendita un prodotto in bozza. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
product_id | id | Sì | Da list_products o da una creazione |
Restituisce: il prodotto, pubblicato.
Chiedi così: "Puoi pubblicare il prodotto Excel da Zero."
Note: la pubblicazione richiede le informazioni aziendali approvate, e il prodotto nella valuta del paese approvato. Senza, Memberfy rifiuta e il prodotto resta in bozza, modificabile. Vedi Bozza prima dell'approvazione.
unpublish_product
Modifica
Ritirare un prodotto dalla vendita. Ritira un prodotto dalla vendita. Chi ha già comprato mantiene l'accesso. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
product_id | id | Sì |
Restituisce: il prodotto, fuori vendita.
Chiedi così: "Ritira dalla vendita il biglietto dell'incontro di ottobre."
update_price
Chiede conferma
Cambiare il prezzo di un prodotto. Cambia il prezzo di un prodotto o di un'opzione di fatturazione. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
product_id | id | Sì | Da list_products |
new_price | numero, in reais | Sì |
Il riepilogo: il prodotto, il prezzo attuale, il prezzo nuovo e lo stato (bozza o pubblicato).
Chiedi così: "Aumenta il Growth Mensile da R$ 129 a R$ 149."
Note: gli abbonamenti già esistenti seguono le regole di Memberfy per il cambio di prezzo, le stesse della modifica dal pannello. Vedi Opzioni di fatturazione.
create_coupon
Chiede conferma
Creare un coupon. Crea un coupon di sconto, in percentuale o a importo fisso, per tutti i prodotti o solo per alcuni. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
code | testo, da 2 a 50 | Sì | Es.: PRO20. Viene salvato in maiuscolo |
name | testo, fino a 120 | Sì | Il nome interno |
type | PERCENTAGE, FIXED | Sì | Percentuale o importo fisso |
value | numero | Sì | 20 = 20%, oppure l'importo in reais |
duration | ONCE, FOREVER, REPEATING | No | Negli abbonamenti: solo il 1° addebito (predefinito), sempre, o per alcuni mesi |
months | da 1 a 36 | No | Con REPEATING |
max_uses | numero | No | Vuoto: senza limite |
start_date | data ISO 8601 | No | Predefinito: adesso |
end_date | data ISO 8601 | No | Vuoto: senza fine |
product_ids | elenco di id | No | Solo questi prodotti. Vuoto: tutti |
Il riepilogo: l'azione, il codice, lo sconto (20% o R$ 50,00), la durata, il limite di utilizzi, la validità e i prodotti.
Chiedi così: "Crea il coupon BLACK30, 30% solo sul primo addebito, per i piani Growth, fino a 100 utilizzi, valido fino al 30/11."
Vedi Coupon.
update_plan
Modifica
Modificare un piano. Cambia nome, descrizione, indirizzo, se è attivo, le opzioni di fatturazione e i componenti aggiuntivi di un piano. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
plan | id o link (/pricing/…) | Sì | |
name, description, slug | testo | No | |
active | sì o no | No | |
option_ids | elenco di id | No | L'elenco intero delle opzioni del piano |
add_on_ids | elenco di id | No | L'elenco intero dei componenti aggiuntivi |
Chiedi così: "Togli l'annuale dal piano Growth e lascia solo il mensile."
Note: cambia subito ciò che si vende, senza conferma. Il prezzo si cambia con update_price, che chiede il tuo sì.
update_product
Modifica
Modificare un prodotto. Cambia titolo, descrizioni, spazi che sblocca, giacenza, rate, prova gratuita o link diretto. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
product | id o slug | Sì | |
title, description, short_description | testo | No | |
space_ids | elenco di id | No | Gli spazi che l'acquisto sblocca |
stock | numero | No | |
max_installments | numero | No | |
trial_days | numero | No | |
direct_link | sì o no | No |
Chiedi così: "Porta la giacenza del biglietto a 120."
Note: il prezzo si cambia con update_price, che chiede conferma.
update_coupon_status
Chiede conferma
Mettere in pausa o riattivare un coupon. Mette in pausa o riattiva un coupon. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
coupon | id o codice | Sì | |
status | ACTIVE, INACTIVE | Sì | Riattivare o mettere in pausa |
Chiedi così: "Metti in pausa il coupon BLACK30."
update_coupon
Chiede conferma
Modifica coupon. Cambia un coupon esistente. Cambia solo ciò che viene inviato; per metterlo in pausa c'è update_coupon_status. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
coupon | id o codice | Sì | |
name, description | testo | No | |
value | numero | No | Percentuale (20 = 20%) o importo, secondo il tipo di coupon |
duration | ONCE, FOREVER, REPEATING | No | Una volta, per sempre o per alcuni mesi |
months | da 1 a 36 | No | Con REPEATING |
max_uses, max_uses_per_person | numero | No | Limiti di utilizzo |
start_date, end_date | data | No | La validità |
product_ids | elenco di id | No | I prodotti su cui vale il coupon |
Restituisce: alla prima chiamata, il codice del coupon e ciò che cambia, più il codice di conferma.
Chiedi così: "Porta BLACK30 al 40% ed estendilo fino a domenica."
Vedi Coupon.
delete_coupon
Chiede conferma
Elimina coupon. Gli sconti già concessi restano validi. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
coupon | id o codice | Sì |
Restituisce: alla prima chiamata, il codice del coupon e quante volte è stato usato, più il codice di conferma.
get_coupon_usage
Solo lettura
Vedere l'uso di un coupon. Chi l'ha usato, quando e quanto sconto. Ruolo minimo: Admin o Finanza.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
coupon | id o codice | Sì | |
page | numero | No |
Chiedi così: "Chi ha usato il coupon BLACK30?"
list_downsell_offers
Solo lettura
Offerte di downsell di un piano. Le offerte di sconto sui componenti aggiuntivi dopo l'acquisto di un piano, con quante volte sono state mostrate e convertite. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
plan | id o link | Sì |
Chiedi così: "Quanto converte l'offerta dell'ultima occasione dell'Estensione Coworking?"
create_downsell_offer
Chiede conferma
Creare un'offerta di downsell. Crea un'offerta di sconto su un componente aggiuntivo, mostrata dopo il pagamento del piano. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
plan | id o link | Sì | |
add_on_id | id | Sì | Il componente aggiuntivo del piano |
discount_percent | numero | No | |
timing | IMMEDIATE, DELAYED | No | Subito (predefinito) o dopo un certo tempo |
delay_minutes | numero | No | Con DELAYED |
price_duration | FOREVER, FIRST_CHARGE, CYCLES | No | Sconto per sempre, solo sul primo addebito o per alcuni cicli |
cycles | numero | No | Con CYCLES |
ttl_minutes | numero | No | Per quanto tempo vale l'offerta |
Chiedi così: "Offri il 30% sull'Estensione Coworking a chi si abbona a Growth senza, per i primi 3 addebiti."
Vedi Downsell.
update_downsell_offer
Chiede conferma
Modifica offerta di downsell. Cambia un'offerta dell'ultima occasione di un piano, o la mette in pausa. Cambia solo ciò che viene inviato. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
plan | id o link | Sì | |
offer_id | id | Sì | Da list_downsell_offers |
discount_percent, timing, delay_minutes, price_duration, cycles, ttl_minutes | No | Gli stessi di create_downsell_offer | |
active | sì o no | No | Con no, mette in pausa l'offerta |
Chiedi così: "Metti in pausa l'offerta dell'Estensione Coworking fino a fine mese."
delete_downsell_offer
Chiede conferma
Elimina offerta di downsell. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
plan | id o link | Sì | |
offer_id | id | Sì | Da list_downsell_offers |
delete_product
Chiede conferma
Elimina prodotto. Elimina un prodotto o un'opzione di fatturazione. Chi l'ha acquistato mantiene l'accesso. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
product | id o slug | Sì | Da list_products |
Restituisce: alla prima chiamata, il titolo, il prezzo e lo stato, più il codice di conferma.
Note: per smettere soltanto di vendere, meglio unpublish_product. Vedi Prodotti.
delete_plan
Chiede conferma
Elimina piano. Chi è già abbonato non viene annullato. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
plan | id o link (/pricing/…) | Sì |
Restituisce: alla prima chiamata, il nome del piano e le sue opzioni, più il codice di conferma.
reorder_plans
Modifica
Riordina piani. Mette i piani in un nuovo ordine nella pagina dei prezzi, dal primo all'ultimo. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
plan_ids | elenco di id | Sì | Da list_plans, nel nuovo ordine |
Chiedi così: "Nella pagina dei prezzi, metti Growth prima di Starter."
get_storefront
Solo lettura
Vedere il negozio. Cosa mostra uno spazio Negozio: tutti i prodotti o solo quelli scelti. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
space | id o link | Sì | Lo spazio Negozio |
update_storefront
Modifica
Scegliere i prodotti del negozio. Definisce cosa vende uno spazio Negozio. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
space | id o link | Sì | |
mode | all, selected | Sì | Tutti i prodotti pubblicati, o solo quelli scelti |
product_ids | elenco di id | No | Con selected, da list_products |
Chiedi così: "Lascia nel negozio solo i corsi singoli."
Vedi Negozio.