# Integrações prontas

> As apps feitas pela Memberfy em Definiçõ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 uma app é desligada por falha.

Uma integração pronta leva os eventos da comunidade para uma app sem ter de 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, subscreveu ou concluiu um curso torna-se uma mensagem no canal da equipa, um lead no RD Station ou um contacto com negócio ganho no HubSpot.

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

## Onde fica

*Papel: proprietário e administrador.*

**Definições › Integrações e APIs**, separador **Integrações**. A ligação direta é `/settings/integrations?sub=apps`; é para lá que o botão do e-mail de aviso leva.

## As 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 contacto e regista compras e renovações como negócios ganhos | Nome, e-mail e telefone, o produto e o valor pago; no cancelamento, o estado da subscrição |
| [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 uma ligação não é publicado: no lugar entra *"Alguém"* ou *"(sem título)"*.

## Passo a passo: ligar uma app

1. Em **Integrações**, clique no cartão da app.
2. Leia **Como conectar o …**: indica onde gerar a credencial no fornecedor. O artigo de cada app traz o caminho completo.
3. Cole a credencial (o URL do webhook, o token ou a chave).
4. Em **Eventos**, deixe marcados os que quiser receber. Vêm todos marcados; pelo menos um é obrigatório.
5. Marque **Este app vai receber: …**. Na primeira vez, sem esse consentimento a app não liga.
6. Clique em **Ligar**. O ecrã 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 da app e o consentimento: Este app vai receber.")

Nas apps Slack, Discord e Telegram, os eventos de check-in (**check-in feito** e **check-in desfeito**) vêm desligados; marque-os no ecrã da integração para os receber.

## Gerir uma app ligada

| Situação | O que quer dizer |
|---|---|
| **Ligado** | Os eventos marcados estão a chegar à app |
| **Desligado** | Nunca foi ligada, ou alguém a desligou; nada é enviado |
| **Com falha** | O fornecedor falhou durante demasiado tempo e a Memberfy desligou a app (ver abaixo) |

- **Guardar**: troque a credencial ou os eventos e guarde. Uma credencial deixada em branco fica como está (*"Deixe em branco para manter o valor guardado."*); a guardada 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 põe as falhas a zero.
- **Enviar teste**: envia agora uma mensagem de teste (*"Teste da Memberfy: a integração está funcionando."*) ou, nos CRM, verifica a credencial sem criar lead nem contacto. Mostra *"Teste entregue."* ou o motivo, como *"O provedor recusou as credenciais. Confira o token ou a chave e salve de novo."*. Não é repetido e só funciona com a app ligada.
- **Desligar**: as entregas param de imediato 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 da app, **sem volta**. *"Para usar de novo, será preciso preencher os dados outra vez."*

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

## Entregas

O detalhe de uma app ligada tem a secçã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 fornecedor. Abra uma entrega para ver as tentativas e clique em **Reenviar** para enviar de novo. As entregas ficam guardadas durante 30 dias.

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

### Desligado por falha

Se o fornecedor passar **72 horas sem nenhuma entrega com sucesso**, a 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**. Verifique a credencial (um token revogado, um canal apagado), guarde e clique em **Ligar**.

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

## Perguntas frequentes

**Porque não vejo o separador Integrações?**
É só do proprietário e dos administradores.

**Posso ligar a mesma 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 uma app?**
Não. Só consulta a situação das apps (ver abaixo); ligar, testar, desligar e remover faz-se no ecrã.

## Pelo assistente e pela API

- Pelo assistente de IA: [`list_integrations`](/mcp/ferramentas-comunidade#list-integrations) com `type: apps` mostra ao proprietário e ao administrador a situação, os eventos e as falhas de cada app ligada ou desligada, nunca a credencial. Peça *"Alguma app ou webhook está a falhar?"* ([receita 76](/mcp/receitas#76-alguma-app-ou-webhook-esta-a-falhar)).
- Pela API: as rotas `/api/apps` de `https://developers.memberfy.net` (catálogo, ligar e guardar, testar, desligar ou remover, entregas e reenvio), só com o token de início de sessão 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)