A Signal API
A Signal API do Voco permite que dispositivos externos enviem comandos ao stream ativo sem abrir o painel de administrador. Está disponível nos planos Voco Pro e Network.
A API suporta cinco ações: stream:start, stream:stop, captions:clear, captions:hide e captions:show.
Configuração do Stream Deck (ação de URL)
O botão Site do Stream Deck abre uma URL — o que é suficiente para acionar o endpoint GET da Signal API. Sem plugin necessário.
- 1Encontre sua chave da APIAbra Configurações → API no painel do Voco e copie a chave da API da sua igreja.
- 2Adicione um botão SiteNo Stream Deck, adicione uma ação e escolha o tipo de ação Sistema → Site.
- 3Cole a URL de gatilhoUse o formato de URL abaixo, substituindo YOUR_KEY pela sua chave real.
- 4Defina para abrir em segundo planoAtive 'abrir em segundo plano' para que a URL seja acionada silenciosamente sem abrir uma aba do navegador.
- 5Repita para cada açãoCrie um botão por ação — iniciar, parar, legendas ligadas/desligadas, limpar.
Bitfocus Companion
O Bitfocus Companion suporta ações de requisição HTTP, que funcionam com o endpoint POST da Signal API. Use um botão de Requisição HTTP Genérica e defina o método como POST, a URL como https://voco.church/api/v1/signal, e adicione um corpo JSON com sua chave da API e ação.
O Companion é útil quando você precisa de um controlador de grade de botões completo em vez de um Stream Deck de consumidor, ou ao integrar com fluxos de controle ATEM, vMix ou ProPresenter.
Ações de URL do ProPresenter
Os slides do ProPresenter podem acionar ações de URL quando exibidos. Adicione uma ação de URL a qualquer slide usando o endpoint GET da Signal API — por exemplo, um slide pré-culto que inicia o stream do Voco automaticamente quando é colocado na tela.
Mantenha sua chave da API privada
Não cole sua chave da API em documentos compartilhados, chats de grupos de voluntários ou gravações de transmissões ao vivo. Gire-a em Configurações → API se for exposta.