Macros

Uma macro é um pequeno programa JavaScript executado localmente no seu dispositivo. Por exemplo, você pode programar seu dispositivo para atender automaticamente chamadas recebidas de números específicos.

As macros podem executar comandos API (Application Programming Interface, interface de programação de aplicativos) para seus dispositivos, bem como para sistemas de terceiros.

Todas as macros ativas estão em execução em um único processo no dispositivo, chamado de Tempo de execução . Na interface da Web do dispositivo, é possível iniciar e interromper o tempo de execução, conforme a necessidade. O Tempo de execução é caixa de areia, e o código é seguramente isolado do software padrão do dispositivo.

Você pode gerenciar macros a partir do Hub de Controle ou do Editor de Macro na interface da Web do dispositivo. Para configurar macros a partir do Hub de controle, você precisa primeiro ativar o provisionamento de macros para seus dispositivos.

No Hub de controle, você pode ver as alterações feitas nas macros do histórico do dispositivo.

Ramais de IU

Um ramal de UI é um botão ou painel personalizado que você cria e adiciona à tela de toque do dispositivo. Por exemplo, adicione um botão "Discagem rápida" para ligar para um número usado com frequência ou programe seu dispositivo para atender automaticamente chamadas de números específicos.

Os ramais de UI também podem controlar periféricos de terceiros, como luzes, cortinas e comutadores de vídeo. Quando o dispositivo de vídeo e os periféricos são controlados pela mesma interface de usuário, você tem uma experiência de usuário consistente na sala de reunião. A comunicação com os sistemas de controle de terceiros é feita por meio da API de terceiros.

A plataforma aberta permite criar personalizações vinculadas aos seus fluxos de trabalho existentes. dessa forma, permitindo criar valor adicional além da oferta principal webex.

Alguns exemplos incluem:

  • Exibição de dados do servidor da Web personalizados na tela principal.

  • Relatando problemas a um sistema de ticketing.

  • Coleta de dados acústicos da sala e envie-os para um servidor Web onde eles podem ser plotados.

  • Controlando periféricos de terceiros, como luzes, cortinas e comutadores de vídeo.

Você pode criar ramais de UI a partir do Editor de ramais da UI na interface da Web do dispositivo.

A ativação do provisionamento de macro fornece a você acesso de leitura e gravação às macros, dispositivo por dispositivo, a partir do Hub de controle. Depois de ativada, todos os dispositivos registrados no modo compartilhado carregarão suas macros no Hub de Controle. Os administradores podem então editar o código-fonte da macro, fazer download de cópias locais e carregar as macros em outros dispositivos.

Para habilitar o provisionamento de macro, vá para Dispositivos > Settings > Macros no Hub de Controle e ative Permitir Hub de Controle para gerenciar macros .


  • Saiba que todas as macros serão armazenadas e criptografadas na Cisco Cloud. Se as macros contiverem dados confidenciais, você não deverá ativar o provisionamento da macro do Hub de Controle.

  • O provisionamento do hub de controle de macros se aplica apenas a dispositivos de modo compartilhado.


Primeiro, você deve ativar o provisionamento de macros do Hub de Controle, conforme descrito acima.

O provisionamento de macro é fornecido em um único dispositivo. Para compartilhar macros entre dispositivos, você pode baixar uma macro de um dispositivo e fazer o upload dele em outro dispositivo.

Para acessar macros de dispositivos de modo compartilhado:

  1. Na visualização do cliente em https://admin.webex.com, vá para Dispositivos e selecione o dispositivo que deseja configurar.

  2. Vá para Configurações e selecione Macros.


painel Macros do dispositivo do hub de controle

A partir daqui, você pode:

  • Crie, edite e exclua macros.

  • Carregar e baixar macros (*.js).

  • Habilitar ou desabilitar macros.

  • Salvar suas alterações.

  • Exibir logs de macro.


Se alguém tiver editado simultaneamente as mesmas macro(s) de outro local da Web, será apresentada opções para fazer download de uma cópia da sua versão, descartar sua versão ou substituir a outra versão.

O Editor de macro fornece um editor de códigos, ferramentas de registro e controles para testes rápidos de macros.


Macro Editor

Inicie sessão na interface da Web do dispositivo usando credenciais Admin e navegue até Customization > Macro Editor. A partir daqui, você pode:

  • Crie, edite e exclua macros.

  • Importar ou exportar macros (*.js).

  • Habilitar ou desabilitar macros.

  • Revise logs de depuração.

  • Salvar suas alterações (Ctrl+S)


    Se alguém tiver editado simultaneamente a mesma macro em outro local da Web, você terá opções para fazer download de uma cópia da sua versão, descartar sua edição ou substituir a outra versão.

O Editor de ramais da UI fornece ferramentas para criar:

  • Botões de ação - Um botão adicionado à página inicial. O botão de ação pode ser programado para executar ações quando um usuário o toca.

  • Painéis - Um painel de controle pode conter muitos elementos de IU (por exemplo, botões, campos de texto, comutadores, controles deslizantes), que podem ser programados para executar ações. Isso pode permitir que você combine seu próprio grupo de controles em um local comum.

  • Aplicativos Web – Um atalho de aplicativo da Web adicionado à página inicial. O aplicativo Web iniciará uma página da Web predefinida em tela inteira. Isso está disponível em todos os dispositivos com um Web Engine (isto é, dispositivos de placa e série de mesa, excluindo DX).

Inicie sessão na interface da Web do dispositivo usando credenciais Admin, RoomControl ou Integrador e navegue para Personalização > Editor de Ramais de IUI.


Editor de extensões de UI

A partir daqui, você pode:

  • Adicionar, carregar, baixar ou excluir um ramal de UI.

  • Crie e configure vários tipos de controles.

  • Defina um ramal de UI para ativo versus inativo.

  • Defina quando o ramal da UI ficará visível.

  • Exporte seus ramais de UI para o dispositivo de vídeo ou para um arquivo em seu computador.

Para conectar um ramal de IU a uma macro, você precisa usar a ID exclusiva para o item. Por exemplo, a ID para a alternância pode ser "lights_on". Depois, você gravaria uma macro que monitorava as gravações de tela e quando detectou que o botão "lights_on" estava tocado, o comando desejado (por exemplo, ative/apaga as luzes).

Por exemplos, conectando ramais de IU a macros, consulte aqui.