Vai al contenuto

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_product in 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_event e create_plan con 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 in publish_blocked, e il passo successivo suggerito è compilare le informazioni aziendali e poi pubblicare con publish_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

StrumentoCosa faRuolo minimoTipo
list_plansPiani, opzioni e componenti aggiuntiviAdmin o FinanzaSolo lettura
list_productsOpzioni di fatturazione e prodotti, con prezzo e statoAdmin o FinanzaSolo lettura
list_couponsCoupon con stato e utilizziAdmin o FinanzaSolo lettura
create_productCrea un prodotto o un'opzione di fatturazione, in bozzaAdminModifica
create_planOpzioni, piano e componenti aggiuntivi, in una voltaAdminModifica
publish_productMette in vendita un prodottoAdminModifica
unpublish_productRitira un prodotto dalla venditaAdminModifica
update_priceCambia un prezzo, con confermaAdminChiede conferma
create_couponCrea un coupon, con confermaAdminChiede conferma
update_planCambia nome, indirizzo, opzioni e componenti aggiuntivi di un pianoAdminModifica
update_productCambia titolo, spazi, giacenza, rate, prova e link direttoAdminModifica
update_coupon_statusMette in pausa o riattiva un couponAdminChiede conferma
update_couponCambia nome, sconto, durata, limiti, validità e prodotti di un couponAdminChiede conferma
delete_couponElimina un couponAdminChiede conferma
get_coupon_usageChi ha usato un couponAdmin o FinanzaSolo lettura
list_downsell_offersLe offerte dell'ultima occasione di un piano, con la conversioneAdminSolo lettura
create_downsell_offerCrea un'offerta dell'ultima occasioneAdminChiede conferma
update_downsell_offerCambia o mette in pausa un'offerta dell'ultima occasioneAdminChiede conferma
delete_downsell_offerElimina un'offerta dell'ultima occasioneAdminChiede conferma
delete_productElimina un prodotto o un'opzione di fatturazioneAdminChiede conferma
delete_planElimina un pianoAdminChiede conferma
reorder_plansMette i piani in un nuovo ordine nella pagina dei prezziAdminModifica
get_storefrontCosa mostra uno spazio NegozioAdminSolo lettura
update_storefrontSceglie i prodotti di un NegozioAdminModifica

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.

ParametroTipoObbligatorioDescrizione
statusACTIVE, INACTIVE, EXPIREDNoUn solo stato
searchtestoNoParte del codice o del nome
page, limitnumeroNoPaginazione

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.

ParametroTipoObbligatorioDescrizione
titletesto, da 3 a 255Sì
typeSUBSCRIPTION, ONE_TIME, INSTALLMENTSìOpzione di abbonamento, prodotto singolo o a rate
pricenumero, nella valuta della communitySìNell'abbonamento, l'importo di ogni ciclo; nell'annuale a rate, l'importo dell'anno
intervalMONTHLY, YEARLYNoSolo in SUBSCRIPTION: mensile o annuale
max_installmentsda 1 a 12NoIn quante rate al massimo con carta (prodotto singolo, o annuale)
commitment_monthsda 1 a 36NoDurata del contratto; solo nel mensile
trial_daysda 0 a 365NoProva gratuita
descriptiontesto semplice, fino a 5.000NoSenza formattazione: i segni di Markdown vengono tolti
space_idselenco di idNoGli spazi che l'acquisto sblocca
stocknumeroNoQuantità in vendita (biglietti). Vuoto: senza limite
direct_linksì o noNoUn 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.

ParametroTipoObbligatorioDescrizione
nametesto, fino a 120SìIl nome del piano
descriptiontesto sempliceNoSenza formattazione: i segni di Markdown vengono tolti
slugtesto, fino a 60NoL'indirizzo del piano, per il link /pricing/<indirizzo>
optionselenco, da 1 a 6SìLe opzioni di fatturazione (vedi sotto)
add_on_idselenco di idNoProdotti mensili esistenti che non sono opzioni di un piano, da list_products
publishsì o noNoPubblica tutte le opzioni. Predefinito: bozza
idempotency_keytesto, fino a 100No

Ogni opzione:

CampoTipoDescrizione
titletesto, da 3 a 255Obbligatorio. Es.: Mentoring · Mensile
pricenumero, nella valuta della communityObbligatorio. Nell'annuale, l'importo dell'anno
intervalMONTHLY, YEARLYPredefinito: MONTHLY
max_installmentsda 1 a 12Nell'annuale, in quante rate al massimo con carta
commitment_monthsda 1 a 36Contratto minimo, nel mensile
trial_daysda 0 a 365Prova gratuita
descriptiontesto sempliceSenza formattazione: i segni di Markdown vengono tolti
space_idselenco di idGli 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.

ParametroTipoObbligatorioDescrizione
product_ididSì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.

ParametroTipoObbligatorioDescrizione
product_ididSì

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.

ParametroTipoObbligatorioDescrizione
product_ididSìDa list_products
new_pricenumero, in reaisSì

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.

ParametroTipoObbligatorioDescrizione
codetesto, da 2 a 50SìEs.: PRO20. Viene salvato in maiuscolo
nametesto, fino a 120SìIl nome interno
typePERCENTAGE, FIXEDSìPercentuale o importo fisso
valuenumeroSì20 = 20%, oppure l'importo in reais
durationONCE, FOREVER, REPEATINGNoNegli abbonamenti: solo il 1° addebito (predefinito), sempre, o per alcuni mesi
monthsda 1 a 36NoCon REPEATING
max_usesnumeroNoVuoto: senza limite
start_datedata ISO 8601NoPredefinito: adesso
end_datedata ISO 8601NoVuoto: senza fine
product_idselenco di idNoSolo 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.

ParametroTipoObbligatorioDescrizione
planid o link (/pricing/…)Sì
name, description, slugtestoNo
activesì o noNo
option_idselenco di idNoL'elenco intero delle opzioni del piano
add_on_idselenco di idNoL'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.

ParametroTipoObbligatorioDescrizione
productid o slugSì
title, description, short_descriptiontestoNo
space_idselenco di idNoGli spazi che l'acquisto sblocca
stocknumeroNo
max_installmentsnumeroNo
trial_daysnumeroNo
direct_linksì o noNo

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.

ParametroTipoObbligatorioDescrizione
couponid o codiceSì
statusACTIVE, INACTIVESì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.

ParametroTipoObbligatorioDescrizione
couponid o codiceSì
name, descriptiontestoNo
valuenumeroNoPercentuale (20 = 20%) o importo, secondo il tipo di coupon
durationONCE, FOREVER, REPEATINGNoUna volta, per sempre o per alcuni mesi
monthsda 1 a 36NoCon REPEATING
max_uses, max_uses_per_personnumeroNoLimiti di utilizzo
start_date, end_datedataNoLa validità
product_idselenco di idNoI 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.

ParametroTipoObbligatorioDescrizione
couponid o codiceSì

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.

ParametroTipoObbligatorioDescrizione
couponid o codiceSì
pagenumeroNo

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.

ParametroTipoObbligatorioDescrizione
planid o linkSì

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.

ParametroTipoObbligatorioDescrizione
planid o linkSì
add_on_ididSìIl componente aggiuntivo del piano
discount_percentnumeroNo
timingIMMEDIATE, DELAYEDNoSubito (predefinito) o dopo un certo tempo
delay_minutesnumeroNoCon DELAYED
price_durationFOREVER, FIRST_CHARGE, CYCLESNoSconto per sempre, solo sul primo addebito o per alcuni cicli
cyclesnumeroNoCon CYCLES
ttl_minutesnumeroNoPer 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.

ParametroTipoObbligatorioDescrizione
planid o linkSì
offer_ididSìDa list_downsell_offers
discount_percent, timing, delay_minutes, price_duration, cycles, ttl_minutesNoGli stessi di create_downsell_offer
activesì o noNoCon 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.

ParametroTipoObbligatorioDescrizione
planid o linkSì
offer_ididSì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.

ParametroTipoObbligatorioDescrizione
productid o slugSì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.

ParametroTipoObbligatorioDescrizione
planid 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.

ParametroTipoObbligatorioDescrizione
plan_idselenco di idSì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.

ParametroTipoObbligatorioDescrizione
spaceid o linkSìLo spazio Negozio

update_storefront

Modifica

Scegliere i prodotti del negozio. Definisce cosa vende uno spazio Negozio. Ruolo minimo: Admin.

ParametroTipoObbligatorioDescrizione
spaceid o linkSì
modeall, selectedSìTutti i prodotti pubblicati, o solo quelli scelti
product_idselenco di idNoCon selected, da list_products

Chiedi così: "Lascia nel negozio solo i corsi singoli."

Vedi Negozio.

Correlati