WitWave WitWave
Documentação · Guia passo a passo

Instalação e uso do WitWave

Tudo o que você precisa para colocar o WitWave para funcionar no seu Zendesk: a instalação pelo Marketplace, a configuração com o Sunshine Conversations e como trabalhar com os áudios a partir do ticket e do painel de administração.

Requisitos. O WitWave precisa de uma conta do Zendesk com Agent Workspace, uma licença ativa do Sunshine Conversations e um canal de WhatsApp conectado no Zendesk. Se você não tem o Sunshine Conversations, fale com seu representante do Zendesk. Mais detalhes na nossa Política de Privacidade.

Parte 1 · Instalação

Instale e configure o WitWave

Quatro passos, sem desenvolvimento. A instalação termina ativando seu período de avaliação automaticamente.

  1. 1

    Instale o app pelo Zendesk Marketplace

    Procure por WitWave by Witbor no Marketplace e clique em Instalar. O Zendesk leva você à sua instância e mostra dois campos de configuração:

    Tela de instalação do WitWave no Marketplace do Zendesk
    💡

    O campo Nome já vem preenchido: deixe como está. O Token WitWave não é preenchido manualmente — ele é preenchido automaticamente mais adiante pelo OAuth. Confirme a instalação.

  2. 2

    Abra o WitWave pela barra lateral do Zendesk

    Entre no Zendesk Support e, na barra de navegação lateral (esquerda), procure o ícone do microfone . Ao clicar, abre o painel do WitWave com o assistente de configuração.

    Ícone do microfone do WitWave na barra lateral do Zendesk
  3. 3

    Identifique sua conta (passo 1 de 2 do assistente)

    O assistente pede dois dados:

    • Subdomínio: vem preenchido com a sua instância do Zendesk.
    • E-mail: o endereço que ficará vinculado ao Stripe para o faturamento.
    Configuração do WitWave
    Configuração do WitWavePasso 1 de 2
    tu-empresaAuto
    admin@empresa.com
    Continuar →
  4. 4

    Autorize o Sunshine Conversations (passo 2 de 2 do assistente)

    Clique em Vincular com OAuth. Abre uma janela do Sunshine Conversations mostrando o seu subdomínio e um botão Permitir. Ao autorizar, a janela se fecha e o WitWave salva o token automaticamente (por isso não era preciso preenchê-lo manualmente).

    Configuração do WitWave
    Configuração do WitWavePasso 2 de 2
    Vincular com OAuth
    ✓ Zendesk vinculado com sucesso

    Pronto! Com o OAuth concluído, o WitWave fica instalado e seu período de avaliação é ativado sozinho. Você já pode usá-lo em qualquer ticket de WhatsApp.

Parte 2 · Uso diário

O painel do ticket

No editor de ticket, um botão abre o painel do WitWave. A partir daí sua equipe trabalha com os áudios da conversa sem sair do ticket.

Painel do WitWave dentro do ticket do Zendesk

Ouvir áudios

Reproduza as notas de voz da conversa com a forma de onda. Ajuste quantas das últimas mensagens ver e atualize a lista quando chegar uma nova.

🎙️

Gravar e enviar áudios

Grave uma nota de voz pelo painel (com pausa e descarte) e envie ao cliente pelo WhatsApp em um clique.

🎵

Usar macros de áudio

Escolha um áudio pré-gravado em Áudios salvos, ouça e envie. Disponível no plano Pro.

⏱️

Janela de 24 h da Meta

O WitWave mostra se a conversa do WhatsApp continua dentro da janela de 24 horas permitida pela Meta (Ativa / Expirada).

📝

Transcrever um áudio

Converta qualquer nota de voz em texto com o botão Transcrever. A transcrição fica visível no ticket.

🗒️

Salvar como nota interna

Salve a transcrição do último áudio como nota interna do ticket. Esta ação vale apenas para o áudio mais recente.

💡

Se o microfone aparecer desabilitado, normalmente é porque o ticket não está no canal do WhatsApp ou porque a janela de 24 h expirou. O WitWave avisa antes de gravar para evitar erros de envio.

Parte 3 · Administração

O painel de administração

É o mesmo painel que você abre pelo ícone do microfone na barra de navegação do Zendesk. Tem quatro abas.

WitWave
Plano
Conexão
Macros
Ajustes

Plano

  • Status do plano e minutos usados / restantes, com alertas de consumo (OK / Atenção / Crítico).
  • Se você está em avaliação ou sem plano, pode comprar um plano (Basic ou Pro).
  • Se já tem plano, pode adicionar pacotes de minutos consumíveis (não expiram).

Conexão

  • Mostra a qual subdomínio o app está conectado e o status do OAuth do Sunshine Conversations.
  • Daqui você pode reautorizar permissões se a conexão precisar ser atualizada.

Macros

Pro
  • Grave um áudio e dê a ele um nome, descrição e categoria (pasta).
  • Depois reutilize pelo painel do ticket em Áudios salvos, pronto para enviar.

Ajustes

  • Mude o idioma do aplicativo.
  • Gerencie seu plano: leva você ao Customer Portal do Stripe para gerenciar assinatura, forma de pagamento e faturas.
Ajuda

Perguntas frequentes

Por que não preciso preencher o Token WitWave na instalação?

Porque ele é gerado automaticamente quando você autoriza o Sunshine Conversations pelo OAuth (passo 4). Preenchê-lo manualmente pode quebrar a conexão: deixe vazio.

Não vejo o ícone do microfone no Zendesk.

Ele fica na barra de navegação lateral (esquerda) do Zendesk Support. Se você acabou de instalar o app, recarregue a página para que apareça.

As macros de áudio não aparecem.

As macros são um recurso do plano Pro. Assine o Pro pela aba Plano para gravá-las e enviá-las pelo painel do ticket.

O botão de gravar / microfone está desabilitado.

Costuma acontecer quando o ticket não está no canal do WhatsApp ou quando a janela de 24 horas da Meta já expirou. O WitWave bloqueia para evitar erros de envio.

Como gerencio ou cancelo minha assinatura?

Pela aba Ajustes → Gerenciar assinatura. Isso leva você ao Customer Portal do Stripe, onde gerencia o plano, a forma de pagamento e as faturas.

Fiquei sem minutos de transcrição.

Pela aba Plano você pode adicionar um pacote de minutos consumíveis. Não expiram e são consumidos antes dos do seu plano mensal.

Pronto para começar?

Instale o WitWave pelo Marketplace e tenha seu primeiro áudio transcrito no mesmo dia.