La API de señal
La API Signal de Voco permite que los dispositivos externos envíen comandos a la transmisión activa sin abrir el panel de administración. Está disponible en los planes Voco Pro y Network.
La API admite cinco acciones: transmitir: iniciar, transmitir: detener, subtítulos: borrar, subtítulos: ocultar y subtítulos: mostrar.
Configuración de Stream Deck (acción de URL)
Para herramientas que admitan encabezados HTTP personalizados, utilice POST con un encabezado de Autorización. Esto mantiene su clave API fuera de las URL, el historial del navegador y los registros del servidor.
El botón de sitio web básico de Stream Deck aún puede usar un activador de URL cuando no hay ninguna acción basada en encabezado disponible, pero trata ese perfil de botón como una contraseña y rota la clave si se comparte.
- 1Encuentra tu clave APIAbra Configuración → API en el panel Voco y copie la clave API de su iglesia.
- 2Utilice una acción con capacidad de encabezado siempre que sea posibleEstablezca el método en POST, la URL en https://voco.church/api/v1/signal y agregue Autorización: Portador YOUR_KEY.
- 3enviar la acciónEnvíe JSON como { "action": "stream:start" } para cada botón.
- 4Solo respaldo: activador de URLSi su herramienta no puede enviar encabezados, use el formato de URL a continuación y mantenga privado el perfil Stream Deck.
- 5Repetir para cada acción.Cree un botón por acción: iniciar, detener, activar/desactivar subtítulos, borrar.
Compañero de BitFocus
Bitfocus Companion admite acciones de solicitud HTTP, que funcionan con el punto final POST de Signal API. Utilice un botón de Solicitud HTTP genérica y establezca el método en POST, la URL en https://voco.church/api/v1/signal y envíe un encabezado de Autorización o un cuerpo JSON con su clave API y acción.
Companion es útil cuando necesita un controlador de cuadrícula de botones completo en lugar de un Stream Deck de consumo, o cuando se integra con flujos de trabajo de control ATEM, vMix o ProPresenter.
ProPresenter acciones de URL
Las diapositivas ProPresenter pueden activar acciones de URL cuando se muestran. Agregue una acción de URL a cualquier diapositiva utilizando el punto final GET de Signal API; por ejemplo, una diapositiva previa al servicio que inicia la transmisión Voco automáticamente cuando se muestra en la pantalla.
Mantenga su clave API privada
No pegue su clave API en documentos compartidos, chats de grupos de voluntarios o grabaciones de transmisiones en vivo. Las herramientas de activación de URL pueden almacenar la clave en su configuración, así que mantenga esos archivos privados y rote la clave desde Configuración → API si está expuesta.