Conectar a Circle
Coloque o comprador nos grupos de acesso da sua comunidade na Circle quando a venda for aprovada e tire-o desses grupos em reembolso, chargeback ou cancelamento.
Com a Circle conectada, cada venda aprovada coloca o comprador nos grupos de acesso (Access groups) da sua comunidade que você escolheu para aquela oferta. Quem ainda não é membro recebe o convite da Circle por e-mail. Quando a compra é reembolsada, sofre chargeback ou a assinatura é cancelada ou expira, o membro sai desses grupos e continua na comunidade, com os posts e os outros grupos dele.
Antes de começar, vale ler como funcionam as áreas de membros.
Antes de começar
- Uma comunidade na Circle num plano com acesso à Admin API v2.
- Os grupos de acesso já criados, com os espaços e conteúdos pagos ligados a eles.
- Papel Admin ou Dono no projeto do Vipter.
- Um produto com ao menos uma oferta criada no Vipter.
Passo 1: criar o token na Circle
- Na Circle, abra DevelopersTokens.
- Crie um token do tipo Admin V2 e copie.
O token vale para uma comunidade só. Para outra comunidade, crie outro token e outra conexão.
Anote também o ID numérico de cada grupo de acesso que as ofertas vão liberar. Procure o ID na página do grupo de acesso, no painel da Circle. Se não encontrar, peça ao suporte da Circle.
Guarde o token com cuidado
Com o token dá para convidar membros e mudar os acessos da comunidade. Cole o token só no Vipter. Depois de salvo, o campo mostra só o final dele.
Passo 2: conectar no Vipter
- No painel do Vipter, abra GeralIntegraçõesÁreas de membrosCircle.
- Em Conexão, preencha o campo e deixe ligado Ativo — enviar acessos para esta plataforma.
| # | Campo | O que colar |
|---|---|---|
| 1 | Token da API | O token Admin V2 que você criou no passo 1. |
- Clique em Salvar e depois em Testar conexão. O Vipter consulta a comunidade com o token.
Passo 3: ligar cada oferta aos grupos de acesso
- Em Regras de acesso, escolha a Oferta.
- Informe os IDs dos grupos de acesso na Circle separados por vírgula, como
12345, 67890. - Clique em Adicionar regra. Repita para cada oferta que dá acesso.
Passo 4: testar com uma compra
Faça uma compra de teste de uma oferta que tem regra, com um e-mail que ainda não é membro da comunidade.
Deu certo se
A compra aparece em Envios recentes como Acesso liberado, com o status succeeded, o convite da Circle chega no e-mail e, ao entrar, o membro já vê os espaços do grupo de acesso.
Como funciona depois
- Venda aprovada: o Vipter procura o membro pelo e-mail, inclusive entre os convidados. Se ele não existir, é criado com o nome da compra e a Circle manda o convite. Depois, ele entra em cada grupo de acesso da regra. Quem já é membro não recebe outro convite.
- Reembolso, chargeback, assinatura cancelada ou expirada: o membro sai dos grupos de acesso da regra. O perfil, os posts e os outros grupos dele ficam como estão.
Novas tentativas e reenvio
Se a Circle não responder ou der um erro passageiro, o Vipter tenta de novo sozinho em 5 minutos, 30 minutos, 2 horas, 6 horas e 24 horas. Logo depois do convite, a Circle às vezes ainda não reconhece o membro novo: esse caso também é tentado de novo. Uma recusa definitiva, como um token errado, um plano sem a Admin API ou um grupo que não existe, não é repetida. Depois de corrigir, use Reenviar. Veja novas tentativas e reenvio.
Problemas comuns
-
A plataforma rejeitou as credenciais com código 401
O token está errado ou foi apagado. Crie outro do tipo Admin V2 e salve.
-
A plataforma rejeitou as credenciais com código 403 e "not eligible for admin API v2 access"
O plano da comunidade não inclui a Admin API v2. O token está certo: é preciso mudar o plano na Circle.
-
O envio falhou com "Missing record: access group"
O grupo de acesso da regra não existe nessa comunidade. Confira o ID, remova a regra e crie outra. Depois, libere o acesso desse comprador direto na Circle: o reenvio repete a regra antiga.
O que fazer a seguir
- Entenda como funcionam as áreas de membros.
- Para avisar o membro por e-mail, conecte um provedor de e-mail.
Conectar a The Members
Libere os produtos da The Members ao comprador quando a venda for aprovada e desative a assinatura dele em reembolso, chargeback ou cancelamento.
Como funcionam as comunidades pagas
Venda o acesso a um grupo ou canal privado do Telegram ou a um cargo no Discord. Entenda quando o acesso é liberado e retirado, onde o comprador recebe o link e o que a integração não consegue fazer.