Conectar Circle
Agrega al comprador a los grupos de acceso de tu comunidad en Circle cuando se aprueba la venta y sácalo de esos grupos en reembolsos, contracargos o cancelaciones.
Con Circle conectada, cada venta aprobada agrega al comprador a los grupos de acceso (Access groups) de tu comunidad que elegiste para esa oferta. Quien todavía no es miembro recibe la invitación de Circle por correo. Cuando la compra se reembolsa, sufre un contracargo o la suscripción se cancela o vence, el miembro sale de esos grupos y sigue en la comunidad, con sus posts y sus otros grupos.
Antes de empezar, lee cómo funcionan las áreas de miembros.
Antes de empezar
- Una comunidad en Circle con un plan que tenga acceso a la Admin API v2.
- Los grupos de acceso ya creados, con los espacios y contenidos de pago vinculados a ellos.
- Rol Admin o Propietario en el proyecto de Vipter.
- Un producto con al menos una oferta en Vipter.
Paso 1: crear el token en Circle
- En Circle, abre DevelopersTokens (Desarrolladores › Tokens).
- Crea un token del tipo Admin V2 y cópialo.
El token vale para una sola comunidad. Para otra comunidad, crea otro token y otra conexión.
Anota también el ID numérico de cada grupo de acceso que van a liberar las ofertas. Busca el ID en la página del grupo de acceso, en el panel de Circle. Si no lo encuentras, pide ayuda al soporte de Circle.
Guarda el token con cuidado
Con el token se puede invitar a miembros y cambiar los accesos de la comunidad. Pega el token solo en Vipter. Una vez guardado, el campo solo muestra el final.
Paso 2: conectar en Vipter
- En el panel de Vipter, abre GeneralIntegracionesÁreas de miembrosCircle.
- En Conexión, completa el campo y deja encendido Activo — enviar accesos a esta plataforma.
| # | Campo | Qué pegar |
|---|---|---|
| 1 | Token de la API | El token Admin V2 que creaste en el paso 1. |
- Haz clic en Guardar y después en Probar conexión. Vipter consulta la comunidad con el token.
Paso 3: vincular cada oferta a los grupos de acceso
- En Reglas de acceso, elige la Oferta.
- Indica los IDs de los grupos de acceso en Circle separados por comas, como
12345, 67890. - Haz clic en Agregar regla. Repite para cada oferta que da acceso.
Paso 4: probar con una compra
Haz una compra de prueba de una oferta que tenga regla, con un correo que todavía no sea miembro de la comunidad.
Funcionó si
La compra aparece en Envíos recientes como Acceso otorgado, con el estado succeeded, la invitación de Circle llega al correo y, al entrar, el miembro ya ve los espacios del grupo de acceso.
Cómo funciona después
- Venta aprobada: Vipter busca al miembro por correo, incluso entre los invitados. Si no existe, se crea con el nombre de la compra y Circle envía la invitación. Después, entra en cada grupo de acceso de la regla. Quien ya es miembro no recibe otra invitación.
- Reembolso, contracargo, suscripción cancelada o vencida: el miembro sale de los grupos de acceso de la regla. Su perfil, sus posts y sus otros grupos quedan como están.
Reintentos y reenvío
Si Circle no responde o da un error pasajero, Vipter vuelve a intentarlo por su cuenta a los 5 minutos, 30 minutos, 2 horas, 6 horas y 24 horas. Justo después de la invitación, a veces Circle todavía no reconoce al miembro nuevo: ese caso también se reintenta. Un rechazo definitivo, como un token incorrecto, un plan sin la Admin API o un grupo que no existe, no se repite. Después de corregir, usa Reenviar. Consulta reintentos y reenvío.
Problemas comunes
-
La plataforma rechazó las credenciales con código 401
El token está mal o se borró. Crea otro del tipo Admin V2 y guarda.
-
La plataforma rechazó las credenciales con código 403 y "not eligible for admin API v2 access"
El plan de la comunidad no incluye la Admin API v2. El token está bien: tienes que cambiar el plan en Circle.
-
El envío falló con "Missing record: access group"
El grupo de acceso de la regla no existe en esa comunidad. Revisa el ID, quita la regla y crea otra. Después, libera el acceso de ese comprador directamente en Circle: el reenvío repite la regla antigua.
Qué hacer después
- Entiende cómo funcionan las áreas de miembros.
- Para avisar al miembro por correo, conecta un proveedor de correo.
Conectar The Members
Libera los productos de The Members al comprador cuando se aprueba la venta y desactiva su suscripción en reembolsos, contracargos o cancelaciones.
Cómo funcionan las comunidades pagas
Vende el acceso a un grupo o canal privado de Telegram o a un rol en Discord. Entiende cuándo se libera y se quita el acceso, dónde recibe el enlace el comprador y qué no puede hacer la integración.