19 de outubro de 2026

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

• 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 início de sessão. Na criação, marca, módulo a módulo, o que ela pode fazer: ler, criar e editar e apagar e ações destrutivas. Sem nada marcado, a chave não faz nada, e nunca vai além do que o seu papel permite.

Porque importa. Antes, uma integração precisava de um membro só para ela, com e-mail e palavra-passe guardados no sistema externo, e com todo o poder do papel desse membro. Agora a chave faz só o que liberou, pode ter data de expiração e uma lista de IPs, e deixa de funcionar no momento em que é revogada. Dinheiro (reembolso, levantamento, checkout, cartão), a conta (palavra-passe, início de sessão, e-mail, telefone) e a gestão das próprias chaves ficam fora do alcance de qualquer chave.

Onde fica. Proprietário e administrador: Definições, separador Integrações & APIs. Os outros papéis: Integrações & APIs, no menu da conta, abaixo de Faturação.

Como começar.

1. Clique em Nova chave, dê-lhe um nome e marque só os módulos e as colunas de que a integração precisa.
2. Se quiser, defina uma data de expiração e os IPs do servidor que vai fazer as chamadas.
3. Copie a chave de imediato: só aparece uma vez.

Exemplo. O Rafael, administrador, cria a chave CRM com ler em Membros e em Vendas e assinaturas, restrita ao IP do servidor do CRM. O CRM passa a ir buscar os novos assinantes automaticamente. O proprietário e o 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 o seu CRM, Zapier, Make ou n8n quando alguém entra, compra, assina, se inscreve num evento ou conclui um curso. Regista o URL de destino, escolhe os eventos (13, em 6 famílias) e a Memberfy envia um aviso assinado no momento em que o facto acontece.

Porque importa. Antes, para saber de uma compra ou de um membro novo, o sistema externo tinha de perguntar à API de tempos a tempos. Agora o aviso chega sozinho, com o nome e o e-mail da pessoa, e a folha de cálculo, o CRM ou o grupo da equipa atualizam-se em segundos. Se o destino ficar indisponível, a Memberfy tenta novamente durante quase dois dias e, se ele não voltar, desativa o webhook e avisa por e-mail.

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

Como começar.

1. Clique em Novo webhook, cole o URL que o Zapier, o Make ou o n8n forneceu e marque os eventos (a família inteira ou um a um).
2. Copie o segredo: só aparece uma vez, e é com ele que o destino confirma 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 passa a ser uma mensagem no canal da equipa. Na secção Entregas do webhook, vê cada envio, com a resposta do destino, e reenvia o que falhou. Se a firewall do destino só aceitar endereços conhecidos, a opção Enviar de IPs fixos faz com que as entregas saiam de dois IPs da Memberfy. Ver Integrações & APIs › Webhooks.

Chegou também: 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. Escolhe a app, cola a credencial respetiva, marca os eventos e liga. Sem automação pelo meio e sem código.

Porque importa. Antes, avisar a equipa no Slack de cada compra, ou levar os membros novos para o CRM, exigia um webhook e uma automação montada à mão. Agora a mensagem chega ao 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 contacto do HubSpot ganha o negócio da compra e da renovação, sem duplicar.

Onde fica. Definições, separador Integrações & APIs, separador Integrações. Proprietário e administrador.

Como começar.

1. Clique no card da app e siga o guia "Como conectar o …" para gerar o URL, o token ou a chave no fornecedor.
2. Cole, marque os eventos e confirme o que a 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-o ao grupo da equipa 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 fornecedor falhar durante 72 horas, a app é desligada e o proprietário e os administradores recebem um e-mail. Ver Integrações prontas.

#Melhorias

• Editar webhooks. Antes, para trocar o 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 curso seguem para o destino antigo, trocar o URL repõe as falhas a zero e editar não volta a ativar. Ver Editar um webhook.
• Novos controlos de segurança.
• Site: a página Plataforma em memberfy.net ganha a secção Integrações & APIs, que mostra as integrações prontas como disponíveis, e a página inicial e as páginas Para Comunidades, Para RH e Para Coworkings passam a referi-la com exemplos.

#Para programadores

#API

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

• Limite de 120 chamadas por minuto por pessoa em cada comunidade, somando as chaves dessa pessoa, 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, mudar o nome e os IPs, revogar, utilização) e /api/integrations/usage, só com o token de início de sessão. Ver Referência da API › Integrations.

• A especificação ganha o esquema apiKey, e cada operação indica o âmbito de 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, com o nome alterado, com os IPs alterados, 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 desativa de imediato; 72 h sem sucesso desativa, com e-mail ao proprietário e aos administradores; 429 respeita o Retry-After e não conta como falha. Só https na porta 443, sem redirecionamento, 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 autorizar na firewall.

• Gestão em https://developers.memberfy.net/api/webhooks (token de início de sessão de proprietário ou administrador, nunca chave de API). Criar, enviar teste, reativar, reenviar e trocar o URL somam para o 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; as entregas em curso mantêm o destino; trocar o URL repõe failureCount a zero; não reativa; 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 (predefinição) lista as suas chaves; scope: community (proprietário e administrador) lista as de todos, com member_id e status. Os âmbitos vêm com os nomes do ecrã; o segredo nunca. Não é possível criar, editar ou revogar chaves 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: Que chaves de API tenho?, Que chaves da comunidade estão ativas? e O que fez a chave do n8n?. O servidor passa a ter 445 ferramentas.
• list_integrations mostra também os webhooks ao proprietário e ao administrador (type: webhooks, ou sem type): estado, falhas consecutivas, a última entrega e, quando está a falhar, as últimas entregas que falharam. Só leitura: criar, testar, reenviar e apagar um webhook só é possível no ecrã; o URL completo e o segredo nunca são devolvidos.
• list_logs aceita type: apiKeys.
• list_integrations com type: apps (ou sem type), para o proprietário e o administrador: cada app que já esteve ligada alguma vez, com estado, eventos, falhas consecutivas, última entrega com sucesso e as últimas entregas que falharam; a configuração nunca é devolvida. Não é possível ligar, testar ou desligar apps pelo assistente. Receita nova: Alguma app ou webhook está a falhar?.