Flujos de Integración

Flujo: Crear reunión y agregar participantes

Este es el flujo principal para integraciones externas.

1. Obtener API Key desde el dashboard de Zelta Meet
   (ver sección Integraciones)

2. Crear reunión:
   POST /public/meetings
   x-api-key: <api_key>
   { "title": "Mi reunión", "datetime": "2026-03-15T14:30:00Z" }
   → Guardar public_meeting_id de la respuesta

3. Agregar participantes:
   POST /public/meetings/<public_meeting_id>/participants
   x-api-key: <api_key>
   { "preset_name": "host", "name": "Organizador", "externalId": "user-1" }
   → Guardar token y public_participant_id

4. Agregar más participantes:
   POST /public/meetings/<public_meeting_id>/participants
   x-api-key: <api_key>
   { "preset_name": "participant", "email": "[email protected]", "name": "Invitado" }
   → El participante recibe email de invitación automáticamente

5. Conectar al meeting:
   - Host: usar el token devuelto para conectarse a la reunión
   - Participante con email: accede vía el link en el email de invitación
   - Participante sin email: usar public_participant_id para unirse vía la URL
     https://<frontend-url>/m/<public_meeting_id>?p=<public_participant_id>

---

Ejemplo completo con cURL

Crear reunión

curl -X POST https://<backend-url>/public/meetings \
  -H "Content-Type: application/json" \
  -H "x-api-key: zlt_k7a9b2c..." \
  -d '{
    "title": "Demo para cliente",
    "datetime": "2026-03-20T10:00:00Z"
  }'

Agregar host

curl -X POST https://<backend-url>/public/meetings/abc123def456/participants \
  -H "Content-Type: application/json" \
  -H "x-api-key: zlt_k7a9b2c..." \
  -d '{
    "preset_name": "host",
    "name": "Carlos López",
    "externalId": "carlos-001"
  }'

Agregar participante con invitación por email

curl -X POST https://<backend-url>/public/meetings/abc123def456/participants \
  -H "Content-Type: application/json" \
  -H "x-api-key: zlt_k7a9b2c..." \
  -d '{
    "preset_name": "participant",
    "email": "[email protected]",
    "name": "Ana Martínez"
  }'

Cancelar reunión

curl -X PATCH https://<backend-url>/public/meetings/abc123def456 \
  -H "Content-Type: application/json" \
  -H "x-api-key: zlt_k7a9b2c..." \
  -d '{ "status": "CANCELLED" }'