Interaflow

Guias

Acesso Mobile

Toggle por Operação (master) e por Fila (override). Capacidades MVP do app mobile: login JWT, minhas conversas, fila de espera, chat de texto e WebSocket em tempo real.

Atualizado em

Para que serve

O app mobile do Interaflow permite que o Atendente atenda Conversas do celular, sem precisar do dashboard web. Útil para Operações com pessoal em campo, plantão fora do escritório, ou para reduzir o atrito de “logar no PC” em times pequenos.

A liberação é controlada pelo admin do tenant em duas dimensões:

  • Por Operação — master switch da Operação inteira.
  • Por Fila — override granular dentro da Operação.

Sem habilitar essas duas chaves, o app mobile rejeita o login dos Atendentes vinculados — mesmo que as credenciais estejam corretas e o User esteja ativo.

Como habilitar

A regra de autorização efetiva é uma conjunção:

Atendente entra pelo mobile  ⇔
  fila.mobile_app_enabled = true  E
  ( fila não tem Operação  OU  operacao.mobile_app_enabled = true )

Em palavras: tanto a Fila quanto a Operação dela precisam estar autorizadas. Desligar a Operação desativa o acesso de todas as Filas dela na prática, mesmo que o toggle individual esteja ligado — a UI marca essa situação como “ignorado (operação desligada)”.

Passo a passo

  1. Configurações → Acesso Mobile.
  2. Ative a Operação que deve ter acesso mobile no toggle do cabeçalho da seção. O rótulo muda para “Autorizada”.
  3. Ative a Fila ou as Filas dentro da Operação no toggle de cada linha. O rótulo da linha muda para “Liberada”.
  4. Filas sem Operação vinculada aparecem em uma seção própria; para elas, vale apenas o toggle individual (não há Operação para validar).

Mudanças entram em vigor imediatamente — as próximas tentativas de login no mobile já refletem o novo estado.

Permissões e papéis

  • Admin e superuser do tenant podem alterar os toggles de Acesso Mobile.
  • Outros papéis (supervisor, member, agente) não veem a página.
  • O acesso ao app mobile em si é determinado pelos toggles e pela Fila do Atendente — qualquer User com um papel que atua em Conversas pode usar o mobile, desde que sua Fila esteja liberada.

Capacidades atuais do app (MVP fase 1)

O MVP cobre o essencial de atendimento de texto:

  • Login com as mesmas credenciais do dashboard web (JWT).
  • Minhas conversas — lista das Conversas atribuídas ou abertas com você.
  • Fila de espera — Conversas aguardando, com botão “Pegar” para assumir.
  • Tela de conversa — visualizar mensagens e enviar texto.
  • WebSocket em tempo real — a lista atualiza quando uma Conversa é atribuída a você sem precisar puxar.
  • Logout.

Fora do MVP (próximas fases)

  • Push notifications — alerta no celular quando uma Conversa cai para você.
  • Voz e chamadas — atendimento de voz pelo softphone WebRTC mobile.
  • Mídia — envio e recepção de imagem, áudio e documento.

”Pareamento” do dispositivo

Não há um cadastro explícito de dispositivo. O fluxo é o do login JWT padrão, com o token armazenado de forma segura no aparelho:

  1. Admin libera a Operação e a Fila correspondentes em Acesso Mobile (passos acima).
  2. Atendente instala o Expo Go (App Store / Play Store) no celular ou usa o app dedicado quando publicado.
  3. Atendente abre o app, informa o e-mail e a senha (ou autentica via SSO Google se configurado).
  4. O token JWT é guardado no SecureStore do aparelho. Próximas aberturas mantêm a sessão ativa até o logout ou expiração.

Revogar acesso

Para revogar o acesso de uma pessoa específica:

  • Desativar o User no Interaflow. Bloqueia o login mobile e o dashboard web simultaneamente.
  • Logout forçado — não há botão de “matar sessão remota” no MVP; a expiração do token JWT (24 h por padrão) faz o aparelho voltar para a tela de login.

Para revogar o acesso de uma Fila inteira:

  • Desligue o toggle da Fila em Acesso Mobile. Os Atendentes daquela Fila perdem o acesso na próxima tentativa de login mobile.

Para revogar a Operação inteira:

  • Desligue o toggle da Operação. Todas as Filas dela ficam efetivamente bloqueadas no mobile, independentemente dos toggles individuais.

Boas práticas

  • Combine com SSO Google. Se o tenant usa SSO, libere mobile só para Filas onde o Workspace está padronizado — reduz suporte com troca de senha.
  • Documente as Filas habilitadas para a equipe. O Atendente pode ficar confuso se a Fila dele não está liberada e o login mobile retorna erro.
  • Comunique antes de desligar. Desligar uma Operação no Acesso Mobile interrompe o atendimento mobile na próxima ação — avise a equipe.
  • Não habilite Operações inteiras de uma vez se a operação for grande. Comece por uma Fila piloto, valide a experiência, expanda.

Erros comuns

  • Toggle da Fila ligado, mas Operação desligada. A Fila aparece como “ignorado (operação desligada)” — efetivamente bloqueada. Ative a Operação também.
  • Atendente em Fila não liberada. Login mobile retorna erro mesmo com User ativo e credenciais corretas. Cheque o toggle da Fila do Atendente.
  • Esperar push no MVP. Push notifications não estão no escopo da fase 1. Para alertas em tempo real, o app mantém WebSocket aberto; push entra em fase futura.
  • Tentar atender voz pelo mobile. Não disponível no MVP. Atendimento de voz exige softphone WebRTC do dashboard web.

Limites conhecidos

  • MVP é texto puro. Sem mídia (imagem, áudio, documento), sem voz, sem push.
  • Sem registro por dispositivo. Todos os dispositivos do mesmo Atendente compartilham a mesma sessão JWT (logout em um aparelho invalida nos outros conforme a política de sessão do tenant).
  • Fora do escopo do MVP: gestão de presença diferenciada por dispositivo, painel de Atendente offline-first, sincronização para uso em túnel sem conexão.

Ver também