Integración Zapier / Make (vía webhook + API pública)

2 direcciones de integración

Dirección 1: Studeia → Zapier (eventos de Studeia disparan workflow externo)

Caso de uso: alumno completa un curso → crear lead en Salesforce + notificar canal de Slack + enviar certificado por email personalizado.

Setup:

1. Zapier > New Zap > Trigger: Webhooks by Zapier > Catch Hook
2. Zapier genera la URL: https://hooks.zapier.com/hooks/catch/.../...
3. En Studeia: /institution/automations > New Automation
4. Trigger: evento course_completed
5. Conditions (opcional): event.score >= 80
6. Action: send_webhook > Method: POST > URL: URL del hook de Zapier
7. Body (interpolación de plantilla):

{
  "studentName": "{{user.name}}",
  "studentEmail": "{{user.email}}",
  "courseId": "{{event.courseId}}",
  "completedAt": "{{event.completedAt}}",
  "score": "{{event.score}}"
}

8. Guardar automatización
9. Zapier > Test trigger > completar un curso en Studeia > Zapier recibe el payload
10. Continuar el Zap: agregar actions (Salesforce, Slack, Gmail, etc)

Eventos disponibles: lesson_completed, module_completed, course_completed, quiz_submitted, assignment_submitted, enrollment_created, enrollment_completed, forum_post_created, forum_reply_created, grade_posted, announcement_created, live_class_scheduled, live_class_started, student_inactive, tag_added_to_user, tag_removed_from_user, webhook_received, scheduled_trigger, badge_earned, level_up, contest_ended.

Dirección 2: Zapier → Studeia (crear/actualizar recursos vía API)

Caso de uso: nuevo lead en Hubspot → crear usuario alumno + matricular en curso de bienvenida.

Setup:

1. En Studeia: /institution/settings/api-keys > Create > scopes: users:write, enrollments:write
2. Copie la clave (formato mia_ + 40 hex) — se muestra UNA ÚNICA VEZ
3. En Zapier:
   • Trigger: Hubspot 'New Contact'
   • Action: Webhooks by Zapier > POST
   • URL: https://[tenant].studeia.com/api/institution/users
   • Headers:
     • Authorization: Bearer mia_...
     • Content-Type: application/json
     • Accept-Language: es-ES
   • Body JSON:

{
  "name": "{{contact.name}}",
  "email": "{{contact.email}}",
  "role": "student",
  "sendInvite": true
}

4. Continuar el Zap: otra Action POST hacia /api/institution/enrollments con courseId

Rate limiting

La API key de Studeia tiene rate limit por tier:

• Standard: 1000 req/hora
• High: 5000 req/hora
• Custom: configurable

Headers de respuesta: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. Al superarlo: 429 + Retry-After.

Zapier respeta Retry-After automáticamente. Para volumen alto: actualizar el tier de rate o usar batch operations.

Prevención de SSRF (limitación)

El webhook de Studeia bloquea IPs privadas (10.x, 192.168.x, etc) y endpoints de metadata (169.254.169.254) — anti-SSRF. Las URLs de Zapier (hooks.zapier.com) son públicas y siempre pasan.

Si aloja n8n self-hosted en una IP privada: necesita exponerlo públicamente (Cloudflare Tunnel, ngrok) para que Studeia pueda llamarlo.

n8n self-hosted

n8n tiene un patrón similar a Make/Zapier. El trigger 'Webhook' acepta POST de Studeia. La action 'HTTP Request' llama a la API de Studeia.

Ventaja de n8n: puede ser self-hosted (gratis vs Zapier $19+/mes). Para volumen alto + datos sensibles: n8n propio tiene más sentido.

Roadmap

App oficial Zapier (en planning 2026 H2):

• Triggers: course_completed, enrollment_created, etc nativos
• Actions: Create user, Create enrollment, Update grade, etc
• Flujo OAuth 2.0 (en lugar de copiar y pegar API key)
• Sin necesidad de Webhooks by Zapier genérico

Ver también

• Automatizaciones nativas de Studeia
• API pública