Strumenti · Call for papers
I 40 strumenti MCP della call for papers, dall'inizio alla fine: le regole dello spazio, aprire e modificare una call con track, giorni e banner, pubblicare, responsabili e revisori, invitare relatori, proposte, valutazioni e punteggi, decisione, controproposta, conferma nel programma, votazione e il lato di chi propone.
L'intera call for papers dalla conversazione: aprire la call con il bando, i track e i giorni dell'evento, pubblicarla, formare il comitato, seguire le valutazioni, decidere, negoziare le condizioni con il relatore e confermare nel programma. Anche chi propone usa l'assistente: inviare e modificare la proposta, rispondere a una controproposta, votare.
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.
Chi usa cosa
I 40 strumenti compaiono a tutti i ruoli, membro compreso: il responsabile di una call può essere un membro qualsiasi, e lo stesso vale per chi propone, valuta o vota. Memberfy controlla ogni call con la regola del modulo stesso, come sullo schermo:
| Chi | Cosa può fare |
|---|---|
| Staff (proprietario, Admin e moderatore) o responsabile della call | Modificare la call, i track, i giorni e i responsabili; formare il comitato; vedere l'avanzamento; decidere, negoziare e confermare |
| Chi può aprire una call nello spazio | Aprire una nuova call. La regola è dello spazio: solo i proprietari, lo staff o qualsiasi membro (get_call_space_settings) |
| Revisore del track (che ha accettato l'invito) | La coda di revisione e il punteggio di ogni proposta del track |
| Chi la call lascia votare | La scheda di voto e il voto, nella finestra di votazione |
| Qualsiasi membro | Proporre in una call aperta, modificare e ritirare la propria proposta, rispondere a una controproposta |
Quando il ruolo non lo consente, l'assistente riceve il rifiuto di Memberfy e lo spiega.
In sintesi
Lo spazio e le call
| Strumento | Cosa fa | Chi | Tipo |
|---|---|---|---|
list_calls_for_papers | Le call di uno spazio, con lo stato | Qualsiasi | Solo lettura |
get_call_space_settings | Come funziona lo spazio: una o più call, chi apre | Qualsiasi | Solo lettura |
update_call_space_settings | Cambia la modalità dello spazio e chi può aprire una call | Admin | Modifica |
get_call_for_papers | Una call con date, track, giorni, responsabili e ciò che puoi fare | Qualsiasi | Solo lettura |
create_call_for_papers | Apre una call in bozza, con track, giorni e banner | Chi può aprire | Modifica |
update_call_for_papers | Modifica testo, date, formati, costi, compenso e immagini | Staff o responsabile | Modifica |
update_call_status | Pubblica, riporta in bozza, chiude o riapre | Staff o responsabile | Modifica |
delete_call_for_papers | Elimina la call, con track e proposte | Staff o responsabile | Chiede conferma |
Track e giorni dell'evento
| Strumento | Cosa fa | Chi | Tipo |
|---|---|---|---|
add_call_track | Aggiunge un track | Staff o responsabile | Modifica |
update_call_track | Rinomina un track o ne cambia lo scopo | Staff o responsabile | Modifica |
delete_call_track | Toglie un track | Staff o responsabile | Chiede conferma |
add_call_event_date | Aggiunge un giorno all'evento | Staff o responsabile | Modifica |
update_call_event_date | Cambia l'orario di un giorno | Staff o responsabile | Modifica |
delete_call_event_date | Toglie un giorno dall'evento | Staff o responsabile | Chiede conferma |
Responsabili, revisori e relatori
| Strumento | Cosa fa | Chi | Tipo |
|---|---|---|---|
add_call_owner | Invita qualcuno a diventare responsabile della call | Staff o responsabile | Modifica |
remove_call_owner | Toglie un responsabile | Staff o responsabile | Chiede conferma |
list_track_reviewers | I revisori di un track | Staff o responsabile | Solo lettura |
invite_track_reviewer | Mette qualcuno come revisore di un track | Staff o responsabile | Modifica |
remove_track_reviewer | Toglie un revisore | Staff o responsabile | Chiede conferma |
list_my_call_invitations | I tuoi inviti in sospeso, come responsabile o revisore | Qualsiasi | Solo lettura |
respond_to_call_invitation | Accetta o rifiuta un tuo invito | Qualsiasi | Modifica |
list_speakers | Chi ha già proposto nella community | Staff o responsabile | Solo lettura |
invite_speaker | Invita qualcuno a proporre | Staff o responsabile | Modifica |
Valutazione, decisione e programma
| Strumento | Cosa fa | Chi | Tipo |
|---|---|---|---|
list_proposals | Le proposte, con stato, track e punteggi | Secondo il ruolo nella call | Solo lettura |
get_proposal | Una proposta, con le valutazioni e la negoziazione | Responsabili, revisori del track e chi ha proposto | Solo lettura |
list_my_reviews | La tua coda di revisione | Revisore | Solo lettura |
review_proposal | Dà un punteggio da 1 a 5 a una proposta | Revisore del track | Modifica |
get_review_progress | L'avanzamento della valutazione, rispetto al minimo | Staff o responsabile | Solo lettura |
get_proposal_reviews | I punteggi di una proposta e il consenso | Responsabili; revisori dopo aver valutato | Solo lettura |
decide_proposal | Accetta o rifiuta una proposta | Staff o responsabile | Modifica |
negotiate_proposal | Controproposta, ritirare, accettare o chiudere la negoziazione | Staff o responsabile | Modifica |
confirm_proposal | Conferma nel programma la proposta accettata | Staff o responsabile | Modifica |
Votazione
| Strumento | Cosa fa | Chi | Tipo |
|---|---|---|---|
list_votable_proposals | La scheda di voto: cosa puoi votare e il tuo voto | Chi può votare | Solo lettura |
vote_on_proposal | Vota da 1 a 5, o toglie il voto | Chi può votare | Modifica |
get_vote_results | Il risultato, fin dove la call lo mostra | Secondo la call | Solo lettura |
Chi propone
| Strumento | Cosa fa | Chi | Tipo |
|---|---|---|---|
list_my_proposals | Le tue proposte, con lo stato | Qualsiasi | Solo lettura |
submit_proposal | Invia una proposta a una call aperta | Qualsiasi membro | Modifica |
update_proposal | Modifica la proposta in bozza e la invia | Chi ha proposto | Modifica |
withdraw_proposal | Ritira la proposta dalla call | Chi ha proposto | Chiede conferma |
respond_to_counter_offer | Accetta la controproposta o risponde con un'altra | Chi ha proposto | Modifica |
Gli id e i valori
- Call (
call) e spazio (space): l'id o il link copiato dall'app. Anche il link di una proposta (?proposal=) vale come call. - Proposta (
proposal): l'id o il link con?proposal=. - Track, giorno dell'evento, responsabile e revisore (
track_id,date_id,owner_id,reviewer_id): arrivano daget_call_for_papers. L'owner_idè l'id del collegamento inowner_links, non l'id della persona. - Persona (
profile_id): dalist_memberso dalist_speakers. - Date e orari: nel fuso orario della community. Data e ora come
2026-11-30T23:59; solo la data come2026-11-30; solo l'ora come19:00. - Formati:
talk,lightning_talk,keynote,workshop,tutorial,masterclass,panel,roundtable,case_study,demo,postereother. - Stati della call:
draft(bozza),open(aperta),reviewing(in valutazione),deciding(in decisione),closed(chiusa) earchived(archiviata). - Costi (viaggio aereo, trasporto locale, parcheggio, alloggio, pasti):
none(nessuno),organizer(l'organizzazione) ospeaker(il relatore).
list_calls_for_papers
Solo lettura
Elenca call for papers. Le call di uno spazio call, con lo stato. Ruolo minimo: qualsiasi; la bozza compare solo a chi la gestisce.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
space | id o link | Sì | Lo spazio call |
status | uno degli stati | No | Filtra per stato |
Chiedi così: "Quali call sono aperte?"
get_call_space_settings
Solo lettura
Vedi regole dello spazio call. Se lo spazio è Una call o Più call, chi può aprire una call e se l'apertura richiede approvazione. Ruolo minimo: qualsiasi.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
space | id o link | Sì | Lo spazio call |
Chiedi così: "Un membro può aprire una call nello spazio Talk?"
update_call_space_settings
Modifica
Cambia regole dello spazio call. Cambia la modalità dello spazio e chi può aprire una call. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
space | id o link | Sì | |
mode | single, multi | No | Una call o più call |
who_can_open_call | owners, staff, members | No | Proprietario e Admin; anche i moderatori; oppure qualsiasi membro |
require_approval_to_open | sì o no | No | Una nuova call attende l'approvazione |
Chiedi così: "Lascia che i moderatori aprano call nello spazio Talk."
Note: cambia subito chi può fare cosa. Vedi Lo spazio: una call o più call.
get_call_for_papers
Solo lettura
Vedi call for papers. Tutto ciò che mostra la pagina della call: stato, date, formati, costi e compenso, i track (con i revisori), i giorni dell'evento e i responsabili, più ciò che puoi fare. Ruolo minimo: qualsiasi; la bozza solo per chi la gestisce.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
call | id o link | Sì | Accetta anche il link di una proposta |
Restituisce: la call e, per chi può modificarla, i collegamenti dei responsabili (owner_links), con gli id che chiede remove_call_owner.
Chiedi così: "Mostrami la call del Congresso 2027: quali track ci sono e chi valuta ciascuno?"
create_call_for_papers
Modifica
Apri call for papers. Apre una call in uno spazio call, in bozza. Chi la crea ne diventa responsabile. Ruolo: chi la regola dello spazio lascia aprire una call.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
space | id o link | Sì | Lo spazio call (list_spaces con il modulo call4papers) |
title | testo, da 3 a 255 | Sì | |
slug | testo | No | L'indirizzo; senza, viene dal titolo |
description | Markdown, fino a 20.000 | No | Il bando, in Markdown (o HTML) |
summary | testo, fino a 1.000 | No | Una o due righe per le card e il feed |
type | simple, advanced | No | Semplice o avanzata. Vedi Il tipo di call |
modality | in_person, online, hybrid | No | Di persona, online o ibrida |
submission_opens_at, submission_closes_at | data e ora | No | Il periodo per proporre |
review_opens_at, review_closes_at, results_announced_at | data e ora | No | La valutazione e l'annuncio |
voting_opens_at, voting_closes_at | data e ora | No | La finestra di votazione |
evaluation_mode | none, committee, community | No | Senza valutazione, comitato per track o voto della community |
blind_review | sì o no | No | Il revisore non vede chi ha proposto |
min_reviews_per_submission | numero, fino a 20 | No | Valutazioni minime per proposta |
max_submissions_per_speaker | numero, fino a 100 | No | Proposte per persona |
vote_visibility | hidden, counts, full | No | Cosa mostra il risultato della votazione |
who_can_vote | owners, staff, members | No | |
allow_counter_offer, counter_offer_timeout_days | sì o no; giorni | No | Solo nell'avanzata: controproposta e il termine per rispondere |
allowed_formats | elenco di formati | No | |
allowed_durations | elenco di minuti | No | Per esempio [20, 40] |
speaker_benefits | elenco di testi | No | Per esempio Biglietto, Cena con i relatori |
air_travel_cost, ground_transport_cost, parking_cost, accommodation_cost, meal_cost | none, organizer, speaker | No | Chi paga ciascun costo |
speaker_fee_mode, speaker_fee_amount | none, fixed, speaker_defined; importo | No | Il compenso: nessuno, fisso o indicato da chi propone |
tracks | elenco di name, purpose | No | I track, in una volta (fino a 30). Lo scopo è il metro dei revisori |
event_dates | elenco di date, start_time, end_time | No | I giorni dell'evento (fino a 60) |
image_url o image_base64 | link o file | No | Il banner (16:9) |
featured_image_url | link | No | L'immagine quadrata (1:1) |
idempotency_key | testo | No | Ripetere con la stessa chiave non crea di nuovo |
Restituisce: la call creata. Un'immagine non valida non impedisce la creazione; il motivo arriva in warnings.
Chiedi così: "Apri la call del Congresso 2027, dal vivo a San Paolo il 12 e 13 marzo, con i track Prodotto, Dati e Carriera. Proposte entro il 30/11. Paghiamo alloggio e pasti; il viaggio è a carico del relatore. Lasciala in bozza e mostramela."
Note: la call nasce in bozza; pubblicala con update_call_status. Dopo la creazione, la risposta suggerisce cosa manca: track, revisori, pubblicazione. Il compenso viene registrato nell'accordo; il pagamento avviene fuori dalla piattaforma.
update_call_for_papers
Modifica
Modifica call for papers. Gli stessi campi di create_call_for_papers, tranne track e giorni, che hanno strumenti propri. Cambia solo ciò che viene inviato. Ruolo: staff o responsabile della call.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
call | id o link | Sì | |
| i campi della call | No | Titolo, testo, date, tipo, formati, durate, costi, compenso, votazione, valutazione, banner e immagine quadrata |
Chiedi così: "Estendi la scadenza delle proposte del Congresso 2027 al 15/12."
Note: una call che ha già punteggi o una negoziazione non torna da avanzata a semplice.
update_call_status
Modifica
Pubblica, chiudi o riapri call. Cambia lo stato di una call. Ruolo: staff o responsabile della call.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
call | id o link | Sì | |
action | publish, unpublish, close, reopen, set_status | Sì | Pubblicare, tornare in bozza, chiudere, riaprire o impostare uno stato specifico |
status | uno degli stati | Con set_status |
Chiedi così: "Pubblica la call del Congresso 2027." · "Chiudi la call: la scadenza è passata."
delete_call_for_papers
Chiede conferma
Elimina call for papers. Elimina la call, con i track e le proposte. Ruolo: staff o responsabile della call.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
call | id o link | Sì |
Restituisce: alla prima chiamata, il riepilogo (titolo, stato, quante proposte) e il codice di conferma.
add_call_track
Modifica
Aggiungi track alla call. Ruolo: staff o responsabile della call.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
call | id o link | Sì | |
name | testo, fino a 255 | Sì | |
purpose | testo, fino a 5.000 | Sì | Cosa cerca il track e cosa non cerca: il metro dei revisori |
Chiedi così: "Aggiungi il track Dati, per casi reali di analisi e ingegneria dei dati, niente tutorial sugli strumenti."
update_call_track
Modifica
Modifica track. Rinomina un track o ne cambia lo scopo. Ruolo: staff o responsabile della call.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
track_id | id | Sì | Da get_call_for_papers |
name, purpose | testo | No |
delete_call_track
Chiede conferma
Elimina track. Ruolo: staff o responsabile della call.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
track_id | id | Sì | Da get_call_for_papers |
add_call_event_date
Modifica
Aggiungi giorno dell'evento. Ruolo: staff o responsabile della call.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
call | id o link | Sì | |
date | data (2027-03-12) | Sì | |
start_time, end_time | ora (09:00) | Sì | Nel fuso orario della community |
update_call_event_date
Modifica
Cambia orario del giorno dell'evento. Ruolo: staff o responsabile della call.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
date_id | id | Sì | Da get_call_for_papers |
start_time, end_time | ora | No | Almeno uno dei due |
delete_call_event_date
Chiede conferma
Rimuovi giorno dell'evento. Ruolo: staff o responsabile della call.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
date_id | id | Sì | Da get_call_for_papers |
add_call_owner
Modifica
Invita co-proprietario della call. Invita un membro a condividere la call con te: il responsabile gestisce la call, i track, i revisori e le decisioni. La persona accetta con respond_to_call_invitation. Ruolo: staff o responsabile della call.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
call | id o link | Sì | |
profile_id | id | Sì | Da list_members |
Note: dà potere sulla call, e la persona riceve l'invito per e-mail.
remove_call_owner
Chiede conferma
Rimuovi proprietario della call. Ruolo: staff o responsabile della call.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
owner_id | id | Sì | L'id in owner_links di get_call_for_papers, non l'id della persona |
list_track_reviewers
Solo lettura
Elenca revisori del track. I revisori di un track e se ciascuno ha accettato. Ruolo: staff o responsabile della call.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
track_id | id | Sì | Da get_call_for_papers |
invite_track_reviewer
Modifica
Aggiungi revisore del track. Mette un membro come revisore di un track: assegna un punteggio a tutte le proposte di quel track. Ruolo: staff o responsabile della call.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
track_id | id | Sì | Da get_call_for_papers |
profile_id | id | Sì | Da list_members |
Chiedi così: "Metti Ana e Bruno come revisori del track Dati."
Note: la persona lo viene a sapere per e-mail, alla prima chiamata.
remove_track_reviewer
Chiede conferma
Rimuovi revisore del track. Ruolo: staff o responsabile della call.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
reviewer_id | id | Sì | L'id in trackReviewers di get_call_for_papers, oppure da list_track_reviewers |
list_my_call_invitations
Solo lettura
I miei inviti nelle call. I tuoi inviti in sospeso per diventare responsabile di una call o revisore di un track. Ruolo minimo: qualsiasi.
Parametri: nessuno.
Chiedi così: "Ho qualche invito per valutare proposte?"
respond_to_call_invitation
Modifica
Rispondi all'invito della call. Ruolo minimo: qualsiasi, sui propri inviti.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
kind | owner, reviewer | Sì | Invito come responsabile o come revisore |
invitation_id | id | Sì | Da list_my_call_invitations |
answer | accept, decline | Sì |
Note: accettare un invito come revisore porta alla tua coda di revisione (list_my_reviews).
list_speakers
Solo lettura
Elenca relatori. Tutti quelli che hanno già proposto nella community, raggruppati per persona, per invitarli di nuovo. Ruolo: staff o responsabile di una call.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
space | id o link | No | Solo chi ha proposto in uno spazio call |
invite_speaker
Modifica
Invita relatore a proporre. Invita un membro a inviare una proposta a una call, con un messaggio facoltativo. Ruolo: staff o responsabile della call.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
call | id o link | Sì | |
profile_id | id | Sì | Da list_speakers o list_members |
message | testo, fino a 2.000 | No | Va nell'e-mail |
Chiedi così: "Invita chi ha parlato l'anno scorso a proporre di nuovo per il Congresso 2027."
Note: invia un'e-mail alla prima chiamata.
list_proposals
Solo lettura
Elenca le proposte di una call. Le proposte, con stato, track e punteggi. Ruolo: ciò che compare dipende dal tuo ruolo nella call: i responsabili le vedono tutte, il revisore quelle del suo track, chi ha proposto le proprie.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
call | id o link | Sì |
Chiedi così: "Quali proposte del track Prodotto hanno i punteggi migliori?"
Note: con proposte in attesa di decisione, la risposta suggerisce di decidere ciascuna.
get_proposal
Solo lettura
Vedi proposta. Il testo, il track, lo stato, le valutazioni che puoi vedere e i round di negoziazione. Ruolo: i responsabili della call, i revisori del track e chi ha proposto.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
proposal | id o link (con ?proposal=) | Sì |
list_my_reviews
Solo lettura
La mia coda di revisione. Le proposte dei track che valuti, con il tuo punteggio quando l'hai già dato. Ruolo: chi valuta.
Parametri: nessuno.
Chiedi così: "Cosa mi resta da valutare?"
review_proposal
Modifica
Valuta proposta. Dà il punteggio a una proposta di un track che valuti. Ruolo: revisore del track che ha accettato l'invito.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
proposal | id o link | Sì | |
score | da 1 a 5 | Sì | |
recommendation | accept, reject | No | |
internal_notes | testo | No | La vedono solo i revisori e i responsabili; chi ha proposto, mai |
comments_to_speaker | testo | No | Il riscontro per chi ha proposto |
submit | sì o no | No | Predefinito sì. Con no, resta in bozza da cambiare dopo; una volta inviata, la valutazione è bloccata |
Chiedi così: "Dai 4 alla proposta di Ana, consigliando di accettarla: il tema è ottimo, ma la scaletta ha bisogno di un caso reale."
Note: solo durante il periodo di valutazione, e mai sulla propria proposta.
get_review_progress
Solo lettura
Vedi avanzamento della revisione. Quante valutazioni hanno ogni proposta e ogni revisore, rispetto al minimo della call. Ruolo: staff o responsabile della call.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
call | id o link | Sì |
Chiedi così: "Chi del comitato non ha ancora valutato?"
get_proposal_reviews
Solo lettura
Vedi revisioni della proposta. Ogni punteggio e raccomandazione, e il consenso. Ruolo: i responsabili della call; il revisore, dopo aver inviato la sua.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
proposal | id o link | Sì |
decide_proposal
Modifica
Accetta o rifiuta proposta. Con un messaggio facoltativo per chi ha proposto. Ruolo: staff o responsabile della call.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
proposal | id o link (con ?proposal=) | Sì | |
decision | accept, reject | Sì | |
message | testo | No | Va nell'e-mail, come il messaggio di chi organizza |
Chiedi così: "Accetta la proposta di Ana e ringraziala per l'invio."
Note: la persona riceve un'e-mail alla prima chiamata, per questo l'assistente conferma prima con te la decisione e il messaggio. Dopo l'accettazione, la risposta suggerisce di confermare nel programma. Vedi Email della call for papers.
negotiate_proposal
Modifica
Negozia proposta. Il lato di chi organizza in una negoziazione (call avanzata, con la controproposta attiva). Ruolo: staff o responsabile della call.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
proposal | id o link | Sì | |
action | counter_offer, retract, accept, decline | Sì | Fare una controproposta, ritirare quella aperta, accettare la controproposta del relatore o chiudere, rifiutando la proposta |
terms | format, duration_minutes, track_id, scheduled_at, delivery_mode, i costi, fee_amount | No | Solo le condizioni che cambiano |
message | testo | No |
Chiedi così: "Proponi ad Ana di fare il workshop in 90 minuti invece di 3 ore, con l'alloggio a carico nostro."
Note: ogni passo manda un'e-mail a chi ha proposto, alla prima chiamata.
confirm_proposal
Modifica
Conferma proposta nel programma. Il passo finale di una proposta accettata, con la data e l'ora se ci sono già. Ruolo: staff o responsabile della call.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
proposal | id o link | Sì | |
scheduled_at | data e ora | No | Nel fuso orario della community |
list_votable_proposals
Solo lettura
Vedi scheda di voto. Le proposte che puoi votare in una call con voto della community, e il tuo voto attuale. Ruolo: chi la call lascia votare.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
call | id o link | Sì |
vote_on_proposal
Modifica
Vota proposta. Da 1 a 5, nella finestra di votazione, oppure toglie il voto. Ruolo: chi la call lascia votare.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
proposal | id o link | Sì | |
value | da 1 a 5 | No | Il voto |
remove | sì o no | No | Toglie il tuo voto |
get_vote_results
Solo lettura
Vedi risultati del voto. Fin dove la visibilità dei voti della call permette di vedere. Ruolo: secondo la call.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
call | id o link | Sì |
list_my_proposals
Solo lettura
Le mie proposte. Le tue proposte nella community, o in una call, con lo stato. Ruolo minimo: qualsiasi.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
call | id o link | No | Solo quelle di questa call |
submit_proposal
Modifica
Invia proposta. Propone una sessione a una call aperta. La proposta esce con il nome di chi ha collegato l'assistente. Ruolo: qualsiasi membro, finché la call è aperta.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
call | id o link | Sì | |
title | testo, da 3 a 255 | Sì | |
description | Markdown, fino a 20.000 | Sì | La proposta, in Markdown |
format | uno dei formati | Sì | |
duration_minutes | minuti | Sì | |
level | beginner, intermediate, advanced | No | |
track | id o nome del track | Quando la call ha dei track | |
delivery_mode | in_person, online, either | Nella call ibrida | |
format_other, language, target_audience, prerequisites, resources_needed | testo | No | |
pitch_video_url, speaker_video_url | link | No | |
requested_fee_amount | importo | No | Quando la call lascia che sia chi propone a indicare il compenso |
send | sì o no | No | Predefinito sì. Con no, resta in bozza da inviare dopo |
idempotency_key | testo | No |
Chiedi così: "Invia al Congresso 2027 il mio talk 'Dati senza foglio di calcolo', 40 minuti, livello intermedio, nel track Dati."
update_proposal
Modifica
Modifica la mia proposta. Cambia la proposta finché è in bozza, e la invia con send. Cambia solo ciò che viene inviato. Ruolo: chi ha proposto.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
proposal | id o link | Sì | |
| i campi della proposta | No | Gli stessi di submit_proposal | |
send | sì o no | No | Invia la proposta |
withdraw_proposal
Chiede conferma
Ritira la mia proposta. Con un messaggio facoltativo per chi organizza. Ruolo: chi ha proposto.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
proposal | id o link | Sì | |
message | testo, fino a 2.000 | No |
Note: non si può annullare, per questo chiede il tuo sì.
respond_to_counter_offer
Modifica
Rispondi alla controproposta. La risposta di chi ha proposto alla controproposta dell'organizzazione: accettare (la proposta viene accettata a quelle condizioni) oppure rispondere con le proprie condizioni e un messaggio. Ruolo: chi ha proposto.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
proposal | id o link | Sì | |
answer | accept, counter | Sì | |
terms | le stesse condizioni di negotiate_proposal | No | Con counter |
message | testo | No |
Note: impegna chi ha proposto e avvisa l'organizzazione, alla prima chiamata.