For the complete documentation index, see llms.txt. This page is also available as Markdown.

Como utilizar as Filas de Distribuição em Fluxo

Agora que você já sabe como criar e configurar uma Fila de Distribuição, o próximo passo é utilizá-la em um Fluxo de Automação. Caso ainda não saiba como configurar a sua Fila, você pode aprender mais sobre as Filas de Distribuição, pela nossa documentação oficial clicando aqui ↗️.

Atualmente, as Filas de Distribuição podem ser utilizadas exclusivamente por meio dos Fluxos de Automação da Hablla. Para isso, é necessário adicionar o componente Distribuidor de Filas ao fluxo onde a distribuição deverá ocorrer.

No tutorial abaixo, iremos utilizar um modelo de fluxo no qual nós criaremos um fluxo do zero composto por apenas 4 componentes para exemplificar a utilização da Fila de Distribuição na prática.

1. Crie o fluxo desejado

Acesse o Studio e adicione um novo fluxo onde a distribuição deverá ser realizada. Neste exemplo, utilizaremos um fluxo com atendimento receptivo do WhatsApp.

  1. Primeiro Passo: Clique no ícone no botão de WhatsApp no menu rápido de ícones localizado na parte inferior da tela.

  2. Segundo Passo: Selecione o ícone do "Receptivo do WhatsApp" no seu fluxo.

Para selecionarmos qualquer componente nos fluxos de automação, temos duas opções:

  • Opção 1: Clicar e segurar sobre o componente e depois arrastar para a área em branco do fluxo (Nessa opção, você consegue escolher qual a localização o novo componente permanecerá no fluxo).

  • Opção 2: Basta clicar sobre o componente e o fluxo automaticamente criará o novo componente dentro de uma área padrão do fluxo.

2. Adicione o componente Distribuidor de Filas

  1. Passo 1: No menu rápido de componentes na parte inferior, localize e clique no componente "Hablla" (O ícone com o logotipo da Hablla)

  2. Passo 2: Agora, localize o componente: "Distribuidor de Filas" e selecione ele.

  3. Passo 3: Ligue os nós do receptivo ao ícone de distribuidor de filas, conforme apresentado no GIF a seguir:

3. Selecionar a fila que será utilizada no nó do Distribuidor

Clique duas vezes sobre o componente Distribuidor de Filas para abrir suas configurações. Ao abrir a nova janela, você precisa selecionar uma das filas que você configurou anteriormente seguindo a nossa documentação.

No campo Fila*, selecione uma das filas que você criou e depois clique em Salvar.

4. Conecte a saída de sucesso da Fila ao próximo nó do fluxo

Após salvar as configurações da fila, conecte a sua saída Sucesso ao componente Variáveis Globais.

Neste exemplo, utilizaremos uma variável global para facilitar a identificação e reutilização dos dados retornados pelo Distribuidor de Filas nas próximas etapas do fluxo. Dessa forma, em vez de utilizar diretamente a expressão completa gerada pelo componente, podemos atribuir esse valor a uma variável com um nome mais simples e fácil de identificar.

Para adicionar o componente de variáveis globais:

  • Clique no ícone Adicionar Componente (Ícone +), disponível no menu rápido de componentes do fluxo.

  • Em seguida, role para baixo na lista de componentes até a seção Outros, clique sobre ela e depois selecione a opção Defina variáveis globais.

  • Agora você deve conectar a saída de sucesso do Distribuidor de Filas ao novo componente de variáveis globais.

  • Após conectar a saída de sucesso do Distribuidor ao nó de Variáveis Globais, clique duas vezes sobre ele para abrir as configurações do nó.

  • Adicione uma variável global e insira no campo de valor, a expressão que retorna o ID do Usuário, que no caso do nosso exemplo, é retornado pela chave key do Distribuidor de Fila.

Como neste exemplo estamos utilizando uma fila do tipo Usuários, o Distribuidor de Filas retornará as informações referentes aos usuários selecionados dentro da fila de distribuição.

Chave da Variável Global
Valor

id_user

Expressão com o ID do usuário retornado pelo Distribuidor de Filas

No nosso exemplo, a expressão que retorna o id do usuário retornado pelo Distribuidor é a chave de nome "key" a seguir:

⚠️ Lembre-se de alterar o id do componente de acordo com o seu fluxo.

  • Agora basta salvar, clicando no botão "Salvar" no canto inferior direito da tela.

5. Adicione e configure o componente de Transferência

Agora que o ID do usuário selecionado pela fila está armazenado em uma Variável Global, o próximo passo é utilizar essa informação para realizar a transferência do atendimento e para isso, basta seguir os passos abaixo.

Adicione o componente de Transferência

  • No menu rápido de componentes do fluxo, clique no ícone Hablla para visualizar os componentes disponíveis.

  • Localize a opção Transferência, clique sobre ela e arraste o componente para dentro do fluxo.

  • Em seguida, conecte a saída de sucesso do componente Defina variáveis globais ao componente de Transferência.

Agora que já adicionamos o componente de Transferência ao fluxo, precisamos agora configurá-lo para que ele funcione devidamente. Os próximos passos, ensinarão como você pode realizar essa configuração e efetivar as mudanças no seu fluxo.

Configure o setor de destino

  • Clique duas vezes sobre o componente de Transferência para abrir suas configurações.

  • Primeiro, selecione o Setor para o qual o atendimento deverá ser transferido.

Configure o usuário utilizando uma expressão

Após definir o setor, configure o campo Usuário para utilizar o ID armazenado anteriormente na Variável Global.

Por padrão, esse campo permite selecionar diretamente um dos usuários cadastrados no seu workspace. Como queremos utilizar dinamicamente o usuário selecionado pela Fila de Distribuição, será necessário alterar o campo para o modo Expression.

Para isso:

  1. Passe o mouse sobre o título do campo Usuário.

  2. No lado direito desse campo, localize e clique na opção Expression.

  3. Após clicar, campo será liberado para receber uma expressão.

Agora, informe a expressão correspondente à Variável Global criada anteriormente, que no caso do nosso exemplo, é representada pela expressão abaixo:

Após finalizar as configurações, clique em Salvar.

Por fim, nessa etapa, finalizamos as configurações do nosso fluxo de exemplo e ele seguirá esta sequência:

6. Publique e ative o fluxo

Com todos os componentes configurados e conectados, o próximo passo é publicar as alterações realizadas no fluxo. Para isso, basta seguir os passos a seguir:

  • Clique no botão Publicar. Uma janela de confirmação será exibida; confirme a publicação para aplicar as alterações.

  • Após a publicação, verifique também se o fluxo está Ativo visualizando se a chave ao lado direito do botão "publicar", está marcada ou desmarcada. Caso esteja inativo, clique sobre a chave de ativação para habilitá-lo.

7. Teste sua Fila de Distribuição

Agora com o fluxo publicado e ativo, você já pode testar o funcionamento da sua Fila de Distribuição.

Como neste exemplo utilizamos um Receptivo do WhatsApp, para testar, basta enviar uma mensagem para o número configurado no componente Receptivo do WhatsApp.

Ao receber a mensagem, o fluxo será iniciado e seguirá as configurações que realizamos:

Durante a execução, no momento em que o fluxo passar pelo Distribuidor de Filas, ele selecionará automaticamente um usuário de acordo com a fila e o algoritmo configurados. O ID do usuário selecionado será armazenado na Variável Global e utilizado pelo componente de Transferência para direcionar o atendimento.

Tudo pronto! A partir de agora, sempre que um atendimento passar por esse fluxo, a Fila de Distribuição será acionada e o atendimento poderá ser transferido automaticamente para o usuário selecionado, respeitando as regras de distribuição configuradas.

Atualizado

Isto foi útil?