# Integrações prontas

> Os apps feitos pela Memberfy em Configurações › Integrações e APIs › Integrações (Discord, Slack, Telegram, RD Station, HubSpot e os atalhos para Zapier, Make e n8n). Ligar com o consentimento, Enviar teste, Desligar, Remover integração, o histórico de entregas com reenvio e o aviso por e-mail quando um app é desligado por falha.

Uma integração pronta leva os eventos da comunidade para um app sem você montar nada do outro lado: *"Integrações prontas, feitas pela Memberfy: escolha o app, preencha os dados dele e escolha os eventos."* Quem entrou, comprou, assinou ou concluiu um curso vira uma mensagem no canal da equipe, um lead no RD Station ou um contato com negócio ganho no HubSpot.

![Configurações › Integrações e APIs › Integrações](/screens/integracoes-apps.png "Um card por app, com o que ele faz, o que recebe e a situação: Ligado, Desligado, Com falha ou Via webhook.")

## Onde fica

*Papel: proprietário e administrador.*

**Configurações › Integrações e APIs**, aba **Integrações**. O link direto é `/settings/integrations?sub=apps`; é para lá que o botão do e-mail de aviso leva.

## Os apps

| App | O que faz | O que recebe |
|---|---|---|
| [Discord](/integracoes/discord) | Uma mensagem curta num canal | O primeiro nome da pessoa e o nome do produto, do evento ou do curso. Nunca o e-mail |
| [Slack](/integracoes/slack) | Uma mensagem curta num canal | O mesmo do Discord |
| [Telegram](/integracoes/telegram) | Uma mensagem curta num grupo ou canal, pelo seu bot | O mesmo do Discord |
| [RD Station Marketing](/integracoes/rd-station) | Cria ou atualiza o lead, com uma conversão a cada evento | Nome, e-mail e telefone da pessoa e o nome do produto |
| [HubSpot](/integracoes/hubspot) | Cria ou atualiza o contato e registra compras e renovações como negócios ganhos | Nome, e-mail e telefone, o produto e o valor pago; no cancelamento, o status da assinatura |
| [Zapier, Make e n8n](/integracoes/zapier-make-n8n) | Atalho (**Via webhook**): abre o formulário de webhook já preenchido, com o guia | O evento completo, assinado, como em qualquer webhook |

As mensagens de canal (Discord, Slack, Telegram) saem **no idioma da comunidade** e levam só o primeiro nome. Um nome ou título que pareça um link não é publicado: no lugar entra *"Alguém"* ou *"(sem título)"*.

## Passo a passo: ligar um app

1. Em **Integrações**, clique no card do app.
2. Leia **Como conectar o …**: diz onde gerar a credencial no provedor. O artigo de cada app traz o caminho completo.
3. Cole a credencial (a URL do webhook, o token ou a chave).
4. Em **Eventos**, deixe marcados os que quiser receber. Todos vêm marcados; pelo menos um é obrigatório.
5. Marque **Este app vai receber: …**. Na primeira vez, sem esse consentimento o app não liga.
6. Clique em **Ligar**. A tela confirma: *"{app} ligado. Use Enviar teste para conferir."*
7. Clique em **Enviar teste**.

![O detalhe do Telegram](/screens/integracoes-telegram.png "O guia, os campos, os eventos do app e o consentimento: Este app vai receber.")

Nos apps Slack, Discord e Telegram, os eventos de check-in (**check-in feito** e **check-in desfeito**) vêm desligados; marque-os na tela da integração para recebê-los.

## Gerenciar um app ligado

| Situação | O que quer dizer |
|---|---|
| **Ligado** | Os eventos marcados estão chegando ao app |
| **Desligado** | Nunca foi ligado, ou alguém desligou; nada é enviado |
| **Com falha** | O provedor falhou por tempo demais e a Memberfy desligou o app (veja abaixo) |

- **Salvar**: troque a credencial ou os eventos e salve. Uma credencial deixada em branco fica como está (*"Deixe em branco para manter o valor salvo."*); a salva aparece mascarada (`••••abcd`). *"Mudanças valem para os próximos eventos; o que já estava a caminho segue com a configuração anterior."* Trocar a credencial zera as falhas.
- **Enviar teste**: manda agora uma mensagem de teste (*"Teste da Memberfy: a integração está funcionando."*) ou, nos CRMs, confere a credencial sem criar lead nem contato. Mostra *"Teste entregue."* ou o motivo, como *"O provedor recusou as credenciais. Confira o token ou a chave e salve de novo."*. Não é retentado e só funciona com o app ligado.
- **Desligar**: as entregas param na hora e as tentativas pendentes são canceladas. *"A configuração fica guardada para religar depois"*: basta clicar em **Ligar**, sem colar nada de novo.
- **Remover integração**: apaga a credencial e o histórico de entregas do app, **sem volta**. *"Para usar de novo, será preciso preencher os dados outra vez."*

Desligar e remover pedem confirmação. O que acontecer enquanto o app estiver desligado não é enviado depois.

## Entregas

O detalhe de um app ligado tem a seção **Entregas**, igual à dos [webhooks](/configuracoes/integracoes-e-apis#entregas): cada envio com o evento, a situação (**Pendente**, **Entregue**, **Falhou**, **Cancelada**), as tentativas e a resposta do provedor. Abra uma entrega para ver as tentativas e clique em **Reenviar** para mandar de novo. As entregas ficam guardadas por 30 dias.

Quando o provedor falha, a Memberfy tenta de novo depois de 1 min, 5 min, 30 min, 2 h, 6 h, 12 h e 24 h. Quando o provedor pede para esperar, a espera não conta como falha.

### Desligado por falha

Se o provedor passar **72 horas sem nenhuma entrega com sucesso**, o app fica **Com falha**: *"Desligado por falhas seguidas. Confira os dados e use Ligar para religar."* O proprietário e os administradores recebem o e-mail *"Desligamos uma integração que estava falhando"*, com o botão **Abrir Integrações**. Confira a credencial (um token revogado, um canal apagado), salve e clique em **Ligar**.

O **Histórico de alterações** da aba **Webhooks** também mostra quem ligou, salvou, testou, desligou ou removeu cada integração, e quando, inclusive o **Sistema** quando ela foi desligada por falha.

## Perguntas frequentes

**Por que não vejo a aba Integrações?**
Ela é só do proprietário e dos administradores.

**Posso ligar o mesmo app duas vezes, para dois canais?**
Não: cada app liga uma vez por comunidade. Para um segundo destino, use um [webhook](/configuracoes/integracoes-e-apis#webhooks) com o Zapier, o Make ou o n8n.

**Desligar ou remover?**
Desligar é uma pausa: a credencial fica guardada. Remover apaga a credencial e o histórico de entregas, e não se desfaz.

**O assistente de IA liga um app?**
Não. Ele só consulta a situação dos apps (veja abaixo); ligar, testar, desligar e remover é na tela.

## Pelo assistente e pela API

- Pelo assistente de IA: [`list_integrations`](/mcp/ferramentas-comunidade#list-integrations) com `type: apps` mostra a proprietário e administrador a situação, os eventos e as falhas de cada app ligado ou desligado, nunca a credencial. Peça *"Algum app ou webhook está falhando?"* ([receita 76](/mcp/receitas#76-algum-app-ou-webhook-esta-falhando)).
- Pela API: as rotas `/api/apps` de `https://developers.memberfy.net` (catálogo, ligar e salvar, testar, desligar ou remover, entregas e reenvio), só com o token de login de proprietário ou administrador, nunca com chave de API. A especificação está em [developers.memberfy.net/docs.json](https://developers.memberfy.net/docs.json).

## Relacionados

- [Integrações & APIs](/configuracoes/integracoes-e-apis)
- [Webhooks para quem integra](/api/webhooks)
- [Eventos de webhook](/api/eventos-de-webhook)