Como criar automações a partir de eventos de aplicativos importados

Aplicativos instalados do Marketplace podem expor fluxos de eventos ao vivo para o SheevChat. Evento de aplicação importado gatilho transforma esses valores mapeados em gatilhos de Automação e variáveis.

Requisitos

  • Instale uma aplicação que forneça um ou mais fluxos de eventos.
  • Complete sua conexão ou autenticação requerida.
  • Confirme suas listas de cartões de aplicativos instalados Fluxos de eventos.

Os eventos exatos dependem do pacote. Exemplos podem incluir um estado do dispositivo, evento smart-home, estado da aplicação, cena ativa, pontuação ou outro valor fornecido pela aplicação conectada.

Preparar o fluxo de eventos

  1. Abrir Marketplace → Aplicativos instalados.
  2. Encontre o aplicativo e expanda Fluxos de eventos.
  3. Ligar Activado.
  4. Ligar Automações de rotas.
  5. Activar Início automático e deve começar sempre que o SheevChat abrir.
  6. Activar Religar quando o fluxo deve recuperar após perder sua conexão.
  7. Clique Iniciar para um fluxo manual.

A placa de transmissão mostra seu status, contagem de eventos, último evento, valores mapeados e {event.key} variáveis que fornece.

Criar a Automação

  1. Abrir Comandos de Bot → Automaçãos.
  2. Clique Novo.
  3. Digite um nome limpo.
  4. Selecionar Evento de aplicação importado como o Evento do Trigger.
  5. Escolha o instalado Biblioteca de ações.
  6. Escolha a sua Fluxo de eventos.
  7. Introduza opcionalmente um Chave de valor mapeada.
  8. Opcionalmente, digite o valor que deve ser igual.
  9. Adicione uma ou mais ações.
  10. Salve a Automação.

Escolha um aplicativo e fluxo de eventos específicos para uso normal.Deixando-os amplos pode permitir que eventos importados não relacionados disparem a mesma Automação.

Filtro por um Valor Mapeado

Suponha que o fluxo forneça:

{event.state}

Para correr apenas quando esse estado ficar pronto:

Mapped value key: state
Mapped value equals: ready

A comparação não é sensível à maiúsculas. Se você fornecer uma chave sem um valor esperado, a Automação corresponde quando esse valor mapeado existe e não está vazio.

Usar Variáveis de Evento

Cada evento de aplicativo importado pode fornecer variáveis gerais, tais como:

{app}
{library}
{libraryId}
{eventStream}
{eventStreamId}
{eventText}
{eventJson}

Valores mapeados definidos em pacote aparecem como variáveis como {event.state}, {event.user}, ou {event.scene}. Use os chips variáveis exibidos pelo stream ou auxiliar de Automação em vez de adivinhar seus nomes.

Acção da mensagem de exemplo:

The {app} status changed to {event.state}.

Teste com um Evento de Amostra

  1. Salve a Automação.
  2. Voltar para Marketplace → Apps instalados → Streams de eventos.
  3. Rever ou editar Valores mapeados por amostra. Deve conter um objeto JSON.
  4. Clique Enviar Amostra.
  5. Confirme as execuções de Automação e suas variáveis resolvem corretamente.

Uma amostra é gerada localmente e não contacta ou controla o aplicativo de terceiros. Depois disso, teste um evento real e verifique a contagem de eventos do fluxo, os valores mais recentes e o timestamp de Automação.

Problemas Comuns

  • Não aparecem aplicações ou fluxos: Instale ou reload um pacote que declara os fluxos de eventos.
  • O fluxo está parado: Active- o e clique em Iniciar ou em Iniciar automaticamente.
  • Os eventos chegam mas a Automation não é executada: Habilite automações de rota e verifique o aplicativo, fluxo, chave e valor esperado selecionado.
  • A variável aparece literalmente: Use uma das variáveis de saída mapeadas mostradas para esse fluxo.
  • Falha na amostra do JSON: Digite um objeto JSON como {"state":"ready"}.
  • Desligações do fluxo: Teste sua conexão e habilite a conexão novamente se o pacote a suportar.
  • Eventos repetidos disparam com demasiada frequência: Adicione um arrefecimento Automation ou reduza o filtro de valor mapeado.