# 19 ottobre 2026

> Integrazioni e API arriva nelle Impostazioni, con chiavi API personali perché il tuo CRM, n8n o uno script chiamino l'API con permessi per modulo, e webhook che avvisano quei sistemi nel momento in cui qualcuno entra, acquista, si abbona, si iscrive a un evento o completa un corso. E arrivano le integrazioni pronte: Discord, Slack, Telegram, RD Station e HubSpot si attivano in pochi clic. La piattaforma ha anche nuovi controlli di sicurezza.

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](#chiavi-api-personali-con-permessi-per-modulo)
- [Webhook in Integrazioni e API](#webhook-in-integrazioni-e-api)
- [Integrazioni pronte: Discord, Slack, Telegram, RD Station, HubSpot e scorciatoie per Zapier, Make e n8n](#integrazioni-pronte)

## 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](/configuracoes/integracoes-e-apis).

![Impostazioni › Integrazioni e API › Nuova chiave](/screens/integracoes-nova-chave.png "I 28 moduli e le tre colonne: leggere, creare e modificare, eliminare e azioni distruttive.")

## 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](/configuracoes/integracoes-e-apis#webhook).

![Impostazioni › Integrazioni e API › Webhook › Nuovo webhook](/screens/integracoes-novo-webhook.png "L'URL di destinazione, gli eventi per famiglia e l'avviso sui dati personali.")

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](/membros/registros-de-atividades#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](/integracoes/integracoes-prontas).

![Impostazioni › Integrazioni e API › Integrazioni](/screens/integracoes-apps.png "Una scheda per app, con cosa riceve e lo stato.")

## 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](/configuracoes/integracoes-e-apis#modificare-un-webhook).
- **Nuovi controlli di sicurezza.**
- **Sito:** la pagina Piattaforma su [memberfy.net](https://memberfy.net/plataforma#integracoes) 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](/api/autenticacao#chave-de-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](/api/respostas-e-erros#errori-della-chiave-api).
- 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](/api/referencia/integrations).
- La specifica ottiene lo schema `apiKey`, e ogni operazione indica l'ambito che la chiave richiede o che non accetta chiavi; la [reference](/api/referencia) 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](/api/webhooks).
- [Eventi dei webhook](/api/eventos-de-webhook): il riferimento generato dal catalogo pubblico `GET /api/integrations/events`, con il JSON Schema di ogni evento.
- [IP fissi](/api/ips-fixos): `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](/api/webhooks#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](/api/webhooks#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](/mcp/ferramentas-comunidade#list-integrations).
- `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?](/mcp/receitas#73-quali-chiavi-api-ho), [Quali chiavi della community sono attive?](/mcp/receitas#74-quali-chiavi-della-community-sono-attive) e [Cosa ha fatto la chiave di n8n?](/mcp/receitas#75-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?](/mcp/receitas#76-qualche-app-o-webhook-sta-fallendo).