Tipos de gatilho

Concluído

Por padrão, os tópicos usam o gatilho Frases, que é ativado quando uma ou mais de suas frases de gatilho correspondem a uma mensagem recebida de um usuário. Há outros tipos de gatilhos disponíveis que determinam quando um tópico deve ser executado.

Tipos de gatilho

Os gatilhos permitem interceptar e lidar com atividades de diferentes tipos. Os tipos de gatilho a seguir determinam quando um tópico deve ser disparado.

Tipo Descrição
Frases Quando uma ou mais frases de gatilho correspondem à mensagem recebida de um usuário
Atividade recebida Quando uma Atividade de qualquer tipo é recebida
Mensagem recebida Quando uma Atividade do tipo mensagem é recebida. O tipo de Atividade mais comum. Recebido quando um usuário digita ou diz algo ao copiloto.
Evento recebido Quando uma Atividade do tipo evento é recebida
Atualização da conversa recebida Quando uma Atividade do tipo conversationUpdate é recebida. Por exemplo, o Teams envia uma atividade desse tipo quando um usuário ingressa em uma conversa.
Invocação recebida Quando uma Atividade do tipo invocar é recebida. Mais comumente recebida do canal do Teams. Por exemplo, quando o usuário interage com uma extensão de Mensagem ou Pesquisa no aplicativo Teams.
Inatividade Quando um usuário não interagiu com o copiloto ao longo do tempo. O período pode ser configurado.

Dica

Quando um usuário envia uma mensagem a um copiloto, o conteúdo é um tipo de mensagem de Atividade.

Os copilotos podem receber atividades de outros tipos com novas alterações no chat. Por exemplo, o Microsoft Teams envia atividades ocultas do tipo invocar, o que significa uma ação do usuário, como interagir com uma Extensão de Mensagem.

Alterar o gatilho de um tópico

Você pode alterar o gatilho de um tópico ao editá-lo. Por padrão, os tópicos usam o gatilho Frases, mas você pode mudar para outros tipos de gatilho:

Condição do gatilho

O nó Condição no gatilho permite especificar condições que devem ser atendidas para que o gatilho seja disparado.

Captura de tela das condições de gatilho.

Observação

Você pode usar o Power Fx para criar condições complexas.

Prioridade de gatilho

Mais de um gatilho pode ser disparado para uma única Atividade recebida, como uma mensagem. O tipo de gatilho determina a ordem em que os gatilhos são disparados.

Ordem de execução:

  1. Atividade Recebida
  2. Mensagem/Evento/Atualização de Conversa/Invocação Recebida
  3. Frases

Se houver mais de um gatilho qualificado do mesmo tipo, os gatilhos serão executados na ordem de criação (os mais antigos primeiro).

Importante

Você pode usar a propriedade Prioridade no painel Propriedades de um gatilho para determinar explicitamente a ordem de execução.

Para obter mais informações, consulte Usar gatilhos de tópico.