19 de outubro de 2026

Integrar a comunidade com outro sistema deixa de exigir uma conta só para isso: cada pessoa cria a própria chave, marca o que ela pode fazer e revoga quando quiser. E, no caminho inverso, a comunidade passa a avisar os seus sistemas sozinha.

• Chaves de API pessoais, com permissão por módulo
• Webhooks em Integrações & APIs
• Integrações prontas: Discord, Slack, Telegram, RD Station, HubSpot e atalhos para Zapier, Make e n8n

#Chaves de API pessoais, com permissão por módulo

O que é. Uma chave que um CRM, uma automação (n8n, Zapier, Make) ou um script usam para chamar a API da comunidade em seu nome, sem login. Na criação você marca, módulo por módulo, o que ela pode: ler, criar e editar e apagar e ações destrutivas. Sem nada marcado, a chave não faz nada, e ela nunca passa do que o seu papel permite.

Por que importa. Antes, uma integração precisava de um membro só para ela, com e-mail e senha guardados no sistema de fora, e com todo o poder do papel dele. Agora a chave faz só o que você liberou, pode ter vencimento e uma lista de IPs, e para de funcionar na hora em que é revogada. Dinheiro (reembolso, saque, checkout, cartão), a conta (senha, login, e-mail, telefone) e a gestão das próprias chaves ficam fora do alcance de qualquer chave.

Onde fica. Proprietário e administrador: Configurações, aba Integrações & APIs. Os outros papéis: Integrações & APIs, no menu da conta, abaixo de Faturamento.

Como começar.

1. Clique em Nova chave, dê um nome e marque só os módulos e as colunas de que a integração precisa.
2. Se quiser, coloque um vencimento e os IPs do servidor que vai chamar.
3. Copie a chave na hora: ela aparece uma vez só.

Exemplo. O Rafael, administrador, cria a chave CRM com ler em Membros e em Vendas e assinaturas, presa ao IP do servidor do CRM. O CRM passa a puxar os assinantes novos sozinho. Proprietário e administrador veem todas as chaves da comunidade em Todas da comunidade, podem revogar qualquer uma e acompanham as chamadas do mês no bloco Uso. Ver Integrações & APIs.

#Webhooks em Integrações & APIs

O que é. Avise seu CRM, Zapier, Make ou n8n quando alguém entra, compra, assina, se inscreve num evento ou conclui um curso. Você cadastra a URL de destino, escolhe os eventos (13, em 6 famílias) e a Memberfy manda um aviso assinado na hora em que o fato acontece.

Por que importa. Antes, para saber de uma compra ou de um membro novo, o sistema de fora precisava perguntar à API de tempos em tempos. Agora o aviso chega sozinho, com o nome e o e-mail da pessoa, e a planilha, o CRM ou o grupo da equipe se atualizam em segundos. Se o destino cair, a Memberfy tenta de novo por quase dois dias e, se ele não voltar, desliga o webhook e avisa por e-mail.

Onde fica. Configurações, aba Integrações & APIs, aba Webhooks. Proprietário e administrador.

Como começar.

1. Clique em Novo webhook, cole a URL que o Zapier, o Make ou o n8n deu e marque os eventos (a família inteira ou um a um).
2. Copie o segredo: ele aparece uma vez só, e é com ele que o destino confere que o aviso veio da Memberfy.
3. Clique em Enviar teste e veja a resposta do destino.

Exemplo. A Júlia, proprietária, liga a família Compras a um gatilho do Zapier. Cada compra concluída vira uma mensagem no canal da equipe. Na seção Entregas do webhook ela vê cada envio, com a resposta do destino, e reenvia o que falhou. Se o firewall do destino só aceita endereços conhecidos, a opção Enviar de IPs fixos faz as entregas saírem de dois IPs da Memberfy. Ver Integrações & APIs › Webhooks.

Também chegou: o bloco Uso passa a contar os webhooks entregues no mês, e a página Administração › Logs ganha o tipo Chaves de API, com tudo o que as chaves fizeram. Ver Logs › Chaves de API.

#Integrações prontas

O que é. Integrações prontas: Discord, Slack, Telegram, RD Station, HubSpot e atalhos para Zapier, Make e n8n. Você escolhe o app, cola a credencial dele, marca os eventos e liga. Sem automação no meio e sem código.

Por que importa. Antes, avisar a equipe no Slack de cada compra, ou levar os membros novos para o CRM, pedia um webhook e uma automação montada à mão. Agora a mensagem chega no canal ("Maria comprou Mentoria de Carreira.", só com o primeiro nome, no idioma da comunidade), o lead aparece no RD Station com a conversão, e o contato do HubSpot ganha o negócio da compra e da renovação, sem duplicar.

Onde fica. Configurações, aba Integrações & APIs, aba Integrações. Proprietário e administrador.

Como começar.

1. Clique no card do app e siga o guia "Como conectar o …" para gerar a URL, o token ou a chave no provedor.
2. Cole, marque os eventos e confirme o que o app vai receber.
3. Clique em Ligar e depois em Enviar teste.

Exemplo. A Júlia liga o Telegram: cria o bot no BotFather, adiciona ao grupo da equipe e usa Encontrar meu grupo. A cada inscrição num evento, o grupo recebe "Maria se inscreveu em Encontro de Outubro.". Desligar pausa e guarda a configuração; Remover integração apaga a credencial e o histórico de entregas. Se o provedor falhar por 72 horas, o app é desligado e proprietário e administradores recebem um e-mail. Ver Integrações prontas.

#Melhorias

• Editar webhooks. Antes, para trocar a URL, os eventos ou os IPs fixos de um webhook era preciso criar outro e apagar o antigo. Agora o detalhe tem Editar, sem trocar o segredo: as entregas já em andamento seguem para o destino antigo, trocar a URL zera as falhas e editar não religa. Ver Editar um webhook.
• Novos controles de segurança.
• Site: a página Plataforma em memberfy.net ganha a seção Integrações & APIs, que mostra as integrações prontas como disponíveis, e a home e as páginas Para Comunidades, Para RH e Para Coworkings passam a citá-la com exemplos.

#Para desenvolvedores

#API

• Chave de API (X-Api-Key) no lugar do token, sempre com o X-CommunityId da comunidade da chave; com Authorization junto, 400. A chave age como o dono e a permissão efetiva é o escopo (<módulo>:<nível>, 28 módulos, read/write/delete) e, ao mesmo tempo, o papel atual dele. Numa rota pública, a chave sem o escopo segue como anônima. Ver Autenticação › Chave de API.

• Limite de 120 chamadas por minuto por pessoa em cada comunidade, somando as chaves dela, com 429 e Retry-After. IPs permitidos por chave (até 20, IPv4, IPv6 ou CIDR).

• Erros com code estável: 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. Ver Respostas e erros.

• Rotas /api/integrations/api-keys (listar, criar, ver, renomear e trocar IPs, revogar, uso) e /api/integrations/usage, só com o token de login. Ver Referência da API › Integrations.

• A especificação ganha o esquema apiKey, e cada operação diz o escopo que a chave precisa ou que não aceita chave; a referência mostra isso ao lado de Chave de API.

• GET /api/activity-logs ganha a origem apiKeys: chave criada, renomeada, com IPs trocados, revogada, e cada escrita feita com chave ("via chave {nome}").

• Webhooks (Standard Webhooks): o envelope (id, type, version, occurredAt, community, data), os 13 eventos e o ping, a assinatura webhook-id/webhook-timestamp/webhook-signature com exemplo em Node (standardwebhooks), deduplicação pelo webhook-id e ordem não garantida. 8 tentativas (1 min, 5 min, 30 min, 2 h, 6 h, 12 h, 24 h, cerca de 45 h); 410 desliga na hora; 72 h sem sucesso desliga, com e-mail a proprietário e administradores; 429 respeita o Retry-After e não conta como falha. Só https na porta 443, sem redirect, 10 s. Ver Webhooks.

• Eventos de webhook: a referência gerada do catálogo público GET /api/integrations/events, com o JSON Schema de cada evento.

• IPs fixos: 3.227.95.35 e 34.199.138.158, para liberar no firewall.

• Gestão em https://developers.memberfy.net/api/webhooks (token de login de proprietário ou administrador, nunca chave de API). Criar, enviar teste, religar, reenviar e trocar a URL somam no limite de 10 por minuto por comunidade; até 10 webhooks por comunidade.

• Editar webhook: PATCH /api/webhooks/{id} (url, description, events, fixedIps, só o que muda). Vale para os eventos seguintes; entregas em andamento mantêm o destino; trocar a URL zera failureCount; não religa; histórico updated com o antes e o depois. Ver Webhooks › Editar um webhook.

• Integrações prontas: /api/apps em https://developers.memberfy.net (catálogo, PUT/DELETE da instalação, com ?remove=true para remover, teste, POST /api/apps/telegram/chats, entregas e reenvio), com o mesmo token de proprietário ou administrador. Ver Webhooks › Integrações prontas.

• GET /api/logs aceita type=apiKeys, com actor.via = api_key nas chamadas feitas com chave.

#MCP: detalhes técnicos

• list_integrations (nova, leitura, qualquer papel): scope: mine (padrão) lista as suas chaves; scope: community (proprietário e administrador) lista as de todos, com member_id e status. Os escopos vêm com os nomes da tela; o segredo nunca. Sem criar, editar ou revogar chave pelo assistente. Ver Ferramentas · Comunidade.
• list_activity_logs aceita source: apiKeys, e a lista da comunidade em list_integrations sugere essa consulta em next_steps.
• Receitas novas: Quais chaves de API eu tenho?, Quais chaves da comunidade estão ativas? e O que a chave do n8n fez?. O servidor passa a ter 445 ferramentas.
• list_integrations mostra também os webhooks a proprietário e administrador (type: webhooks, ou sem type): situação, falhas seguidas, a última entrega e, quando está falhando, as últimas entregas que falharam. Só leitura: criar, testar, reenviar e apagar webhook é só na tela; URL completa e segredo nunca vêm.
• list_logs aceita type: apiKeys.
• list_integrations com type: apps (ou sem type), para proprietário e administrador: cada app já ligado alguma vez, com situação, eventos, falhas seguidas, última entrega com sucesso e as últimas entregas que falharam; a configuração nunca vem. Sem ligar, testar ou desligar app pelo assistente. Receita nova: Algum app ou webhook está falhando?.