# Ricette

> Quattordici richieste pronte per l'assistente, con il testo della richiesta, gli strumenti che deve chiamare, in ordine, e il risultato in Memberfy. Corso con pagina di vendita, mentoring di gruppo con incontri, evento con biglietto, piano mensile e annuale con componenti aggiuntivi, riepilogo settimanale, risposta ai commenti, grafico dei ricavi, spazi con icona e immagine, modificare ciò che esiste già, invitare una classe, rilasciare certificati, creare un modello con la grafica del brand, creare una call for papers e scoprire chi ha fatto cosa.

Ogni ricetta contiene una richiesta che funziona, la sequenza di strumenti che l'assistente deve usare e cosa compare in Memberfy alla fine. Sostituisci nomi e valori con i tuoi. L'assistente può variare l'ordine delle letture; ciò che conta è il risultato.

Tutte presuppongono un collegamento con il ruolo di **proprietario** o **Admin**, salvo dove indicato.

> [!TIP]
> In Claude, sei di queste ricette sono pronte nel menu **+** › **Connettori** › **Memberfy**, già nella tua lingua: [Un corso con pagina di vendita](#1-un-corso-con-pagina-di-vendita), [Un evento con biglietto](#3-un-evento-con-biglietto), [Invitare una classe](#10-invitare-una-classe), [Rilasciare certificati alla classe](#11-rilasciare-certificati-alla-classe), [Creare un modello con la grafica del brand](#12-creare-un-modello-con-la-grafica-del-brand) e [Creare una call for papers](#13-creare-una-call-for-papers), insieme al report del mese e alla valutazione delle proposte di una call. Vedi [Ricette pronte nel menu](/mcp/conectar-o-claude#ricette-pronte-nel-menu).

## 1. Un corso con pagina di vendita

**Per chi:** scuola online o esperto che vende un corso registrato.

**Richiesta:**

> Crea il corso "Excel da Zero" in una nuova sezione chiamata Imparare: 4 moduli (Fondamenti, Formule, Tabelle pivot, Grafici), con 3 lezioni video di circa 10 minuti ciascuno. Crea il prodotto del corso a R$ 297 fino a 10 rate, vendibile tramite link diretto. Lascia tutto in bozza e dimmi cosa manca per iniziare a vendere.

**Strumenti, in ordine:**

| # | Strumento | Cosa fa |
|---|---|---|
| 1 | `get_community_context` | Verifica il ruolo e le sezioni |
| 2 | `create_section` | Crea *Imparare* |
| 3 | `create_course` | Con `section_id` della nuova sezione, i 4 moduli con 3 lezioni ciascuno, e `sale` con `price: 297`, `max_installments: 10`, `direct_link: true` |

**Risultato:** la sezione *Imparare*, lo spazio Corsi *Excel da Zero*, il corso con 4 moduli e 12 lezioni, e il prodotto *Excel da Zero* in bozza, che sblocca lo spazio. L'assistente avvisa che mancano il contenuto delle lezioni (dal pannello) e la pubblicazione.

**Per metterlo in vendita:** *"Puoi pubblicare il prodotto."* (`publish_product`). Con il link diretto attivo, il prodotto compare nel catalogo `/products` della community, e chi compra paga nel [checkout](/pagamentos/checkout).

## 2. Mentoring di gruppo con incontri ricorrenti

**Per chi:** mentor con un gruppo che si incontra ogni settimana.

**Richiesta:**

> Voglio lanciare il Mentoring di Carriera: un abbonamento mensile da R$ 390, con contratto minimo di 3 mesi, che sblocca uno spazio di eventi solo per chi partecipa al mentoring. Crea lo spazio Mentoring di Carriera nella sezione Programmi, e i 4 incontri di novembre, il martedì, dalle 20 alle 21:30, online, con il link https://meet.exemplo.com/mentoria. Lascia il piano in bozza.

**Strumenti, in ordine:**

| # | Strumento | Cosa fa |
|---|---|---|
| 1 | `get_community_context` | Trova la sezione *Programmi* |
| 2 | `create_space` | Spazio Eventi *Mentoring di Carriera*, `visibility: plan` |
| 3 | `create_plan` | Piano *Mentoring di Carriera*, un'opzione mensile da R$ 390 con `commitment_months: 3` e `space_ids` con il nuovo spazio |
| 4-7 | `create_event` ×4 | Uno per martedì, con lo stesso `space_id` e `type: online` |

**Risultato:** lo spazio, sbloccato solo per chi si abbona; il piano con l'opzione mensile in bozza; i quattro incontri nello spazio.

**Note:** non esistono eventi ricorrenti: l'assistente crea un evento per data. Per i mesi successivi, chiedi di nuovo (*"crea gli incontri di dicembre, uguali a quelli di novembre"*). Vedi [Durata del contratto](/monetizacao/duracao-do-contrato).

## 3. Un evento con biglietto

**Per chi:** community che organizza incontri dal vivo a pagamento.

**Richiesta:**

> Crea l'Incontro di Novembre: dal vivo, 15/11 dalle 19 alle 22, allo Spazio Paulista, Rua Augusta 1500, Consolação, San Paolo, SP. 80 biglietti a R$ 60, fino a 2 rate. Usa lo spazio eventi che esiste già e pubblica il biglietto.

**Strumenti, in ordine:**

| # | Strumento | Cosa fa |
|---|---|---|
| 1 | `list_spaces` | Con `module: events`, trova lo spazio |
| 2 | `create_event` | Con `space_id`, `type: in_person`, l'indirizzo, e `ticket` con `price: 60`, `max_installments: 2`, `stock: 80`, `publish: true` |

**Risultato:** l'evento nello spazio, e il biglietto in vendita con 80 unità.

**Note:** chi compra il biglietto ottiene l'accesso allo spazio, ma non entra ancora da solo nella lista dei partecipanti: chiedi di confermare la presenza all'evento, oppure segui le vendite tramite il biglietto.

## 4. Un piano con mensile, annuale e componenti aggiuntivi

**Per chi:** SaaS, scuola o coworking con abbonamento.

**Richiesta:**

> Crea il piano Growth: mensile da R$ 129 e annuale da R$ 1.188 fino a 12 rate, entrambi con 7 giorni di prova, che sbloccano lo spazio Area Clienti. Collega come componente aggiuntivo l'Estensione Coworking che esiste già. Indirizzo del piano: growth. Lascialo in bozza.

**Strumenti, in ordine:**

| # | Strumento | Cosa fa |
|---|---|---|
| 1 | `list_spaces` | Trova lo spazio *Area Clienti* |
| 2 | `list_products` | Trova l'id dell'*Estensione Coworking* |
| 3 | `create_plan` | `name: Growth`, `slug: growth`, due `options` (mensile 129 e annuale 1188 con `max_installments: 12`, entrambe con `trial_days: 7` e lo `space_ids`), e `add_on_ids` |

**Risultato:** il piano *Growth* con le due opzioni in bozza e il componente aggiuntivo collegato. Una volta pubblicato, il link è `/pricing/growth`.

**Note:** nell'annuale a rate, la rateizzazione comporta gli [interessi di rateizzazione di Memberfy](/monetizacao/anual-parcelado#gli-interessi-della-rateizzazione), pagati di default dall'acquirente. Per cambiare chi li paga, usa il pannello.

## 5. Il riepilogo settimanale della community

**Per chi:** qualsiasi community. Funziona con il ruolo di **moderatore**.

**Richiesta:**

> Fai il riepilogo della settimana: chi è entrato, i post con più commenti, i prossimi eventi con quante persone hanno confermato. Poi scrivi un post di riepilogo per il Feed, con un tono leggero, e mostramelo prima di pubblicarlo.

**Strumenti, in ordine:**

| # | Strumento | Cosa fa |
|---|---|---|
| 1 | `list_members` | `sort_by: joinedAt`, `order: desc`: chi è entrato |
| 2 | `list_posts` | Il feed recente, con i conteggi |
| 3 | `list_events` | `filter: next` |
| 4 | `list_event_attendees` | Per ogni evento, con `status: going` |
| 5 | `create_post` | Dopo il tuo ok, nello spazio Feed |

**Risultato:** il riepilogo nella conversazione e, dopo la tua approvazione, il post nel Feed.

## 6. Rispondere ai commenti

**Per chi:** chi fa live o post con domande.

**Richiesta:**

> Guarda i commenti del post "Live di martedì: domande" e rispondi a ogni domanda che non ha ancora una mia risposta, ringraziando e dicendo che ne parlerò nella prossima live. Reagisci con 👍 a quelli che hanno solo ringraziato.

**Strumenti, in ordine:**

| # | Strumento | Cosa fa |
|---|---|---|
| 1 | `list_posts` | Trova il post e l'id |
| 2 | `list_comments` | I commenti, con l'autore |
| 3 | `create_comment` ×N | Con `reply_to` su ogni domanda |
| 4 | `add_reaction` ×N | 👍 sui ringraziamenti |

**Risultato:** le risposte sotto ogni commento, con il tuo nome.

**Note:** le risposte escono con il tuo nome, subito. Se preferisci, chiedi di vedere i testi prima: *"mostrami le risposte prima di pubblicarle"*.

## 7. Il grafico dei ricavi

**Per chi:** proprietario, Admin o **Finanza**.

**Richiesta:**

> Fai un grafico a barre dei ricavi mese per mese negli ultimi 12 mesi, e una tabella dei ricavi per prodotto nel periodo. Dimmi quanti abbonati sono in ritardo.

**Strumenti, in ordine:**

| # | Strumento | Cosa fa |
|---|---|---|
| 1 | `get_sales_summary` | `period: 1y`: la serie mensile, i ricavi per prodotto e gli abbonati per stato |
| 2 | `list_subscriptions` | `status: PAST_DUE`, se vuoi i nomi |

**Risultato:** l'assistente costruisce il grafico e la tabella nella conversazione (in Claude, come artefatto). I valori sono gli stessi di **Monetizzazione › Generale**, con la commissione della piattaforma; i costi interni non compaiono.

> [!TIP]
> Con gli strumenti di [Report e grafici](/mcp/relatorios-e-graficos), la stessa richiesta esce da `sales_report` con `group_by: plan` (ricavi per mese e per piano, presi dall'estratto conto), e il riepilogo della settimana da `community_overview` e `engagement_report`.

## 8. Spazi con icona e post con immagine

**Per chi:** chi sta costruendo la community e vuole ogni spazio riconoscibile nel menu.

**Richiesta:**

> Nella sezione Community, crea tre spazi Feed: Presentazioni, Offerte di lavoro e Domande tecniche, ognuno con un'icona adatta al tema. Poi pubblica in Presentazioni un post di benvenuto con questa immagine di copertina: https://exemplo.com/boas-vindas.png. E metti questa foto dell'ultimo incontro nella galleria Incontri: https://exemplo.com/encontro.jpg.

**Strumenti, in ordine:**

| # | Strumento | Cosa fa |
|---|---|---|
| 1 | `get_community_context` | Trova la sezione *Community*, la galleria *Incontri* e le icone disponibili |
| 2 a 4 | `create_space` ×3 | Con un'`icon` diversa per ciascuno, per esempio `user`, `briefcase` e `message-square` |
| 5 | `create_post` | Nello spazio *Presentazioni*, con `image_url` |
| 6 | `add_gallery_image` | Nella galleria, con `image_url` |

**Risultato:** i tre spazi nel menu, ognuno con la sua icona; il post con la copertina; la foto in galleria. Le immagini restano salvate in Memberfy: il link originale può anche sparire in seguito.

**Note:** se l'assistente usa la stessa icona per tutto, chiedi *"usa un'icona diversa per ogni spazio, in base al tema"*. Per cambiarla in seguito: *"cambia l'icona di Offerte di lavoro con una valigetta"* (`update_space`). Vedi [Immagini](/mcp/ferramentas#immagini).

## 9. Modificare ciò che esiste già

**Per chi:** chi ha pubblicato e vuole correggere.

**Richiesta:**

> Nel post "Come funziona la community", sostituisci la copertina con un'immagine generata da te, con il nome della community in verde, e fissa il post in alto. Poi elimina il post duplicato con lo stesso titolo.

**Strumenti, in ordine:**

| # | Strumento | Cosa fa |
|---|---|---|
| 1 | `search_content` | Trova i due post con quel titolo |
| 2 | `update_post` | Sull'originale, con `image_base64` (l'immagine generata) e `pinned: true` |
| 3 | `delete_post` | Sul duplicato: la prima chiamata mostra il post; con il tuo sì, lo elimina |

**Risultato:** il post con la nuova copertina, fissato; il duplicato eliminato.

**Note:** puoi anche incollare il link del post: *"Modifica questo post: https://…"*. Vedi [Contenuti e coinvolgimento](/mcp/ferramentas-conteudo).

## 10. Invitare una classe

**Per chi:** scuola, corso o programma che accoglie un'intera classe in una volta.

**Richiesta:**

> Invita queste persone come membri, tutte nel gruppo Classe di marzo (crea il gruppo se non esiste) e con il tag Studente 2026: Ana Souza, ana@memberfy.net; Bruno Lima, bruno@memberfy.net; Carla Dias, carla@memberfy.net. Mostrami il riepilogo prima di inviare.

**Strumenti, in ordine:**

| # | Strumento | Cosa fa |
|---|---|---|
| 1 | `list_groups` | Controlla se il gruppo *Classe di marzo* esiste |
| 2 | `create_group` | Crea il gruppo, se non esiste |
| 3 | (nella conversazione) | Mostra l'elenco: 3 persone, ruolo Membro, gruppo *Classe di marzo*, tag *Studente 2026*, e aspetta il tuo ok |
| 4 | `invite_members` | Dopo il tuo ok: gli inviti partono |

**Risultato:** ogni persona riceve l'e-mail d'invito (chi non ha un account, con il link per impostare la password) ed entra già nel gruppo e con il tag. L'assistente mostra il risultato riga per riga: invitata, era già membro o errore, con il motivo.

**Note:** fino a 100 persone per chiamata; per una classe più grande, l'assistente divide. Chi era già membro non ferma il resto. Per incollare un foglio di calcolo, chiedi *"leggi questi nomi ed e-mail dalla tabella qui sotto"*. Vedi [Membri](/mcp/ferramentas-membros#invite-members).

## 11. Rilasciare certificati alla classe

**Per chi:** scuola, corso o evento che certifica chi ha concluso.

**Richiesta:**

> Rilascia il certificato di completamento al gruppo Classe di marzo, argomento Excel da zero, 40 ore. Dimmi prima quante persone lo riceveranno.

**Strumenti, in ordine:**

| # | Strumento | Cosa fa |
|---|---|---|
| 1 | `list_certificate_templates` | Trova il modello attivo di completamento |
| 2 | `list_groups` | Trova l'id del gruppo *Classe di marzo* |
| 3 | `issue_certificate` | Con `dry_run: true`, la **prova**: quante persone lo ricevono, chi viene saltato e perché (per esempio chi ha già il certificato). Non viene rilasciato nulla |
| 4 | `issue_certificate` | Dopo il tuo ok, la stessa chiamata senza la prova: i certificati vengono rilasciati |

**Risultato:** ogni persona della classe riceve il certificato, con il PDF, l'immagine e la pagina di verifica, e l'e-mail *"Il tuo certificato è arrivato"*. In **Rilasciati**, nello spazio Certificati, il rilascio compare con l'avanzamento.

**Note:** puoi mescolare persone, gruppi e tag nello stesso rilascio; chi è in più di uno riceve un solo certificato. Per chi ne ha già uno valido e deve riceverlo di nuovo, chiedi *"rilascialo anche a chi lo ha già"*. Vedi [Certificati](/mcp/ferramentas-certificados#issue-certificate).

## 12. Creare un modello con la grafica del brand

**Per chi:** chi ha una grafica pronta, fatta dal designer.

**Richiesta:**

> Crea un modello di certificato con questa grafica: https://…/certificato.png. Titolo Certificato di partecipazione, testo "{nome} ha partecipato[ a {assunto}]". Mostrami com'è venuto.

**Strumenti, in ordine:**

| # | Strumento | Cosa fa |
|---|---|---|
| 1 | `create_certificate_template` | `type: IMAGE`, `image_url` con la grafica, titolo e testo. Senza `layout`, usa le caselle predefinite: il nome al centro, la data in basso a sinistra, il QR in basso a destra |
| 2 | (nella conversazione) | L'anteprima compare come immagine, con un nome di prova lungo |
| 3 | `update_certificate_template` | Se serve, regola le caselle: *"alza un po' il nome e rimpicciolisci la data"* |
| 4 | `activate_certificate_template` | Quando è a posto, attiva il modello |

**Risultato:** il modello attivo nello spazio Certificati, pronto per il rilascio.

**Note:** la grafica deve avere almeno 2.000 px di larghezza, in PNG o JPEG; il certificato esce in A4 orizzontale. Vedi [Certificati](/espacos/certificados).

## 13. Creare una call for papers

**Per chi:** associazione, community tech o azienda che costruisce il programma di un evento con proposte dall'esterno: una call for papers.

**Richiesta:**

> Apri la call for papers del Congresso 2027: dal vivo a San Paolo, il 12 e 13 marzo, dalle 9 alle 18. Track Prodotto, Dati e Carriera, ciascuno con uno scopo breve. Proposte entro il 30/11, talk da 20 o 40 minuti e workshop da 90. Alloggio e pasti a carico nostro; viaggio a carico del relatore; nessun compenso. Valutazione da parte di un comitato, alla cieca. Metti Ana e Bruno come revisori di Dati. Lasciala in bozza e mostramela prima di pubblicarla.

**Strumenti, in ordine:**

| # | Strumento | Cosa fa |
|---|---|---|
| 1 | `list_spaces` | Cerca uno spazio del modulo `call4papers` |
| 2 | `create_space` | Solo se non c'è: uno spazio Call for papers (`module: call4papers`) nella sezione che indichi |
| 3 | `create_call_for_papers` | La call in bozza, con il bando, `type: advanced`, `evaluation_mode: committee`, `blind_review: true`, le date, i formati e le durate, i costi, i 3 track (`tracks`) e i 2 giorni (`event_dates`) |
| 4 | `list_members` | Trova Ana e Bruno |
| 5 | `invite_track_reviewer` ×2 | Nel track Dati. Ricevono un'e-mail |
| 6 | (nella conversazione) | Mostra la call e aspetta il tuo ok |
| 7 | `update_call_status` | Con `action: publish`, dopo il tuo ok |

**Risultato:** la call pubblicata nello spazio Call for papers, con i tre track, i due giorni e il comitato di Dati. Le proposte cominciano ad arrivare; le segui con `get_review_progress` e decidi con `decide_proposal`.

**Note:** la call nasce in bozza e non compare ai membri finché non viene pubblicata. Chi apre la call ne diventa titolare. Aprire una call dipende da **chi può aprire una call** nello spazio, quindi anche un membro può usare questa ricetta, se lo spazio lo consente. In Claude, la ricetta **Aprire una call for papers** del menu compone la stessa richiesta a partire dall'evento, dalla scadenza e dai track. Vedi [Call for papers](/mcp/ferramentas-chamada) e [Call for papers (lo spazio)](/espacos/chamada-de-trabalhos).

## 14. Chi ha fatto cosa

**Per chi:** proprietario o amministratore che vuole capire cosa è successo.

**Richieste:**

| Richiesta | Strumenti | Cosa torna |
|---|---|---|
| *"Chi ha annullato l'abbonamento di Ana?"* | `list_activity_logs` con `source: team` | L'azione, chi l'ha fatta, quando, e il prima e dopo |
| *"Cosa ha fatto l'assistente ieri?"* | `list_activity_logs` con `source: assistant` e il giorno in `from` e `to` | Ogni chiamata, con l'esito |
| *"Cosa ha fatto Ana questa settimana?"* | `list_activity_logs` con `profile: ana@memberfy.net`, poi `member_activity` | La linea del tempo di Ana e il riepilogo con punti e livello |
| *"Una tua chiamata è fallita. Il tuo elenco è aggiornato?"* | `get_connection_diagnostics` | Se l'elenco è aggiornato; se no, apri una nuova conversazione o ricollega |

**Note:** gli argomenti delle chiamate dell'assistente arrivano riassunti, senza codici né immagini. Vedi [`list_activity_logs`](/mcp/ferramentas-membros#list-activity-logs).

## Consigli per chiedere bene

- **Di' cosa esiste già.** "Nello spazio corsi che esiste già" evita che l'assistente ne crei un altro.
- **Chiedi la bozza.** Rivedi nel pannello e poi chiedi di pubblicare.
- **Chiedi di mostrare prima.** Nei post e nelle risposte, "mostrami prima di pubblicare" fa fermare l'assistente perché tu approvi.
- **Date con fuso orario.** "15/11 alle 19, ora di Brasília" evita sorprese.
- **Una community per conversazione.** Se hai due collegamenti, attiva solo quello giusto.

## Correlati

- [Strumenti](/mcp/ferramentas)
- [Denaro e conferma](/mcp/dinheiro-e-confirmacao)
- [Problemi comuni](/mcp/problemas-comuns)