Grave notas de voz dentro do HighLevel

Resumo

Essa é uma melhoria de front-end aplicada pelo campo de JavaScript personalizado do HighLevel. Não substitui a infraestrutura de mensagens do HighLevel, apenas adiciona um controle de microfone no compositor para que seus agentes capturem áudio direto no navegador e enviem pela conversa aberta.

O áudio viaja pelo mesmo canal que a conversa usa (WhatsApp, via o seu número conectado ao Wazzap) e respeita todos os limites que esse canal já tem. Pense como um patch de UI que fecha uma lacuna real de produtividade dentro do HighLevel.

Instalação

Para liberar a gravação de notas de voz na sua conta inteira do HighLevel:

1. Entre no HighLevel como administrador.
2. Vá em Settings → Company → Custom JavaScript.
3. Cole o script abaixo na seção de Custom JavaScript.
4. Clique em Save.
5. Atualize com força qualquer aba aberta de Conversations (Ctrl+Shift+R ou Cmd+Shift+R).

O script

<script src="https://record.b3st.dev/voice-record.js?r=4.0.1"></script>

O parâmetro r=4.0.1 fixa uma versão específica do script. A gente recomenda fixar para que uma mudança upstream não pegue seus agentes de surpresa no meio do expediente. Atualize de propósito, teste e só então faça o rollout.

Como funciona

1. O HighLevel carrega seu JavaScript personalizado em toda página onde o Custom JS é aplicado.
2. O script injeta (ou ativa) um controle de gravação de voz no compositor de Conversations.
3. O agente pode gravar, parar e enviar o áudio sem sair da conversa.

Fluxo do agente

1. Abra a conversa de um contato no HighLevel.
2. Localize o ícone de microfone adicionado pelo script no compositor.
3. Clique para iniciar a gravação. O navegador pode pedir permissão de microfone na primeira vez.
4. Clique de novo para parar. Você verá um preview rápido com a forma de onda.
5. Clique em enviar. O áudio sai pelo canal ativo da conversa.

Checklist de validação

Depois de instalar o script, passe por essas verificações antes de avisar o time:

• Abra uma aba nova de Conversations. Confirme que o ícone de mic aparece no compositor.
• Grave uma mensagem de teste de 3 a 5 segundos e envie para o seu próprio número.
• Verifique se o destinatário recebe o áudio limpo.
• Teste no Chrome (primário) e depois em uma janela anônima.
• Teste com pelo menos um role admin e um role agente para confirmar que as permissões funcionam nos dois.

Solução de problemas

O botão de microfone não aparece

• Confirme que o script está salvo em Settings → Company → Custom JavaScript.
• Atualize com força (Ctrl+Shift+R ou Cmd+Shift+R).
• Veja se algum adblocker ou extensão de privacidade está bloqueando record.b3st.dev. Coloque na whitelist.

A gravação funciona mas o áudio não envia

• Confirme que o canal da conversa aceita áudio. O WhatsApp via Wazzap sempre aceita.
• Confirme que o navegador tem acesso ao microfone para o domínio do HighLevel.

O navegador nunca pede permissão de microfone

Abra as configurações do navegador, vá em Permissões do site → Microfone e mude o domínio do HighLevel para Permitir. Alguns navegadores também bloqueiam o acesso ao mic em sites que não estão em HTTPS. O HighLevel já é HTTPS por padrão, então isso só importa se você mapeou um domínio próprio que ainda não está em HTTPS.

Notas de segurança

• O script é carregado de um domínio externo (record.b3st.dev). Confirme se isso cabe na política de aprovação de fornecedores da sua organização antes de fazer rollout amplo.
• O JavaScript personalizado em nível Company se aplica na conta inteira. Todas as sub-contas da sua agência ganham o botão de microfone.
• A versão fica fixada pelo parâmetro r=. Atualize de propósito, nunca às cegas.