19 ottobre 2026

Integrare la community con un altro sistema non richiede più un account dedicato: ogni persona crea la propria chiave, seleziona cosa può fare e la revoca quando vuole. E, nel verso opposto, la community ora avvisa da sola i tuoi sistemi.

• Chiavi API personali, con permessi per modulo
• Webhook in Integrazioni e API
• Integrazioni pronte: Discord, Slack, Telegram, RD Station, HubSpot e scorciatoie per Zapier, Make e n8n

#Chiavi API personali, con permessi per modulo

Cos'è. Una chiave che un CRM, un'automazione (n8n, Zapier, Make) o uno script usano per chiamare l'API della community a tuo nome, senza login. Alla creazione selezioni, modulo per modulo, cosa può fare: leggere, creare e modificare ed eliminare e azioni distruttive. Senza nulla selezionato, la chiave non fa niente, e non va mai oltre ciò che il tuo ruolo consente.

Perché è importante. Prima un'integrazione aveva bisogno di un membro dedicato, con email e password conservate nel sistema esterno, e con tutto il potere del suo ruolo. Ora la chiave fa solo ciò che hai sbloccato, può avere una scadenza e un elenco di IP, e smette di funzionare nel momento in cui viene revocata. Il denaro (rimborso, prelievo, checkout, carta), l'account (password, login, email, telefono) e la gestione delle chiavi stesse restano fuori dalla portata di qualsiasi chiave.

Dove si trova. Proprietario e admin: Impostazioni, scheda Integrazioni e API. Gli altri ruoli: Integrazioni e API, nel menu dell'account, sotto Fatturazione.

Come iniziare.

1. Clicca su Nuova chiave, dai un nome e seleziona solo i moduli e le colonne di cui l'integrazione ha bisogno.
2. Se vuoi, aggiungi una scadenza e gli IP del server che chiamerà.
3. Copia subito la chiave: compare una volta sola.

Esempio. Rafael, admin, crea la chiave CRM con leggere in Membri e in Vendite e abbonamenti, legata all'IP del server del CRM. Il CRM inizia a scaricare da solo i nuovi abbonati. Proprietario e admin vedono tutte le chiavi della community in Tutte della community, possono revocarne qualsiasi e seguono le chiamate del mese nel blocco Utilizzo. Vedi Integrazioni e API.

#Webhook in Integrazioni e API

Cos'è. Avvisa il tuo CRM, Zapier, Make o n8n quando qualcuno entra, acquista, si abbona, si iscrive a un evento o completa un corso. Registri l'URL di destinazione, scegli gli eventi (13, in 6 famiglie) e Memberfy invia un avviso firmato nel momento in cui succede.

Perché conta. Prima, per sapere di un acquisto o di un nuovo membro, il sistema esterno doveva chiedere all'API ogni tanto. Ora l'avviso arriva da solo, con il nome e l'e-mail della persona, e il foglio di calcolo, il CRM o il gruppo del team si aggiornano in pochi secondi. Se la destinazione va giù, Memberfy continua a provare per quasi due giorni e, se non torna, disattiva il webhook e avvisa via e-mail.

Dove si trova. Impostazioni, scheda Integrazioni e API, scheda Webhook. Proprietario e amministratore.

Come iniziare.

1. Clicca su Nuovo webhook, incolla l'URL che ti ha dato Zapier, Make o n8n e seleziona gli eventi (l'intera famiglia o uno per uno).
2. Copia il segreto: appare una sola volta, ed è con esso che la destinazione verifica che l'avviso arrivi da Memberfy.
3. Clicca su Invia test e guarda la risposta della destinazione.

Esempio. Giulia, proprietaria, collega la famiglia Acquisti a un trigger di Zapier. Ogni acquisto completato diventa un messaggio nel canale del team. Nella sezione Consegne del webhook vede ogni invio, con la risposta della destinazione, e reinvia ciò che è fallito. Se il firewall della destinazione accetta solo indirizzi noti, l'opzione Invia da IP fissi fa partire le consegne da due IP di Memberfy. Vedi Integrazioni e API › Webhook.

Arrivano anche: il blocco Utilizzo ora conta i webhook consegnati nel mese, e la pagina Amministrazione › Log ha il tipo Chiavi API, con tutto ciò che hanno fatto le chiavi. Vedi Log › Chiavi API.

#Integrazioni pronte

Cos'è. Integrazioni pronte: Discord, Slack, Telegram, RD Station, HubSpot e scorciatoie per Zapier, Make e n8n. Scegli l'app, incolli la sua credenziale, selezioni gli eventi e la attivi. Nessuna automazione in mezzo e nessun codice.

Perché conta. Prima, avvisare il team su Slack di ogni acquisto, o portare i nuovi membri nel CRM, richiedeva un webhook e un'automazione costruita a mano. Ora il messaggio arriva nel canale ("Maria ha acquistato Mentoring di Carriera.", solo con il nome, nella lingua della community), il lead compare in RD Station con la conversione, e il contatto di HubSpot riceve la trattativa dell'acquisto e del rinnovo, senza duplicati.

Dove si trova. Impostazioni, scheda Integrazioni e API, scheda Integrazioni. Proprietario e admin.

Come iniziare.

1. Clicca sulla scheda dell'app e segui la guida "Come collegare …" per generare l'URL, il token o la chiave presso il fornitore.
2. Incollala, seleziona gli eventi e conferma cosa riceverà l'app.
3. Clicca su Attiva e poi su Invia test.

Esempio. Júlia attiva Telegram: crea il bot in BotFather, lo aggiunge al gruppo del team e usa Trova il mio gruppo. A ogni iscrizione a un evento, il gruppo riceve "Maria si è iscritto a Incontro di Ottobre.". Disattiva mette in pausa e conserva la configurazione; Rimuovi integrazione cancella la credenziale e lo storico delle consegne. Se il fornitore fallisce per 72 ore, l'app viene disattivata e proprietario e admin ricevono un'e-mail. Vedi Integrazioni pronte.

#Miglioramenti

• Modificare i webhook. Prima, per cambiare l'URL, gli eventi o gli IP fissi di un webhook bisognava crearne un altro ed eliminare il vecchio. Ora il dettaglio ha Modifica, senza cambiare il segreto: le consegne in corso continuano verso la destinazione precedente, cambiare l'URL azzera gli errori e modificare non riattiva. Vedi Modificare un webhook.
• Nuovi controlli di sicurezza.
• Sito: la pagina Piattaforma su memberfy.net ottiene la sezione Integrazioni e API, che mostra le integrazioni pronte come disponibili, e la home e le pagine Per le community, Per le risorse umane e Per i coworking la citano con esempi.

#Per gli sviluppatori

#API

• Chiave API (X-Api-Key) al posto del token, sempre con l'X-CommunityId della community della chiave; con Authorization insieme, 400. La chiave agisce come il titolare e il permesso effettivo è l'ambito (<modulo>:<livello>, 28 moduli, read/write/delete) e, allo stesso tempo, il suo ruolo attuale. In una rotta pubblica, la chiave senza l'ambito prosegue come anonima. Vedi Autenticazione › Chiave API.

• Limite di 120 chiamate al minuto per persona in ogni community, sommando le sue chiavi, con 429 e Retry-After. IP consentiti per chiave (fino a 20, IPv4, IPv6 o CIDR).

• Errori con code stabile: API_KEY_SCOPE_MISSING, API_KEY_BLOCKED, API_KEY_ROUTE_NOT_COVERED, API_KEY_IP_NOT_ALLOWED, API_KEY_RATE_LIMITED, API_KEY_WITH_AUTHORIZATION e API_KEY_PATH_INVALID. Vedi Risposte ed errori.

• Rotte /api/integrations/api-keys (elencare, creare, vedere, rinominare e cambiare IP, revocare, utilizzo) e /api/integrations/usage, solo con il token di login. Vedi Reference dell'API › Integrations.

• La specifica ottiene lo schema apiKey, e ogni operazione indica l'ambito che la chiave richiede o che non accetta chiavi; la reference lo mostra accanto a Chiave API.

• GET /api/activity-logs ottiene l'origine apiKeys: chiave creata, rinominata, con IP cambiati, revocata, e ogni scrittura fatta con una chiave ("tramite la chiave {nome}").

• Webhook (Standard Webhooks): la busta (id, type, version, occurredAt, community, data), i 13 eventi e il ping, la firma webhook-id/webhook-timestamp/webhook-signature con esempio in Node (standardwebhooks), deduplicazione tramite webhook-id e ordine non garantito. 8 tentativi (1 min, 5 min, 30 min, 2 h, 6 h, 12 h, 24 h, circa 45 h); 410 disattiva subito; 72 h senza successo disattiva, con e-mail a proprietario e amministratori; 429 rispetta il Retry-After e non conta come errore. Solo https sulla porta 443, senza redirect, 10 s. Vedi Webhook.

• Eventi dei webhook: il riferimento generato dal catalogo pubblico GET /api/integrations/events, con il JSON Schema di ogni evento.

• IP fissi: 3.227.95.35 e 34.199.138.158, da consentire nel firewall.

• Gestione su https://developers.memberfy.net/api/webhooks (token di login di proprietario o amministratore, mai chiave API). Creare, inviare test, riattivare, reinviare e cambiare l'URL si sommano nel limite di 10 al minuto per community; fino a 10 webhook per community.

• Modificare un webhook: PATCH /api/webhooks/{id} (url, description, events, fixedIps, solo ciò che cambia). Vale per gli eventi successivi; le consegne in corso mantengono la destinazione; cambiare l'URL azzera failureCount; non riattiva; riga updated nella cronologia con il prima e il dopo. Vedi Webhook › Modificare un webhook.

• Integrazioni pronte: /api/apps su https://developers.memberfy.net (catalogo, PUT/DELETE dell'installazione, con ?remove=true per rimuovere, test, POST /api/apps/telegram/chats, consegne e reinvio), con lo stesso token di proprietario o admin. Vedi Webhook › Integrazioni pronte.

• GET /api/logs accetta type=apiKeys, con actor.via = api_key nelle chiamate fatte con chiave.

#MCP: dettagli tecnici

• list_integrations (nuovo, lettura, qualsiasi ruolo): scope: mine (predefinito) elenca le tue chiavi; scope: community (proprietario e admin) elenca quelle di tutti, con member_id e status. Gli ambiti arrivano con i nomi della schermata; il segreto mai. Nessuna creazione, modifica o revoca di chiavi tramite l'assistente. Vedi Strumenti · Community.
• list_activity_logs accetta source: apiKeys, e l'elenco della community in list_integrations suggerisce questa consulta in next_steps.
• Nuove ricette: Quali chiavi API ho?, Quali chiavi della community sono attive? e Cosa ha fatto la chiave di n8n?. Il server passa a 445 strumenti.
• list_integrations mostra anche i webhook a proprietario e amministratore (type: webhooks, o senza type): stato, errori consecutivi, l'ultima consegna e, quando sta fallendo, le ultime consegne non riuscite. Solo lettura: creare, testare, reinviare ed eliminare un webhook si fa solo dalla schermata; l'URL completo e il segreto non arrivano mai.
• list_logs accetta type: apiKeys.
• list_integrations con type: apps (o senza type), per proprietario e admin: ogni app attivata almeno una volta, con stato, eventi, errori consecutivi, ultima consegna riuscita e le ultime consegne non riuscite; la configurazione non arriva mai. Niente attivare, testare o disattivare app tramite l'assistente. Nuova ricetta: Qualche app o webhook sta fallendo?.