Streaming

Descargar esquema

Nota: el endpoint Iniciar streaming solo puede usarse para comenzar a transmitir desde un dispositivo Kaleo Connect. Este endpoint no puede usarse para iniciar streaming desde un navegador web. Todos los demás endpoints de streaming controlan tanto navegadores como dispositivos Kaleo Connect.

Obtener estado de streaming

GET

https://babel.withkaleo.com

/v1/church/{churchId}/streaming

Bearer (API key)

Leer la sesión actual y la configuración compartida de la iglesia. Todos los campos están presentes, incluso en estado inactivo.

Obtener estado de streaming › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

Obtener estado de streaming › Respuestas

Éxito

Sesión actual y configuraciones compartidas de la iglesia. Todos los campos están presentes, incluso mientras está inactivo.

StreamingStatus

streaming

boolean · requerido

true durante una sesión activa, incluyendo inicio, reconexiones y cierre. No confirma que el audio esté llegando.

sessionId

string | null · requerido

ID de sesión actual; null mientras está inactivo.

startedAt

string | null · date-time · requerido

Hora de inicio de la sesión actual; null mientras está inactivo.

deadlineAt

string | null · date-time · requerido

Hora de detención automática; null mientras está inactivo o si no hay fecha límite registrada.

speakerLanguage

string | null · requerido

Código de idioma del hablante actual; null mientras está inactivo.

targetLanguages

string[] · requerido

Códigos de idiomas de traducción actuales; vacío mientras está inactivo.

voice

string · enum · requerido

Voz de traducción, incluso mientras está inactivo.

Valores enumerados:

male

female

visible

boolean · requerido

true muestra subtítulos; false los oculta. También aplica mientras está inactivo.

publisher

object | null · requerido

Dispositivo Kaleo Connect o navegador que envía audio; null mientras está inactivo.

phase

string · enum · requerido

Etapa de la sesión; inactivo significa que no hay sesión activa.

Valores enumerados:

idle

starting

streaming

reconnecting

ending

object · requerido

Valores predeterminados de la iglesia para el próximo inicio manual. Las anulaciones de sesión activa no cambian estos valores.

GET/v1/church/{churchId}/streaming

curl https://babel.withkaleo.com/v1/church/:churchId/streaming \
  --header 'Authorization: Bearer <token>'

Ejemplos de respuestas

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Iniciar streaming

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/start

Bearer (API key)

Inicia el streaming en un dispositivo Kaleo Connect usando la configuración guardada. El cuerpo opcional puede seleccionar un deviceId y sobrescribir configuraciones para esta sesión. Sin deviceId, Kaleo selecciona la fuente de audio predeterminada configurada en la página Kaleo Connect (en Integraciones) en tu panel de control si hay múltiples dispositivos con capacidad de audio disponibles, o la única fuente de audio disponible si solo hay una.

Iniciar streaming › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

Iniciar streaming › Cuerpo de la solicitud opcional

StartStreaming

deviceId

string

ID opcional del dispositivo fuente de audio desde GET /devices. Sobrescribe el predeterminado de la iglesia para esta sesión. Si se omite, usa la fuente de audio predeterminada guardada o el único dispositivo emparejado con capacidad de audio; múltiples dispositivos sin predeterminado requieren selección. El dispositivo seleccionado debe estar listo.

object

Configuraciones solo para esta sesión. Los campos omitidos usan valores predeterminados guardados.

Iniciar streaming › Respuestas

Éxito

Sesión actual y configuraciones compartidas de la iglesia. Todos los campos están presentes, incluso mientras está inactivo.

StreamingStatus

streaming

boolean · requerido

true durante una sesión activa, incluyendo inicio, reconexiones y cierre. No confirma que el audio esté llegando.

sessionId

string | null · requerido

ID de sesión actual; null mientras está inactivo.

startedAt

string | null · date-time · requerido

Hora de inicio de la sesión actual; null mientras está inactivo.

deadlineAt

string | null · date-time · requerido

Hora de detención automática; null mientras está inactivo o si no hay fecha límite registrada.

speakerLanguage

string | null · requerido

Código de idioma del hablante actual; null mientras está inactivo.

targetLanguages

string[] · requerido

Códigos de idiomas de traducción actuales; vacío mientras está inactivo.

voice

string · enum · requerido

Voz de traducción, incluso mientras está inactivo.

Valores enumerados:

male

female

visible

boolean · requerido

true muestra subtítulos; false los oculta. También aplica mientras está inactivo.

publisher

object | null · requerido

Dispositivo Kaleo Connect o navegador que envía audio; null mientras está inactivo.

phase

string · enum · requerido

Etapa de la sesión; inactivo significa que no hay sesión activa.

Valores enumerados:

idle

starting

streaming

reconnecting

ending

object · requerido

Valores predeterminados de la iglesia para el próximo inicio manual. Las anulaciones de sesión activa no cambian estos valores.

POST/v1/church/{churchId}/streaming/start

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/start \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{}'

Ejemplo de cuerpo de solicitud

{}

json

application/json

Ejemplos de respuestas

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Detener streaming

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/stop

Bearer (API key)

Detiene la sesión de streaming actual. No se necesita cuerpo en la solicitud.

Detener streaming › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

Detener streaming › Respuestas

Éxito

Sesión actual y configuraciones compartidas de la iglesia. Todos los campos están presentes, incluso mientras está inactivo.

StreamingStatus

streaming

boolean · requerido

true durante una sesión activa, incluyendo inicio, reconexiones y cierre. No confirma que el audio esté llegando.

sessionId

string | null · requerido

ID de sesión actual; null mientras está inactivo.

startedAt

string | null · date-time · requerido

Hora de inicio de la sesión actual; null mientras está inactivo.

deadlineAt

string | null · date-time · requerido

Hora de detención automática; null mientras está inactivo o si no hay fecha límite registrada.

speakerLanguage

string | null · requerido

Código de idioma del hablante actual; null mientras está inactivo.

targetLanguages

string[] · requerido

Códigos de idiomas de traducción actuales; vacío mientras está inactivo.

voice

string · enum · requerido

Voz de traducción, incluso mientras está inactivo.

Valores enumerados:

male

female

visible

boolean · requerido

true muestra subtítulos; false los oculta. También aplica mientras está inactivo.

publisher

object | null · requerido

Dispositivo Kaleo Connect o navegador que envía audio; null mientras está inactivo.

phase

string · enum · requerido

Etapa de la sesión; inactivo significa que no hay sesión activa.

Valores enumerados:

idle

starting

streaming

reconnecting

ending

object · requerido

Valores predeterminados de la iglesia para el próximo inicio manual. Las anulaciones de sesión activa no cambian estos valores.

Cambiar voz de traducción

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/voice

Bearer (API key)

Cambiar la voz de traducción mientras está inactivo o transmitiendo.

Cambiar voz de traducción › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

Cambiar voz de traducción › Cuerpo de la solicitud

ChangeVoice

voice

string · enum · requerido

Voz de traducción. Puede cambiarse mientras está inactivo o transmitiendo.

Valores enumerados:

male

female

Cambiar voz de traducción › Respuestas

Éxito

Sesión actual y configuraciones compartidas de la iglesia. Todos los campos están presentes, incluso mientras está inactivo.

StreamingStatus

streaming

boolean · requerido

true durante una sesión activa, incluyendo inicio, reconexiones y cierre. No confirma que el audio esté llegando.

sessionId

string | null · requerido

ID de sesión actual; null mientras está inactivo.

startedAt

string | null · date-time · requerido

Hora de inicio de la sesión actual; null mientras está inactivo.

deadlineAt

string | null · date-time · requerido

Hora de detención automática; null mientras está inactivo o si no hay fecha límite registrada.

speakerLanguage

string | null · requerido

Código de idioma del hablante actual; null mientras está inactivo.

targetLanguages

string[] · requerido

Códigos de idiomas de traducción actuales; vacío mientras está inactivo.

voice

string · enum · requerido

Voz de traducción, incluso mientras está inactivo.

Valores enumerados:

male

female

visible

boolean · requerido

true muestra subtítulos; false los oculta. También aplica mientras está inactivo.

publisher

object | null · requerido

Dispositivo Kaleo Connect o navegador que envía audio; null mientras está inactivo.

phase

string · enum · requerido

Etapa de la sesión; inactivo significa que no hay sesión activa.

Valores enumerados:

idle

starting

streaming

reconnecting

ending

object · requerido

Valores predeterminados de la iglesia para el próximo inicio manual. Las anulaciones de sesión activa no cambian estos valores.

PATCH/v1/church/{churchId}/streaming/voice

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/voice \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "voice": "female"
}'

Ejemplo de cuerpo de solicitud

{
  "voice": "female"
}

json

application/json

Ejemplos de respuestas

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "female",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Cambiar visibilidad

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/visibility

Bearer (API key)

Mostrar u ocultar subtítulos mientras está inactivo o transmitiendo. Ocultar subtítulos no detiene la sesión.

Cambiar visibilidad › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

Cambiar visibilidad › Cuerpo de la solicitud

ChangeVisibility

visible

boolean · requerido

true muestra subtítulos; false los oculta mientras el streaming continúa.

Cambiar visibilidad › Respuestas

Éxito

Sesión actual y configuraciones compartidas de la iglesia. Todos los campos están presentes, incluso mientras está inactivo.

StreamingStatus

streaming

boolean · requerido

true durante una sesión activa, incluyendo inicio, reconexiones y cierre. No confirma que el audio esté llegando.

sessionId

string | null · requerido

ID de sesión actual; null mientras está inactivo.

startedAt

string | null · date-time · requerido

Hora de inicio de la sesión actual; null mientras está inactivo.

deadlineAt

string | null · date-time · requerido

Hora de detención automática; null mientras está inactivo o si no hay fecha límite registrada.

speakerLanguage

string | null · requerido

Código de idioma del hablante actual; null mientras está inactivo.

targetLanguages

string[] · requerido

Códigos de idiomas de traducción actuales; vacío mientras está inactivo.

voice

string · enum · requerido

Voz de traducción, incluso mientras está inactivo.

Valores enumerados:

male

female

visible

boolean · requerido

true muestra subtítulos; false los oculta. También aplica mientras está inactivo.

publisher

object | null · requerido

Dispositivo Kaleo Connect o navegador que envía audio; null mientras está inactivo.

phase

string · enum · requerido

Etapa de la sesión; inactivo significa que no hay sesión activa.

Valores enumerados:

idle

starting

streaming

reconnecting

ending

object · requerido

Valores predeterminados de la iglesia para el próximo inicio manual. Las anulaciones de sesión activa no cambian estos valores.

PATCH/v1/church/{churchId}/streaming/visibility

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/visibility \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "visible": false
}'

Ejemplo de cuerpo de solicitud

{
  "visible": false
}

json

application/json

Ejemplos de respuestas

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": false,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Borrar subtítulos

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/captions/clear

Bearer (API key)

Borra el feed actual de subtítulos. No se necesita cuerpo en la solicitud.

Borrar subtítulos › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

Borrar subtítulos › Respuestas

Éxito

Sesión actual y configuraciones compartidas de la iglesia. Todos los campos están presentes, incluso mientras está inactivo.

StreamingStatus

streaming

boolean · requerido

true durante una sesión activa, incluyendo inicio, reconexiones y cierre. No confirma que el audio esté llegando.

sessionId

string | null · requerido

ID de sesión actual; null mientras está inactivo.

startedAt

string | null · date-time · requerido

Hora de inicio de la sesión actual; null mientras está inactivo.

deadlineAt

string | null · date-time · requerido

Hora de detención automática; null mientras está inactivo o si no hay fecha límite registrada.

speakerLanguage

string | null · requerido

Código de idioma del hablante actual; null mientras está inactivo.

targetLanguages

string[] · requerido

Códigos de idiomas de traducción actuales; vacío mientras está inactivo.

voice

string · enum · requerido

Voz de traducción, incluso mientras está inactivo.

Valores enumerados:

male

female

visible

boolean · requerido

true muestra subtítulos; false los oculta. También aplica mientras está inactivo.

publisher

object | null · requerido

Dispositivo Kaleo Connect o navegador que envía audio; null mientras está inactivo.

phase

string · enum · requerido

Etapa de la sesión; inactivo significa que no hay sesión activa.

Valores enumerados:

idle

starting

streaming

reconnecting

ending

object · requerido

Valores predeterminados de la iglesia para el próximo inicio manual. Las anulaciones de sesión activa no cambian estos valores.

POST/v1/church/{churchId}/streaming/captions/clear

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/captions/clear \
  --request POST \
  --header 'Authorization: Bearer <token>'

Ejemplos de respuestas

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Cambiar fecha límite de auto-detención

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/deadline

Bearer (API key)

Establece la hora de auto-detención para una sesión activa. Devuelve el estado actualizado del streaming.

Cambiar fecha límite de auto-detención › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

Cambiar fecha límite de auto-detención › Cuerpo de la solicitud

ChangeDeadline

deadlineAt

string · date-time · requerido

Hora futura de auto-detención con Z o desplazamiento horario. No más tarde de seis horas después de startedAt.

Cambiar fecha límite de auto-detención › Respuestas

Éxito

Sesión actual y configuraciones compartidas de la iglesia. Todos los campos están presentes, incluso mientras está inactivo.

StreamingStatus

streaming

boolean · requerido

true durante una sesión activa, incluyendo inicio, reconexiones y cierre. No confirma que el audio esté llegando.

sessionId

string | null · requerido

ID de sesión actual; null mientras está inactivo.

startedAt

string | null · date-time · requerido

Hora de inicio de la sesión actual; null mientras está inactivo.

deadlineAt

string | null · date-time · requerido

Hora de detención automática; null mientras está inactivo o si no hay fecha límite registrada.

speakerLanguage

string | null · requerido

Código de idioma del hablante actual; null mientras está inactivo.

targetLanguages

string[] · requerido

Códigos de idiomas de traducción actuales; vacío mientras está inactivo.

voice

string · enum · requerido

Voz de traducción, incluso mientras está inactivo.

Valores enumerados:

male

female

visible

boolean · requerido

true muestra subtítulos; false los oculta. También aplica mientras está inactivo.

publisher

object | null · requerido

Dispositivo Kaleo Connect o navegador que envía audio; null mientras está inactivo.

phase

string · enum · requerido

Etapa de la sesión; inactivo significa que no hay sesión activa.

Valores enumerados:

idle

starting

streaming

reconnecting

ending

object · requerido

Valores predeterminados de la iglesia para el próximo inicio manual. Las anulaciones de sesión activa no cambian estos valores.

PATCH/v1/church/{churchId}/streaming/deadline

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/deadline \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "deadlineAt": "2026-10-08T16:00:00Z"
}'

Ejemplo de cuerpo de solicitud

{
  "deadlineAt": "2026-10-08T16:00:00Z"
}

json

application/json

Ejemplos de respuestas

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Ajustar tiempo de auto-detención

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/deadline/adjust

Bearer (API key)

Sumar o restar tiempo de auto-detención. Mientras está inactivo, cambia la duración para el próximo inicio manual. Mientras transmite, cambia la fecha límite actual. Cada solicitud aplica un ajuste separado.

Ajustar tiempo de auto-detención › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

Ajustar tiempo de auto-detención › Cuerpo de la solicitud

AdjustDeadline

deltaSeconds

integer · min: -21600 · max: 21600 · requerido

Segundos para añadir a la duración inactiva o fecha límite actual; valores negativos restan. No puede ser 0. Duración inactiva: 60–21600 segundos. Fecha límite en vivo: futura, dentro de seis horas de startedAt.

Ajustar tiempo de auto-detención › Respuestas

Éxito

Sesión actual y configuraciones compartidas de la iglesia. Todos los campos están presentes, incluso mientras está inactivo.

StreamingStatus

streaming

boolean · requerido

true durante una sesión activa, incluyendo inicio, reconexiones y cierre. No confirma que el audio esté llegando.

sessionId

string | null · requerido

ID de sesión actual; null mientras está inactivo.

startedAt

string | null · date-time · requerido

Hora de inicio de la sesión actual; null mientras está inactivo.

deadlineAt

string | null · date-time · requerido

Hora de detención automática; null mientras está inactivo o si no hay fecha límite registrada.

speakerLanguage

string | null · requerido

Código de idioma del hablante actual; null mientras está inactivo.

targetLanguages

string[] · requerido

Códigos de idiomas de traducción actuales; vacío mientras está inactivo.

voice

string · enum · requerido

Voz de traducción, incluso mientras está inactivo.

Valores enumerados:

male

female

visible

boolean · requerido

true muestra subtítulos; false los oculta. También aplica mientras está inactivo.

publisher

object | null · requerido

Dispositivo Kaleo Connect o navegador que envía audio; null mientras está inactivo.

phase

string · enum · requerido

Etapa de la sesión; inactivo significa que no hay sesión activa.

Valores enumerados:

idle

starting

streaming

reconnecting

ending

object · requerido

Valores predeterminados de la iglesia para el próximo inicio manual. Las anulaciones de sesión activa no cambian estos valores.

POST/v1/church/{churchId}/streaming/deadline/adjust

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/deadline/adjust \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "deltaSeconds": 120
}'

Ejemplo de cuerpo de solicitud

{
  "deltaSeconds": 120
}

json

application/json

Ejemplos de respuestas

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Dispositivos Sesiones

API de Kaleo

Streaming

Descargar esquema

Obtener estado de streaming

GET

https://babel.withkaleo.com

/v1/church/{churchId}/streaming

Bearer (API key)

Leer la sesión actual y la configuración compartida de la iglesia. Todos los campos están presentes, incluso en estado inactivo.

Obtener estado de streaming › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

Obtener estado de streaming › Respuestas

Éxito

Sesión actual y configuraciones compartidas de la iglesia. Todos los campos están presentes, incluso mientras está inactivo.

StreamingStatus

streaming

boolean · requerido

true durante una sesión activa, incluyendo inicio, reconexiones y cierre. No confirma que el audio esté llegando.

sessionId

string | null · requerido

ID de sesión actual; null mientras está inactivo.

startedAt

string | null · date-time · requerido

Hora de inicio de la sesión actual; null mientras está inactivo.

deadlineAt

string | null · date-time · requerido

Hora de detención automática; null mientras está inactivo o si no hay fecha límite registrada.

speakerLanguage

string | null · requerido

Código de idioma del hablante actual; null mientras está inactivo.

targetLanguages

string[] · requerido

Códigos de idiomas de traducción actuales; vacío mientras está inactivo.

voice

string · enum · requerido

Voz de traducción, incluso mientras está inactivo.

Valores enumerados:

male

female

visible

boolean · requerido

true muestra subtítulos; false los oculta. También aplica mientras está inactivo.

publisher

object | null · requerido

Dispositivo Kaleo Connect o navegador que envía audio; null mientras está inactivo.

phase

string · enum · requerido

Etapa de la sesión; inactivo significa que no hay sesión activa.

Valores enumerados:

idle

starting

streaming

reconnecting

ending

object · requerido

Valores predeterminados de la iglesia para el próximo inicio manual. Las anulaciones de sesión activa no cambian estos valores.

GET/v1/church/{churchId}/streaming

curl https://babel.withkaleo.com/v1/church/:churchId/streaming \
  --header 'Authorization: Bearer <token>'

Ejemplos de respuestas

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Iniciar streaming

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/start

Bearer (API key)

Iniciar streaming › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

Iniciar streaming › Cuerpo de la solicitud opcional

StartStreaming

deviceId

string

object

Configuraciones solo para esta sesión. Los campos omitidos usan valores predeterminados guardados.

Iniciar streaming › Respuestas

Éxito

Sesión actual y configuraciones compartidas de la iglesia. Todos los campos están presentes, incluso mientras está inactivo.

StreamingStatus

streaming

boolean · requerido

true durante una sesión activa, incluyendo inicio, reconexiones y cierre. No confirma que el audio esté llegando.

sessionId

string | null · requerido

ID de sesión actual; null mientras está inactivo.

startedAt

string | null · date-time · requerido

Hora de inicio de la sesión actual; null mientras está inactivo.

deadlineAt

string | null · date-time · requerido

Hora de detención automática; null mientras está inactivo o si no hay fecha límite registrada.

speakerLanguage

string | null · requerido

Código de idioma del hablante actual; null mientras está inactivo.

targetLanguages

string[] · requerido

Códigos de idiomas de traducción actuales; vacío mientras está inactivo.

voice

string · enum · requerido

Voz de traducción, incluso mientras está inactivo.

Valores enumerados:

male

female

visible

boolean · requerido

true muestra subtítulos; false los oculta. También aplica mientras está inactivo.

publisher

object | null · requerido

Dispositivo Kaleo Connect o navegador que envía audio; null mientras está inactivo.

phase

string · enum · requerido

Etapa de la sesión; inactivo significa que no hay sesión activa.

Valores enumerados:

idle

starting

streaming

reconnecting

ending

object · requerido

Valores predeterminados de la iglesia para el próximo inicio manual. Las anulaciones de sesión activa no cambian estos valores.

POST/v1/church/{churchId}/streaming/start

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/start \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{}'

Ejemplo de cuerpo de solicitud

{}

json

application/json

Ejemplos de respuestas

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Detener streaming

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/stop

Bearer (API key)

Detiene la sesión de streaming actual. No se necesita cuerpo en la solicitud.

Detener streaming › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

Detener streaming › Respuestas

Éxito

Sesión actual y configuraciones compartidas de la iglesia. Todos los campos están presentes, incluso mientras está inactivo.

StreamingStatus

streaming

boolean · requerido

true durante una sesión activa, incluyendo inicio, reconexiones y cierre. No confirma que el audio esté llegando.

sessionId

string | null · requerido

ID de sesión actual; null mientras está inactivo.

startedAt

string | null · date-time · requerido

Hora de inicio de la sesión actual; null mientras está inactivo.

deadlineAt

string | null · date-time · requerido

Hora de detención automática; null mientras está inactivo o si no hay fecha límite registrada.

speakerLanguage

string | null · requerido

Código de idioma del hablante actual; null mientras está inactivo.

targetLanguages

string[] · requerido

Códigos de idiomas de traducción actuales; vacío mientras está inactivo.

voice

string · enum · requerido

Voz de traducción, incluso mientras está inactivo.

Valores enumerados:

male

female

visible

boolean · requerido

true muestra subtítulos; false los oculta. También aplica mientras está inactivo.

publisher

object | null · requerido

Dispositivo Kaleo Connect o navegador que envía audio; null mientras está inactivo.

phase

string · enum · requerido

Etapa de la sesión; inactivo significa que no hay sesión activa.

Valores enumerados:

idle

starting

streaming

reconnecting

ending

object · requerido

Valores predeterminados de la iglesia para el próximo inicio manual. Las anulaciones de sesión activa no cambian estos valores.

Cambiar voz de traducción

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/voice

Bearer (API key)

Cambiar la voz de traducción mientras está inactivo o transmitiendo.

Cambiar voz de traducción › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

Cambiar voz de traducción › Cuerpo de la solicitud

ChangeVoice

voice

string · enum · requerido

Voz de traducción. Puede cambiarse mientras está inactivo o transmitiendo.

Valores enumerados:

male

female

Cambiar voz de traducción › Respuestas

Éxito

Sesión actual y configuraciones compartidas de la iglesia. Todos los campos están presentes, incluso mientras está inactivo.

StreamingStatus

streaming

boolean · requerido

true durante una sesión activa, incluyendo inicio, reconexiones y cierre. No confirma que el audio esté llegando.

sessionId

string | null · requerido

ID de sesión actual; null mientras está inactivo.

startedAt

string | null · date-time · requerido

Hora de inicio de la sesión actual; null mientras está inactivo.

deadlineAt

string | null · date-time · requerido

Hora de detención automática; null mientras está inactivo o si no hay fecha límite registrada.

speakerLanguage

string | null · requerido

Código de idioma del hablante actual; null mientras está inactivo.

targetLanguages

string[] · requerido

Códigos de idiomas de traducción actuales; vacío mientras está inactivo.

voice

string · enum · requerido

Voz de traducción, incluso mientras está inactivo.

Valores enumerados:

male

female

visible

boolean · requerido

true muestra subtítulos; false los oculta. También aplica mientras está inactivo.

publisher

object | null · requerido

Dispositivo Kaleo Connect o navegador que envía audio; null mientras está inactivo.

phase

string · enum · requerido

Etapa de la sesión; inactivo significa que no hay sesión activa.

Valores enumerados:

idle

starting

streaming

reconnecting

ending

object · requerido

Valores predeterminados de la iglesia para el próximo inicio manual. Las anulaciones de sesión activa no cambian estos valores.

PATCH/v1/church/{churchId}/streaming/voice

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/voice \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "voice": "female"
}'

Ejemplo de cuerpo de solicitud

{
  "voice": "female"
}

json

application/json

Ejemplos de respuestas

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "female",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Cambiar visibilidad

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/visibility

Bearer (API key)

Mostrar u ocultar subtítulos mientras está inactivo o transmitiendo. Ocultar subtítulos no detiene la sesión.

Cambiar visibilidad › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

Cambiar visibilidad › Cuerpo de la solicitud

ChangeVisibility

visible

boolean · requerido

true muestra subtítulos; false los oculta mientras el streaming continúa.

Cambiar visibilidad › Respuestas

Éxito

Sesión actual y configuraciones compartidas de la iglesia. Todos los campos están presentes, incluso mientras está inactivo.

StreamingStatus

streaming

boolean · requerido

true durante una sesión activa, incluyendo inicio, reconexiones y cierre. No confirma que el audio esté llegando.

sessionId

string | null · requerido

ID de sesión actual; null mientras está inactivo.

startedAt

string | null · date-time · requerido

Hora de inicio de la sesión actual; null mientras está inactivo.

deadlineAt

string | null · date-time · requerido

Hora de detención automática; null mientras está inactivo o si no hay fecha límite registrada.

speakerLanguage

string | null · requerido

Código de idioma del hablante actual; null mientras está inactivo.

targetLanguages

string[] · requerido

Códigos de idiomas de traducción actuales; vacío mientras está inactivo.

voice

string · enum · requerido

Voz de traducción, incluso mientras está inactivo.

Valores enumerados:

male

female

visible

boolean · requerido

true muestra subtítulos; false los oculta. También aplica mientras está inactivo.

publisher

object | null · requerido

Dispositivo Kaleo Connect o navegador que envía audio; null mientras está inactivo.

phase

string · enum · requerido

Etapa de la sesión; inactivo significa que no hay sesión activa.

Valores enumerados:

idle

starting

streaming

reconnecting

ending

object · requerido

Valores predeterminados de la iglesia para el próximo inicio manual. Las anulaciones de sesión activa no cambian estos valores.

PATCH/v1/church/{churchId}/streaming/visibility

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/visibility \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "visible": false
}'

Ejemplo de cuerpo de solicitud

{
  "visible": false
}

json

application/json

Ejemplos de respuestas

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": false,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Borrar subtítulos

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/captions/clear

Bearer (API key)

Borra el feed actual de subtítulos. No se necesita cuerpo en la solicitud.

Borrar subtítulos › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

Borrar subtítulos › Respuestas

Éxito

Sesión actual y configuraciones compartidas de la iglesia. Todos los campos están presentes, incluso mientras está inactivo.

StreamingStatus

streaming

boolean · requerido

true durante una sesión activa, incluyendo inicio, reconexiones y cierre. No confirma que el audio esté llegando.

sessionId

string | null · requerido

ID de sesión actual; null mientras está inactivo.

startedAt

string | null · date-time · requerido

Hora de inicio de la sesión actual; null mientras está inactivo.

deadlineAt

string | null · date-time · requerido

Hora de detención automática; null mientras está inactivo o si no hay fecha límite registrada.

speakerLanguage

string | null · requerido

Código de idioma del hablante actual; null mientras está inactivo.

targetLanguages

string[] · requerido

Códigos de idiomas de traducción actuales; vacío mientras está inactivo.

voice

string · enum · requerido

Voz de traducción, incluso mientras está inactivo.

Valores enumerados:

male

female

visible

boolean · requerido

true muestra subtítulos; false los oculta. También aplica mientras está inactivo.

publisher

object | null · requerido

Dispositivo Kaleo Connect o navegador que envía audio; null mientras está inactivo.

phase

string · enum · requerido

Etapa de la sesión; inactivo significa que no hay sesión activa.

Valores enumerados:

idle

starting

streaming

reconnecting

ending

object · requerido

Valores predeterminados de la iglesia para el próximo inicio manual. Las anulaciones de sesión activa no cambian estos valores.

POST/v1/church/{churchId}/streaming/captions/clear

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/captions/clear \
  --request POST \
  --header 'Authorization: Bearer <token>'

Ejemplos de respuestas

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Cambiar fecha límite de auto-detención

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/deadline

Bearer (API key)

Establece la hora de auto-detención para una sesión activa. Devuelve el estado actualizado del streaming.

Cambiar fecha límite de auto-detención › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

Cambiar fecha límite de auto-detención › Cuerpo de la solicitud

ChangeDeadline

deadlineAt

string · date-time · requerido

Hora futura de auto-detención con Z o desplazamiento horario. No más tarde de seis horas después de startedAt.

Cambiar fecha límite de auto-detención › Respuestas

Éxito

Sesión actual y configuraciones compartidas de la iglesia. Todos los campos están presentes, incluso mientras está inactivo.

StreamingStatus

streaming

boolean · requerido

true durante una sesión activa, incluyendo inicio, reconexiones y cierre. No confirma que el audio esté llegando.

sessionId

string | null · requerido

ID de sesión actual; null mientras está inactivo.

startedAt

string | null · date-time · requerido

Hora de inicio de la sesión actual; null mientras está inactivo.

deadlineAt

string | null · date-time · requerido

Hora de detención automática; null mientras está inactivo o si no hay fecha límite registrada.

speakerLanguage

string | null · requerido

Código de idioma del hablante actual; null mientras está inactivo.

targetLanguages

string[] · requerido

Códigos de idiomas de traducción actuales; vacío mientras está inactivo.

voice

string · enum · requerido

Voz de traducción, incluso mientras está inactivo.

Valores enumerados:

male

female

visible

boolean · requerido

true muestra subtítulos; false los oculta. También aplica mientras está inactivo.

publisher

object | null · requerido

Dispositivo Kaleo Connect o navegador que envía audio; null mientras está inactivo.

phase

string · enum · requerido

Etapa de la sesión; inactivo significa que no hay sesión activa.

Valores enumerados:

idle

starting

streaming

reconnecting

ending

object · requerido

Valores predeterminados de la iglesia para el próximo inicio manual. Las anulaciones de sesión activa no cambian estos valores.

PATCH/v1/church/{churchId}/streaming/deadline

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/deadline \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "deadlineAt": "2026-10-08T16:00:00Z"
}'

Ejemplo de cuerpo de solicitud

{
  "deadlineAt": "2026-10-08T16:00:00Z"
}

json

application/json

Ejemplos de respuestas

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Ajustar tiempo de auto-detención

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/deadline/adjust

Bearer (API key)

Ajustar tiempo de auto-detención › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

Ajustar tiempo de auto-detención › Cuerpo de la solicitud

AdjustDeadline

deltaSeconds

integer · min: -21600 · max: 21600 · requerido

Ajustar tiempo de auto-detención › Respuestas

Éxito

Sesión actual y configuraciones compartidas de la iglesia. Todos los campos están presentes, incluso mientras está inactivo.

StreamingStatus

streaming

boolean · requerido

true durante una sesión activa, incluyendo inicio, reconexiones y cierre. No confirma que el audio esté llegando.

sessionId

string | null · requerido

ID de sesión actual; null mientras está inactivo.

startedAt

string | null · date-time · requerido

Hora de inicio de la sesión actual; null mientras está inactivo.

deadlineAt

string | null · date-time · requerido

Hora de detención automática; null mientras está inactivo o si no hay fecha límite registrada.

speakerLanguage

string | null · requerido

Código de idioma del hablante actual; null mientras está inactivo.

targetLanguages

string[] · requerido

Códigos de idiomas de traducción actuales; vacío mientras está inactivo.

voice

string · enum · requerido

Voz de traducción, incluso mientras está inactivo.

Valores enumerados:

male

female

visible

boolean · requerido

true muestra subtítulos; false los oculta. También aplica mientras está inactivo.

publisher

object | null · requerido

Dispositivo Kaleo Connect o navegador que envía audio; null mientras está inactivo.

phase

string · enum · requerido

Etapa de la sesión; inactivo significa que no hay sesión activa.

Valores enumerados:

idle

starting

streaming

reconnecting

ending

object · requerido

Valores predeterminados de la iglesia para el próximo inicio manual. Las anulaciones de sesión activa no cambian estos valores.

POST/v1/church/{churchId}/streaming/deadline/adjust

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/deadline/adjust \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "deltaSeconds": 120
}'

Ejemplo de cuerpo de solicitud

{
  "deltaSeconds": 120
}

json

application/json

Ejemplos de respuestas

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Dispositivos Sesiones