🚀 Piece of Cake WhatsApp — Versão 15.0

Esta versão traz melhorias significativas no envio em massa, suporte a Agentes Light, novo layout de áudio, campos de usuário nas variáveis de template e diversas correções de estabilidade.

NOVO Envio em Massa — Aba "Usuários Cadastrados"

Além do envio por CSV, agora é possível buscar e selecionar usuários diretamente do Zendesk para o envio em massa.

Como utilizar

Detalhes das buscas disponíveis

Opções de envio

• Abrir ticket: cria um ticket vinculado ao usuário ao enviar a mensagem.
• Ativar atribuição automática: atribui o ticket ao agente que fez o disparo. Se configurado como padrão na instalação, já vem pré-marcado.

MELHORIA Aba "Gerenciar Templates"

Agora é possível selecionar o número de WhatsApp desejado para visualizar e gerenciar apenas os templates daquele canal específico.

NOVO Aba "Canal por Grupo"

Permite restringir quais grupos do Zendesk têm acesso a cada número de WhatsApp.

• Crie regras vinculando um canal a um ou mais grupos.
• Agentes que não pertencem ao grupo não visualizam o canal no APP.
• Canais sem regra ficam acessíveis para todos.

NOVO Aba "Configurações" — OAuth 2.0

Agora existem duas autenticações OAuth 2.0 disponíveis:

Toggles disponíveis

• Habilitar para Agentes Light: permite que agentes light utilizem o APP sem permissões administrativas.
• Habilitar Áudio: ativa o gravador de áudio para os agentes.
• Habilitar Agendar Disparo: (em construção).

NOVO Campos do Usuário nas Variáveis de Template

Agora é possível preencher as variáveis do template automaticamente com dados do perfil do usuário, tanto no Novo Ticket quanto no Ticket em Andamento.

Como usar

Campos disponíveis

MELHORIA Novo Layout — Envio de Áudio

Interface completamente redesenhada com foco em usabilidade:

• Card central com botão de microfone destacado.
• Timer de gravação integrado.
• Player de áudio para ouvir antes de enviar.
• Botão de exclusão para regravar.

Comportamento em caso de erro de OAuth

Se o Bot de Áudio não estiver configurado, o APP exibe uma tela de aviso diretamente no painel, sem travar:

• Se o áudio já foi gravado: aparece o botão 🔄 Tentar novamente (restaura o player com o áudio gravado) e o botão ⬇️ Baixar áudio para envio manual.
• Se ainda não gravou: exibe as instruções para acessar Configurações → Autorização OAuth 2.0.

MELHORIA Suporte a BSUID (Business-Scoped User ID)

O APP agora aceita BSUID do WhatsApp além de números de telefone em todos os fluxos de disparo:

• Detecção automática: se o identificador não é um telefone, é tratado como BSUID.
• No banco de dados: telefones são salvos apenas com dígitos (sem +), sempre com a variação com e sem o nono dígito nos campos telefone_cliente e telefone_cliente2.
• BSUIDs são salvos com o prefixo bsuid: para identificação clara.

CORREÇÃO Suporte a Agentes Light

Agentes Light agora conseguem utilizar todas as funcionalidades disponíveis para o seu perfil:

• Registro de disparos via servidor OAuth (sem necessidade de permissão direta).
• Criação de tickets com fallback automático para o servidor em caso de erro de permissão.
• Busca e criação de usuários via servidor quando o ZAF retorna erro 403.
• Filtro de canais por grupo consultado via servidor.
• Fusões de usuários e tickets automáticas desativadas para Agentes Light (sem impacto no disparo).

CORREÇÃO Demais Correções

• Tickets compartilhados (integração Zendesk × Zendesk) identificados e desabilitados na aba Fundir Tickets.
• Fusão automática de tickets ignora tickets criados via API, web widget e chat.
• Timer de "Tempo de Resposta" não duplica mais ao trocar o telefone no ticket.
• Campo de ID de conversa do Sunshine agora é preenchido corretamente.
• Link "Revisar" na tabela de envios aponta para o perfil correto do usuário no Zendesk (/requested_tickets).
• Aba Configurações bloqueada para não-administradores antes de renderizar qualquer conteúdo.
• Proxy de áudio (/audio-proxy) migrado do servidor PHP para o DOC-CX