19 de octubre de 2026

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
• Webhooks en Integraciones y APIs
• Integraciones listas: Discord, Slack, Telegram, RD Station, HubSpot y atajos para Zapier, Make y n8n

#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.

#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.

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.

#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.

#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.
• Nuevos controles de seguridad.
• Sitio web: la página Plataforma de memberfy.net 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.

• 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.

• 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.

• 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 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.

• Eventos de webhook: la referencia generada del catálogo público GET /api/integrations/events, con el JSON Schema de cada evento.

• IPs fijas: 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.

• 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.

• 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.
• 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?, ¿Qué claves de la comunidad están activas? y ¿Qué 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?.