# 19 de outubro de 2026

> Integrações & APIs chega às Configurações, com chaves de API pessoais para o seu CRM, o n8n ou um script chamarem a API com permissão por módulo, e webhooks que avisam esses sistemas na hora em que alguém entra, compra, assina, se inscreve num evento ou conclui um curso. E chegam as integrações prontas: Discord, Slack, Telegram, RD Station e HubSpot ligam em poucos cliques. A plataforma também ganhou novos controles de segurança.

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](#chaves-de-api-pessoais-com-permissao-por-modulo)
- [Webhooks em Integrações & APIs](#webhooks-em-integracoes-apis)
- [Integrações prontas: Discord, Slack, Telegram, RD Station, HubSpot e atalhos para Zapier, Make e n8n](#integracoes-prontas)

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

![Configurações › Integrações & APIs › Nova chave](/screens/integracoes-nova-chave.png "Os 28 módulos e as três colunas: ler, criar e editar, apagar e ações destrutivas.")

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

![Configurações › Integrações & APIs › Webhooks › Novo webhook](/screens/integracoes-novo-webhook.png "A URL de destino, os eventos por família e o aviso de dados pessoais.")

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

![Configurações › Integrações & APIs › Integrações](/screens/integracoes-apps.png "Um card por app, com o que ele recebe e a situação.")

## 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](/configuracoes/integracoes-e-apis#editar-um-webhook).
- **Novos controles de segurança.**
- **Site:** a página Plataforma em [memberfy.net](https://memberfy.net/plataforma#integracoes) 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](/api/autenticacao#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](/api/respostas-e-erros#erros-da-chave-de-api).
- 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](/api/referencia/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](/api/referencia) 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](/api/webhooks).
- [Eventos de webhook](/api/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](/api/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](/api/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](/api/webhooks#integracoes-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](/mcp/ferramentas-comunidade#list-integrations).
- `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?](/mcp/receitas#73-quais-chaves-de-api-eu-tenho), [Quais chaves da comunidade estão ativas?](/mcp/receitas#74-quais-chaves-da-comunidade-estao-ativas) e [O que a chave do n8n fez?](/mcp/receitas#75-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?](/mcp/receitas#76-algum-app-ou-webhook-esta-falhando).