Cómo automatizar el acceso de estudiantes en el eLearning de Builderall usando Webhooks

¿Quieres agregar, suspender o eliminar estudiantes en tu curso de eLearning de Builderall de forma automatizada?

Estás en el lugar correcto.

Esta guía te mostrará exactamente cómo conectar plataformas externas —como sistemas de pago, CRMs o herramientas de automatización— al eLearning de Builderall utilizando webhooks seguros.
Ya sea que necesites registrar automáticamente a nuevos estudiantes, desactivar temporalmente su acceso o eliminarlos por completo, este tutorial paso a paso te dará todo lo que necesitas para hacerlo realidad.

Aviso sobre curso de prueba #

Los ejemplos a continuación usan credenciales de prueba (id=3550 y una secret key de demostración) creadas exclusivamente para validación interna.

Por favor, genera tu propia URL de webhook segura dentro de la configuración del curso en el eLearning de Builderall.

Para obtener los endpoints e integrarlos con tu sistema externo, ve a:

Cursos → Editar curso

Integraciones → Agregar nueva integración

Personaliza el nombre de la integración y haz clic en Crear integración

Para obtener tus endpoints (URLs), haz clic aquí:

Copia los endpoints (URLs) generados:

🔐 Nunca compartas públicamente tu clave secreta de producción.

Cómo funciona: resumen de endpoints Webhook #

El eLearning de Builderall ofrece tres endpoints seguros para gestionar el acceso de estudiantes:

Añadir o registrar un estudiante

Endpoint:
https://elearning.builderall.com/hooks/add.php?id=TU_ID_DEL_CURSO&secret=TU_SECRET

Método: POST

Parámetros:

email – Correo del estudiante (obligatorio)
password – Contraseña del estudiante (opcional; si se omite, el sistema genera una automáticamente)

Respuesta de ejemplo:

{
  "error": 0,
  "data": {
    "student_email": "ejemplo@email.com",
    "student_password": "autoGenerada123",
    "course_url": "https://elearning.builderall.com/course/..."
  }
}

Usa este endpoint después de un pago exitoso o una acción que active el registro.

Desactivar un estudiante (suspensión temporal)

Endpoint:
https://elearning.builderall.com/hooks/deactivate.php?id=TU_ID_DEL_CURSO&secret=TU_SECRET

Método: POST

Parámetros:

email – Correo del estudiante (obligatorio)

Respuesta de ejemplo:

{
  "error": 0,
  "data": "Student deactivated"
}

Ideal para casos de suspensión temporal (por ejemplo, falta de pago). El progreso se guarda y puede reactivarse luego.

Eliminar un estudiante (borrado permanente)

Endpoint:
https://elearning.builderall.com/hooks/remove.php?id=TU_ID_DEL_CURSO&secret=TU_SECRET

Método: POST

Parámetros:

email – Correo del estudiante (obligatorio)

Respuesta de ejemplo:

{
  "success": 1,
  "details": "User removed"
}

Úsalo solo si necesitas eliminar completamente al estudiante y no conservar su progreso.

Errores comunes y cómo solucionarlos #

Respuesta de error	Causa	Solución
{«error»:1,»details»:»Email parameter is empty»}	El parámetro `email` no fue incluido o tiene error.	Asegúrate de enviar `email` correctamente en el cuerpo del `POST`.
{«error»:1,»details»:»User not found»}	El correo no coincide con ningún estudiante registrado.	Verifica que el estudiante esté registrado antes de desactivarlo o eliminarlo.
{«success»:0,»details»:»Invalid secret key»}	La `secret key` usada en la URL es incorrecta o está vencida.	Genera una nueva `secret key` desde la configuración del curso.
{«error»:1,»details»:»Method not allowed»}	La solicitud fue enviada con `GET` en lugar de `POST`.	Todos los endpoints requieren el método `POST`.

Recomendaciones finales #

Usa el parámetro deactivate.php en lugar de remove.php en casos de suspensión temporal (así conservas el progreso del alumno).
Nunca compartas tu clave secreta públicamente.
Usa siempre el método POST; GET no es compatible.
Compatible con herramientas como Zapier, Make, PHP, Node.js y cualquier sistema que permita enviar peticiones POST.
Prueba tus integraciones en un entorno seguro antes de usarlas en producción.