# 19 de octubre de 2026

> Integraciones y APIs llega a Configuración, con claves de API personales para que tu CRM, n8n o un script llamen a la API con permiso por módulo, y webhooks que avisan a esos sistemas en el momento en que alguien entra, compra, se suscribe, se inscribe en un evento o termina un curso. Y llegan las integraciones listas: Discord, Slack, Telegram, RD Station y HubSpot se activan en pocos clics. La plataforma también ganó nuevos controles de seguridad.

Integrar la comunidad con otro sistema ya no exige una cuenta solo para eso: cada persona crea su propia clave, marca lo que puede hacer y la revoca cuando quiera. Y, en sentido inverso, la comunidad pasa a avisar a tus sistemas por sí sola.

- [Claves de API personales, con permiso por módulo](#claves-de-api-personales-con-permiso-por-modulo)
- [Webhooks en Integraciones y APIs](#webhooks-en-integraciones-y-apis)
- [Integraciones listas: Discord, Slack, Telegram, RD Station, HubSpot y atajos para Zapier, Make y n8n](#integraciones-listas)

## Claves de API personales, con permiso por módulo

**Qué es.** Una clave que un CRM, una automatización (n8n, Zapier, Make) o un script usan para llamar a la API de la comunidad en tu nombre, sin iniciar sesión. Al crearla marcas, módulo por módulo, lo que puede hacer: **leer**, **crear y editar** y **eliminar y acciones destructivas**. Sin nada marcado, la clave no hace nada, y nunca va más allá de lo que tu rol permite.

**Por qué importa.** Antes, una integración necesitaba un miembro solo para ella, con el correo y la contraseña guardados en el sistema externo, y con todo el poder de su rol. Ahora la clave hace solo lo que liberaste, puede tener vencimiento y una lista de IP, y deja de funcionar en el momento en que se revoca. El dinero (reembolso, retiro, checkout, tarjeta), la cuenta (contraseña, inicio de sesión, correo, teléfono) y la gestión de las propias claves quedan fuera del alcance de cualquier clave.

**Dónde está.** Propietario y administrador: **Configuración**, pestaña **Integraciones y APIs**. Los demás roles: **Integraciones y APIs**, en el menú de la cuenta, debajo de **Facturación**.

**Cómo empezar.**

1. Haz clic en **Nueva clave**, ponle un nombre y marca solo los módulos y las columnas que necesita la integración.
2. Si quieres, añade un vencimiento y las IP del servidor que va a llamar.
3. Copia la clave en el momento: aparece una sola vez.

**Ejemplo.** Rafael, administrador, crea la clave *CRM* con **leer** en **Miembros** y en **Ventas y suscripciones**, limitada a la IP del servidor del CRM. El CRM pasa a traer los suscriptores nuevos por su cuenta. Propietario y administrador ven todas las claves de la comunidad en **Todas de la comunidad**, pueden revocar cualquiera y siguen las llamadas del mes en el bloque **Uso**. Consulta [Integraciones y APIs](/configuracoes/integracoes-e-apis).

![Configuración › Integraciones y APIs › Nueva clave](/screens/integracoes-nova-chave.png "Los 28 módulos y las tres columnas: leer, crear y editar, eliminar y acciones destructivas.")

## Webhooks en Integraciones y APIs

**Qué es.** Avisa a tu CRM, Zapier, Make o n8n cuando alguien entra, compra, se suscribe, se inscribe en un evento o termina un curso. Registras la URL de destino, eliges los eventos (13, en 6 familias) y Memberfy envía un aviso firmado en el momento en que ocurre.

**Por qué importa.** Antes, para enterarse de una compra o de un miembro nuevo, el sistema externo tenía que preguntar a la API cada cierto tiempo. Ahora el aviso llega solo, con el nombre y el correo de la persona, y la hoja de cálculo, el CRM o el grupo del equipo se actualizan en segundos. Si el destino cae, Memberfy lo sigue intentando durante casi dos días y, si no vuelve, desactiva el webhook y avisa por correo.

**Dónde está.** **Configuración**, pestaña **Integraciones y APIs**, pestaña **Webhooks**. Propietario y administrador.

**Cómo empezar.**

1. Haz clic en **Nuevo webhook**, pega la URL que te dio Zapier, Make o n8n y marca los eventos (la familia entera o uno a uno).
2. Copia el secreto: aparece una sola vez, y es con él como el destino comprueba que el aviso vino de Memberfy.
3. Haz clic en **Enviar prueba** y mira la respuesta del destino.

**Ejemplo.** Julia, propietaria, conecta la familia **Compras** a un disparador de Zapier. Cada compra completada se convierte en un mensaje en el canal del equipo. En la sección **Entregas** del webhook ve cada envío, con la respuesta del destino, y **reenvía** lo que falló. Si el firewall del destino solo acepta direcciones conocidas, la opción **Enviar desde IPs fijas** hace que las entregas salgan de dos IPs de Memberfy. Ver [Integraciones y APIs › Webhooks](/configuracoes/integracoes-e-apis#webhooks).

![Configuración › Integraciones y APIs › Webhooks › Nuevo webhook](/screens/integracoes-novo-webhook.png "La URL de destino, los eventos por familia y el aviso de datos personales.")

También llegó: el bloque **Uso** pasa a contar los webhooks entregados en el mes, y la página **Administración › Logs** gana el tipo **Claves de API**, con todo lo que hicieron las claves. Ver [Logs › Claves de API](/membros/registros-de-atividades#claves-de-api).

## Integraciones listas

**Qué es.** Integraciones listas: Discord, Slack, Telegram, RD Station, HubSpot y atajos para Zapier, Make y n8n. Eliges la app, pegas su credencial, marcas los eventos y la activas. Sin automatización en medio y sin código.

**Por qué importa.** Antes, avisar al equipo en Slack de cada compra, o llevar a los miembros nuevos al CRM, pedía un webhook y una automatización montada a mano. Ahora el mensaje llega al canal (*"María compró Mentoría de Carrera."*, solo con el nombre de pila, en el idioma de la comunidad), el lead aparece en RD Station con la conversión, y el contacto de HubSpot recibe el negocio de la compra y la renovación, sin duplicar.

**Dónde está.** **Configuración**, pestaña **Integraciones y APIs**, pestaña **Integraciones**. Propietario y administrador.

**Cómo empezar.**

1. Haz clic en la tarjeta de la app y sigue la guía *"Cómo conectar …"* para generar la URL, el token o la clave en el proveedor.
2. Pégala, marca los eventos y confirma lo que la app va a recibir.
3. Haz clic en **Activar** y después en **Enviar prueba**.

**Ejemplo.** Júlia activa Telegram: crea el bot en BotFather, lo añade al grupo del equipo y usa **Encontrar mi grupo**. Con cada inscripción en un evento, el grupo recibe *"María se inscribió en Encuentro de Octubre."*. **Desactivar** pausa y guarda la configuración; **Eliminar integración** borra la credencial y el historial de entregas. Si el proveedor falla durante 72 horas, la app se desactiva y propietario y administradores reciben un correo. Ver [Integraciones listas](/integracoes/integracoes-prontas).

![Configuración › Integraciones y APIs › Integraciones](/screens/integracoes-apps.png "Una tarjeta por app, con lo que recibe y su estado.")

## Mejoras

- **Editar webhooks.** Antes, para cambiar la URL, los eventos o las IPs fijas de un webhook había que crear otro y eliminar el antiguo. Ahora el detalle tiene **Editar**, sin cambiar el secreto: las entregas en curso siguen al destino anterior, cambiar la URL pone a cero los fallos y editar no reactiva. Ver [Editar un webhook](/configuracoes/integracoes-e-apis#editar-un-webhook).
- **Nuevos controles de seguridad.**
- **Sitio web:** la página Plataforma de [memberfy.net](https://memberfy.net/plataforma#integracoes) suma la sección **Integraciones y APIs**, que muestra las integraciones listas como disponibles, y la portada y las páginas Para Comunidades, Para RR. HH. y Para Coworkings la mencionan con ejemplos.

## Para desarrolladores

### API

- **Clave de API (`X-Api-Key`)** en lugar del token, siempre con el `X-CommunityId` de la comunidad de la clave; con `Authorization` junto, `400`. La clave actúa como su dueño y el permiso efectivo es el alcance (`<módulo>:<nivel>`, 28 módulos, `read`/`write`/`delete`) y, a la vez, su rol actual. En una ruta pública, la clave sin el alcance sigue como anónima. Consulta [Autenticación › Clave de API](/api/autenticacao#chave-de-api).
- Límite de **120 llamadas por minuto por persona en cada comunidad**, sumando sus claves, con `429` y `Retry-After`. IPs permitidas por clave (hasta 20, IPv4, IPv6 o CIDR).
- Errores con `code` estable: `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` y `API_KEY_PATH_INVALID`. Consulta [Respuestas y errores](/api/respostas-e-erros#errores-de-la-clave-de-api).
- Rutas **`/api/integrations/api-keys`** (listar, crear, ver, renombrar y cambiar las IP, revocar, uso) y **`/api/integrations/usage`**, solo con el token de inicio de sesión. Consulta [Referencia de la API › Integrations](/api/referencia/integrations).
- La especificación gana el esquema `apiKey`, y cada operación indica el alcance que necesita la clave o que no acepta clave; la [referencia](/api/referencia) lo muestra junto a **Clave de API**.
- `GET /api/activity-logs` gana el origen **`apiKeys`**: clave creada, renombrada, con las IP cambiadas, revocada, y cada escritura hecha con clave (*"con la clave {nombre}"*).

- **Webhooks** (Standard Webhooks): el sobre (`id`, `type`, `version`, `occurredAt`, `community`, `data`), los 13 eventos y el `ping`, la firma `webhook-id`/`webhook-timestamp`/`webhook-signature` con ejemplo en Node (`standardwebhooks`), deduplicación por el `webhook-id` y orden no garantizado. 8 intentos (1 min, 5 min, 30 min, 2 h, 6 h, 12 h, 24 h, unas 45 h); `410` desactiva en el acto; 72 h sin éxito desactiva, con correo a propietario y administradores; `429` respeta el `Retry-After` y no cuenta como fallo. Solo `https` en el puerto 443, sin redirect, 10 s. Ver [Webhooks](/api/webhooks).
- [Eventos de webhook](/api/eventos-de-webhook): la referencia generada del catálogo público `GET /api/integrations/events`, con el JSON Schema de cada evento.
- [IPs fijas](/api/ips-fixos): `3.227.95.35` y `34.199.138.158`, para permitir en el firewall.
- Gestión en `https://developers.memberfy.net/api/webhooks` (token de inicio de sesión de propietario o administrador, nunca clave de API). Crear, enviar prueba, reactivar, reenviar y cambiar la URL suman en el límite de 10 por minuto por comunidad; hasta 10 webhooks por comunidad.
- **Editar webhook:** `PATCH /api/webhooks/{id}` (`url`, `description`, `events`, `fixedIps`, solo lo que cambia). Vale para los eventos siguientes; las entregas en curso mantienen el destino; cambiar la URL pone a cero `failureCount`; no reactiva; línea `updated` en el historial con el antes y el después. Ver [Webhooks › Editar un webhook](/api/webhooks#editar-un-webhook).
- **Integraciones listas:** `/api/apps` en `https://developers.memberfy.net` (catálogo, `PUT`/`DELETE` de la instalación, con `?remove=true` para eliminar, prueba, `POST /api/apps/telegram/chats`, entregas y reenvío), con el mismo token de propietario o administrador. Ver [Webhooks › Integraciones listas](/api/webhooks#integraciones-listas).
- `GET /api/logs` acepta `type=apiKeys`, con `actor.via` = `api_key` en las llamadas hechas con clave.

### MCP: detalles técnicos

- **`list_integrations`** (nueva, lectura, cualquier rol): `scope: mine` (predeterminado) lista tus claves; `scope: community` (propietario y administrador) lista las de todos, con `member_id` y `status`. Los alcances llegan con los nombres de la pantalla; el secreto, nunca. No se crean, editan ni revocan claves desde el asistente. Consulta [Herramientas · Comunidad](/mcp/ferramentas-comunidade#list-integrations).
- `list_activity_logs` acepta `source: apiKeys`, y la lista de la comunidad en `list_integrations` sugiere esa consulta en `next_steps`.
- Recetas nuevas: [¿Qué claves de API tengo?](/mcp/receitas#73-que-claves-de-api-tengo), [¿Qué claves de la comunidad están activas?](/mcp/receitas#74-que-claves-de-la-comunidad-estan-activas) y [¿Qué hizo la clave de n8n?](/mcp/receitas#75-que-hizo-la-clave-de-n8n). El servidor pasa a tener 445 herramientas.
- **`list_integrations`** muestra también los webhooks a propietario y administrador (`type: webhooks`, o sin `type`): estado, fallos seguidos, la última entrega y, cuando está fallando, las últimas entregas fallidas. Solo consulta: crear, probar, reenviar y eliminar un webhook es solo en la pantalla; la URL completa y el secreto nunca llegan.
- **`list_logs`** acepta `type: apiKeys`.
- **`list_integrations`** con `type: apps` (o sin `type`), para propietario y administrador: cada app activada alguna vez, con estado, eventos, fallos seguidos, última entrega con éxito y las últimas entregas fallidas; la configuración nunca llega. Sin activar, probar ni desactivar apps desde el asistente. Receta nueva: [¿Alguna app o webhook está fallando?](/mcp/receitas#76-alguna-app-o-webhook-esta-fallando).