Collegare Moodle al CRM: cosa passa, ogni quanto e con quali strumenti.
Come collegare Moodle al CRM con i servizi web, un token e un plugin: quali dati passano, ogni quanto aggiornarli e un esempio pratico con FluentCRM.
In breve
- Decidi quali dati servono al CRM: iscrizioni, completamenti, attestati, campi del profilo.
- Attiva i servizi web di Moodle e il protocollo REST.
- Crea un servizio con le sole funzioni che servono, un utente per il collegamento e un token.
- Se le funzioni di Moodle non bastano, aggiungi un plugin con le sue.
- Scegli ogni quanto aggiornare: ogni mattina, una volta al mese o subito, a ogni evento.
Per collegare Moodle al CRM si usano i servizi web di Moodle: un programma esterno, con un token, legge iscrizioni, completamenti e campi del profilo e li scrive nei contatti del CRM. Se servono dati che Moodle non dà, li aggiunge un plugin. Poi decidi ogni quanto: un controllo ogni mattina, una misura al mese, oppure subito, quando succede qualcosa.
Perché collegare Moodle al CRM
Moodle sa chi si è iscritto, a che punto è e chi ha finito. Il CRM è il programma dove tieni i contatti e da cui partono le email. Se non si parlano, qualcuno esporta un file da Moodle e lo carica nel CRM, a mano, e i dati invecchiano subito.
Con il collegamento il CRM riceve da solo lo stato di ogni corsista. Così il promemoria arriva a chi non ha ancora aperto il corso, e non a chi l'ha già finito.
- Promemoria: chi non ha mai aperto il corso, chi ha un corso che sta per chiudere.
- Recupero: chi si è fermato a metà e cosa gli manca, come spieghiamo nella guida sui corsisti che non finiscono il corso.
- Dopo l'attestato: il corso successivo, solo a chi ha finito.
- Misura: quante iscrizioni ha portato una campagna email.
Quali dati passano da Moodle al CRM
Non serve copiare tutto. Parti dalle email che vuoi mandare e chiediti quali dati servono per sceglierne i destinatari. Di solito bastano questi.
| Dato | Da dove viene in Moodle | A cosa serve nel CRM |
|---|---|---|
| Iscrizioni | Gli iscritti a ogni corso | Sapere chi è iscritto a cosa |
| Completamento delle attività | Lo stato di ogni attività per ogni utente | Capire a che punto è e cosa gli manca |
| Completamento del corso | Lo stato del corso, se il completamento è impostato | Separare chi ha finito da chi no |
| Attestati | Il plugin che crea l'attestato | Proporre il passo successivo solo a chi l'ha preso |
| Campi del profilo | Nome, email e i campi personalizzati, come la professione | Scegliere i destinatari e personalizzare il testo |
Come si attivano i servizi web di Moodle
I servizi web sono l'ingresso che Moodle apre ai programmi esterni. Si attivano dall'amministrazione del sito, in questo ordine. I nomi delle voci sono quelli della documentazione di Moodle 4.5, in inglese: nella piattaforma in italiano li trovi tradotti.
1. Attiva i servizi web
In Site administration, alla voce Advanced features, spunta «Enable web services» e salva.
2. Attiva il protocollo
In Server > Web services > Manage protocols attiva REST.
3. Crea un servizio
In Server > Web services aggiungi un servizio tuo («Add new custom service»), dagli un nome e attivalo. Se vuoi, limitalo agli utenti autorizzati.
4. Aggiungi le funzioni
Con «Add functions» scegli solo quelle che servono al collegamento, niente di più.
5. Prepara l'utente
Usa un utente solo per il collegamento, con i permessi che chiedono il protocollo e le funzioni scelte, e aggiungilo agli utenti autorizzati del servizio.
6. Crea il token
In Server > Web services > Manage tokens aggiungi un token per quell'utente e quel servizio. Puoi limitarlo a un indirizzo IP e dargli una scadenza.
Quando serve un plugin
Le funzioni di Moodle coprono i dati di base. Quando servono dati già calcolati, per esempio «chi si è iscritto da tre giorni e non ha mai aperto il corso», conviene un plugin locale che aggiunge le sue funzioni al servizio. Il CRM fa una domanda sola e riceve la risposta pronta.
Un plugin serve anche nell'altro verso. Moodle registra eventi come un'iscrizione o un corso completato: un plugin può ascoltarli e avvisare subito il CRM.
Per un provider ECM abbiamo fatto così. Piattaforma e CRM stanno su due server diversi, e dal server del CRM il database di Moodle non si raggiunge. Il collegamento passa dai servizi web di Moodle, con un token, e da un nostro plugin che aggiunge le funzioni che mancano. Nessun file da esportare a mano.
Ogni quanto aggiornare i dati
Non tutto deve essere in tempo reale. Scegli la frequenza in base a quello che fai con il dato. Per esempio, con un provider ECM lavoriamo così: compiti ogni mattina, una misura al mese e flussi che partono a ogni evento.
| Quando | Cosa succede | Per esempio |
|---|---|---|
| Ogni mattina | Un compito pianificato chiede a Moodle i dati del giorno | Chi deve ricevere un promemoria: le email partono poco dopo |
| Prima di ogni invio | Il programma rilegge il corso su Moodle | Se il corso è chiuso l'invio si ferma, e chi l'ha già comprato resta fuori |
| Una volta al mese | Una misura raccoglie i numeri del mese | Le iscrizioni portate dalle campagne, per il resoconto |
| Subito, a ogni evento | Un evento fa partire il flusso | Una persona compra un corso: viene iscritta su Moodle e il CRM lo sa subito |
L'esempio con FluentCRM
FluentCRM è un CRM che funziona dentro WordPress. Ha le sue API REST, all'indirizzo /wp-json/fluent-crm/v2/ del sito, e si autentica con le password per le applicazioni di WordPress.
La sua documentazione chiede un account dedicato al collegamento, che non sia amministratore, con i soli permessi che servono e sempre in https.
In pratica il programma legge da Moodle lo stato dei corsisti e, per ognuno, crea o aggiorna il contatto in FluentCRM. Poi le email partono da FluentCRM, a chi ha l'etichetta giusta.
- Contatto: si crea, o si aggiorna se c'è già, partendo dall'email.
- Etichette: per esempio «mai partito», «fermo a metà», «ha finito».
- Campi personalizzati: il corso, l'ultima attività completata, il link da cui ripartire.
- Iscrizione alle comunicazioni: scrivi solo a chi è iscritto; chi si è disiscritto resta fuori.
Gli errori da evitare
Quasi tutti nascono da un collegamento fatto in fretta, senza pensare a chi riceve le email.
- Usare un account amministratore per il collegamento.
- Dare al servizio più funzioni di quelle che servono.
- Scrivere a chi ha già finito, perché i dati sono vecchi.
- Mandare due volte la stessa email quando un compito riparte.
- Dimenticare i consensi: un'email che propone un corso nuovo è una promozione, non un avviso sul corso.
Fonti
- Documentazione di Moodle 4.5: Using web services (in inglese, consultata l'8 novembre 2026)
- Documentazione di Moodle 4.5: How to create and enable a web service (in inglese, consultata l'8 novembre 2026)
- Documentazione per sviluppatori di Moodle: Web service API functions (in inglese, pagina archiviata, consultata l'8 novembre 2026)
- Documentazione per sviluppatori di Moodle: Events API (in inglese, consultata l'8 novembre 2026)
- Documentazione per sviluppatori di FluentCRM: autenticazione delle REST API (in inglese, consultata l'8 novembre 2026)
- FluentCRM REST API: i contatti (in inglese, consultata l'8 novembre 2026)
Se non hai tempo, lo facciamo noi
Colleghiamo Moodle al tuo CRM con i servizi web di Moodle e, quando serve, con un nostro plugin. Lo abbiamo già fatto per un provider ECM, con piattaforma e CRM su due server diversi. Prima proviamo tutto su una copia della piattaforma, poi lo accendiamo.
- Servizi web e token, con le sole funzioni che servono
- Un plugin per i dati che Moodle non dà
- Compiti al mattino, misura mensile, flussi a ogni evento
Domande frequenti su questa guida
Serve un plugin per collegare Moodle al CRM?
Non sempre. Per iscrizioni, completamenti e dati del profilo bastano le funzioni dei servizi web di Moodle. Il plugin serve per i dati già calcolati, per gli attestati di alcuni plugin e per avvisare il CRM subito, a ogni evento.
Moodle può avvisare il CRM da solo?
Moodle registra gli eventi, come un'iscrizione o un corso completato. Per mandarli al CRM nel momento in cui succedono serve un plugin che li ascolti. In alternativa, il CRM chiede i dati a intervalli regolari.
Ogni quanto conviene aggiornare i dati?
Per i promemoria basta una volta al giorno, al mattino. Per le misure, una volta al mese. Il tempo reale serve solo quando qualcosa deve succedere subito, come l'iscrizione dopo un acquisto.
Quanto costa un collegamento tra Moodle e CRM?
Da noi parte da 1.500 € in una direzione, per esempio iscrizioni e completamenti verso FluentCRM, e da 3.500 € in due direzioni o con un gestionale. IVA non applicata. Di solito servono 2–3 settimane, oppure 4–6 per le due direzioni. Trovi tutti i prezzi di partenza per Moodle. Se il problema sono i corsisti fermi, guarda anche Recupero iscritti, il nostro prodotto per Moodle e FluentCRM.
Altre guide
- «corsisti che abbandonano il corso moodle» Corsisti che non finiscono il corso: come trovarli e riportarli su Moodle Formazione e Moodle · 6 minuti
- «pacchetto scorm moodle» Pacchetto SCORM: cos'è e come caricarlo su Moodle Formazione e Moodle · 3 minuti
- «conviene automatizzare il lavoro ripetitivo» Conviene automatizzare? Quanto costa il lavoro ripetitivo, in quattro numeri Automazioni · 5 minuti