Atendimento humano
Este manual fornece orientações sobre como utilizar as funcionalidades da ferramenta de atendimento, incluindo a gestão de filas e a criação de atalhos de texto.
Atendimentos
Esta funcionalidade estĆ” disponĆvel apenas para o papel de Atendente.
A Ôrea de atendimento humano é composta por três seções principais, cada uma desempenhando um papel crucial na gestão de interações com os usuÔrios. Abaixo estão as descrições de cada seção:

- Em atendimento - Exibe os atendimentos que jÔ foram capturados e estão em progresso.
- Em espera - Mostra os atendimentos que ainda nĆ£o foram capturados e estĆ£o disponĆveis para atendimento.
- Finalizados - Apresenta o histórico de atendimentos concluĆdos pelo atendente.
Em espera
Para capturar um atendimento disponĆvel, clique na opção "Realizar atendimento", como mostrado na imagem abaixo:

Ao selecionar essa opção, a solicitação serĆ” movida para a seção "Em atendimento", ficando acessĆvel apenas para o atendente que efetuou a captura.
Em atendimento
Ao clicar em "Realizar atendimento", o atendimento serÔ automaticamente movido para a aba "Em Atendimento", onde o atendente poderÔ prestar um suporte personalizado ao usuÔrio que necessita de assistência.

Tela de interação com o usuÔrio
Nesta tela, o atendente pode se comunicar diretamente com o usuƔrio em tempo real, trocando mensagens, enviando arquivos de Ɣudio, imagens (PNG, JPG, JPEG), documentos (PDF, Word, Excel) e emojis, alƩm de utilizar atalhos de texto para respostas rƔpidas.

Veja as opƧƵes disponĆveis nessa tela:
- Transferir: Durante o atendimento Ć© possĆvel transferir a solicitação da seguinte maneira:
- Transferir para outro fila: Permite transferir o atendimento de uma fila para outra fila, garantindo que o usuƔrio seja encaminhado ao setor mais adequado para sua demanda.
- Transferir para outro atendente: Possibilita a transferĆŖncia do atendimento para um atendente especĆfico, assegurando um suporte mais eficiente e direcionado.

- Finalizar: Encerra o atendimento especĆfico, registrando o histórico da conversa e mantendo o atendente disponĆvel para continuar outros atendimentos simultaneamente.
- Emojis: Essa opção permite que atendentes e usuÔrios utilizem emojis para tornar a comunicação mais interativa, expressiva e dinâmica.
- Upload de arquivos: Possibilita enviar arquivos e documentos durante o atendimento.
- Upload de Ôudio: Permite o envio de arquivos de Ôudio durante o atendimento humano, facilitando a comunicação e proporcionando uma alternativa eficiente para esclarecer dúvidas ou fornecer informações de forma mais dinâmica.
- Atalhos: Possibilita enviar os atalhos de texto criados.
- User infor: Ao abrir o menu lateral, serão exibidas as informações do usuÔrio, incluindo nome completo, e-mail, telefone e o canal de acesso utilizado. Além disso, poderão ser apresentadas outras informações relevantes, como o histórico de interações.

Finalizados
Esta seção exibe o histórico dos atendimentos concluĆdos, permitindo que vocĆŖ revise as mensagens trocadas e os detalhes de cada atendimento para acompanhamento e anĆ”lise. Para auditar, basta clicar no atendimento desejado ou usar a opção de pesquisa na lupa ("pesquise aqui") para localizar o atendimento que deseja revisar.

Configurando o atendimento humano no Chatbot
Para configurar o atendimento humano no seu chatbot, Ć© preciso adicionar o comportamento Atendimento humano e, em seguida, associar um mediador (broker). Abaixo, vocĆŖ vai encontrar o passo a passo para:
- Registrar o comportamento do atendimento humano.
- Vincular o mediador (broker).
- Integrar bot + atendimento humano com a MƔquina de Estados.
PrƩ-requisitos
Antes de iniciar, verifique se os seguintes itens jÔ estão configurados:
- Fila de atendimentos: Crie uma fila de atendimentos e cadastre os atendentes.
- Chatbot: Crie um chatbot ou acesse um jĆ” existente.
- MƔquina de estados (Skill): Certifique-se de ter criado uma skill para registrar no chatbot. Veja como criar sua NLU neste guianeste guia.
- Mediador (Broker): Ć necessĆ”rio escolher ao menos um broker para ser registrado no chatbot. Os brokers disponĆveis sĆ£o: botmaker, gupshup, messenger, positus, slack, teams, telegram, twilio e widget. Neste exemplo, usaremos o Widget. Se ainda nĆ£o tiver um, crie-o seguindo este tutorialtutorial.
Passo 1 ā Registrar atendimento humano no chatbot
- No menu Chatbot, selecione o bot que deseja configurar.

- Localize a opção Registrar novo comportamento e depois clique em Avançar.

- Na tela de cadastro, preencha:

Passo 2 ā Vincular o Mediador (Broker)
Observação: Crie o broker (no nosso exemplo, o Widget) antes de registrar no chatbot. Veja como em widgetwidget.
- No mesmo chatbot, localize a opção Registrar novo comportamento e clique em Avançar.
- Informe o Nome do comportamento.
- Em manifesto, selecione Widget e avance.
- Em Parâmetros, escolha o widget criado e conclua.
Pronto! Após a configuração do broker, jĆ” Ć© possĆvel transferir o usuĆ”rio para o atendimento humano.
Observação: Verifique em Iniciar a conversa no comportamento se o Atendimento humano estÔ selecionado. Caso contrÔrio, escolha-o e clique em Salvar.

Integração Bot + Atendimento humano + MÔquina de estados
Para que o atendimento humano funcione integrado ao bot, é necessÔrio registrar uma mÔquina de estados e configurar o estado responsÔvel pela transferência. Siga os passos abaixo para realizar essas configurações.
Passo 1 ā Registrar mĆ”quina de estados (Skill)
Observação: Crie uma skill antes de registrar no chatbot. Consulte as instruções aquiaqui.
- No chatbot, localize a opção Registrar novo comportamento e clique em Avançar.
- Informe o nome do comportamento a ser criado.
- Em Manifesto, selecione MƔquina de estados e avance.
- Em Parâmetros:
- Escolha o Workspace.
- Selecione a Skill.
- Finalize em Concluir.
A mƔquina de estados foi registrada em seu chatbot
Passo 2 ā Configurar fila de atendimentos no fluxo
Agora Ʃ preciso configurar a fila de atendimentos dentro do fluxo da MƔquina de Estados, para isso, siga os passos abaixo:
- Na lista de comportamentos do chatbot, localize o comportamento MƔquina de estados e copie o Identificador.

- Navegue para a funcionalidade MÔquina de estados e na funcionalidade skills, selecione umas das opções abaixo para realizar a edição:
Utilizando o "Editor visual"
- Na skill, clique em Editor.

- Selecione o estado onde ocorrerĆ” o atendimento humano.
- No painel lateral, vƔ em AutomaƧƵes.

- Cole o Identificador no campo e clique em "Salvar".

Utilizando o "Editor de código"
- Na skill, clique em Código.

- Localize (ou pesquise com CTRL + F) o estado escolhido para realizar o transferĆŖncia.

- Insira as informações $ <Identificador> dentro do estado responsÔvel pela transferência, conforme imagem:

- Conclua as alteraƧƵes clicando em Salvar no canto superior direito da tela.

- Por fim, retorne à tela de Listagem de comportamentos e, na opção Iniciar a conversa no comportamento, selecione o fluxo de demonstração. Isso farÔ com que o chatbot seja iniciado diretamente pelo bot. Em seguida, clique em Salvar.

Filas
Esta funcionalidade estĆ” disponĆvel apenas para o papel de Supervisor.
A opção "Filas" permite criar, configurar e gerenciar filas de atendimento, facilitando a distribuição e organização das solicitações recebidas.
Adicionar
Para criar uma fila, clique na opção "Adicionar", conforme a imagem abaixo:

Após acessar a tela, insira o "Nome da fila", selecione os usuÔrios que farão parte daquela fila de atendimento e clique em "Salvar" para concluir o processo. Conforme imagem abaixo:

Editar
O sistema permite realizar edições no campo "UsuÔrios". Para isso, clique na opção "Editar", conforme mostrado na imagem abaixo:

Editar Fila
UsuĆ”rios: Ć possĆvel definir os integrantes da fila que faram parte da equipe de atendimento.
Mensagem de entrada na fila: Define o texto quando o usuĆ”rio entra na fila de atendimento humano. Utilizando a chave {{pos}} Ć© possĆvel informar a posição que o usuĆ”rio se encontra na fila.
Mensagem de espera na fila : Define o texto ao atualizar a posição do usuÔrio na fila de atendimento. Utilizando a chave {{pos}} para informar a posição do usuÔrio, a chave {{queue}} para informar qual a fila de atendimento e a chave {{time}} para informar o tempo estimado para atendimento.
Mensagem de captura: Define o texto quando o atendente assume o atendimento do usuƔrio. Utilizando a chave {{name}} Ʃ informado ao usuƔrio quem estƔ realizando seu atendimento.
Mensagem de despedida da fila: Define o texto de conclusão do atendimento humano.
Distribuir atendimentos automÔticamente: Habilita a distribuição automÔtica de atendimento para a fila.
Habilitar transferĆŖncia entre filas: Permite que os atendentes direcionem o atendimento para outras filas.
Habilitar transferência entre agentes: Permite que os atendentes realizem a atribuição de atendimento para outros atendentes da mesma fila.
Após fazer as alterações necessÔrias, clique em "Salvar" para concluir.

Excluir
Para remover uma fila que não é mais necessÔria, clique na opção "Excluir", conforme mostrado na imagem abaixo:

Em seguida, confirme a ação clicando em Sim na janela de confirmação:

Atalhos de Texto Globais e Privados
A funcionalidade "Atalhos Globais" estĆ” disponĆvel para os usuĆ”rios que possuem o papel de "supervisor" e "Atalhos Privados" estĆ” disponĆvel para o perfil "atendente".
Os atalhos de texto tĆŖm como propósito agilizar o atendimento ao usuĆ”rio, permitindo o uso de respostas e procedimentos previamente configurados, sem a necessidade de buscar informaƧƵes nas bases de conhecimento. Ć possĆvel criar atalhos de respostas rĆ”pidas que podem ser compartilhados globalmente entre todos os operadores ou configurados como privados, acessĆveis apenas pelo operador que os criou.
Adicionar Atalho
Para adicionar um atalho, seja global ou privado, escolha a opção correspondente, conforme imagem abaixo:

Em seguida, preencha os campos Nome do Atalho e ConteĆŗdo do Atalho, e finalize clicando em Adicionar Atalho, conforme ilustrado na imagem:
