La API Signal
La API Signal de Voco permite que los dispositivos externos envíen comandos al stream activo sin abrir el panel de administrador. Está disponible en los planes Voco Pro y Network.
La API admite cinco acciones: stream:start, stream:stop, captions:clear, captions:hide y captions:show.
Configuración de Stream Deck (acción de URL)
El botón Sitio web de Stream Deck abre una URL — lo que es suficiente para activar el endpoint GET de la API Signal. No se necesita ningún complemento.
- 1Encuentra tu clave de APIAbre Ajustes → API en el panel de Voco y copia tu clave de API de la iglesia.
- 2Añade un botón Sitio webEn Stream Deck, añade una acción y elige el tipo de acción Sistema → Sitio web.
- 3Pega la URL de activaciónUsa el formato de URL que aparece a continuación, sustituyendo TU_CLAVE por tu clave real.
- 4Configura abrir en segundo planoActiva 'abrir en segundo plano' para que la URL se active en silencio sin abrir una pestaña del navegador.
- 5Repite para cada acciónCrea un botón por acción — iniciar, detener, subtítulos activados/desactivados, borrar.
Bitfocus Companion
Bitfocus Companion admite acciones de solicitud HTTP, que funcionan con el endpoint POST de la API Signal. Usa un botón de Solicitud HTTP Genérica y configura el método como POST, la URL como https://voco.church/api/v1/signal y añade un cuerpo JSON con tu clave de API y la acción.
Companion es útil cuando necesitas un controlador de cuadrícula de botones completo en lugar de un Stream Deck de consumidor, o cuando estás integrando flujos de trabajo de control de ATEM, vMix o ProPresenter.
Acciones de URL de ProPresenter
Las diapositivas de ProPresenter pueden activar acciones de URL cuando se muestran. Añade una acción de URL a cualquier diapositiva usando el endpoint GET de la API Signal — por ejemplo, una diapositiva previa al culto que inicia el stream de Voco automáticamente cuando se proyecta.
Mantén tu clave de API privada
No pegues tu clave de API en documentos compartidos, chats de grupos de voluntarios ni grabaciones de retransmisiones. Rótala desde Ajustes → API si queda expuesta.