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.
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 | 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 | Uma mensagem curta num canal | O mesmo do Discord |
| Telegram | Uma mensagem curta num grupo ou canal, pelo seu bot | O mesmo do Discord |
| RD Station Marketing | 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 | 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 | 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
- Em Integrações, clique no cartão da app.
- Leia Como conectar o …: indica onde gerar a credencial no fornecedor. O artigo de cada app traz o caminho completo.
- Cole a credencial (o URL do webhook, o token ou a chave).
- Em Eventos, deixe marcados os que quiser receber. Vêm todos marcados; pelo menos um é obrigatório.
- Marque Este app vai receber: …. Na primeira vez, sem esse consentimento a app não liga.
- Clique em Ligar. O ecrã confirma: "{app} ligado. Use Enviar teste para conferir."
- Clique em Enviar teste.
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: 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 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_integrationscomtype: appsmostra 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). - Pela API: as rotas
/api/appsdehttps://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.