Ferramentas do atendimento
Como remover mensagens rápidas de usuários excluídos
Quando o usuário que criou uma mensagem rápida é excluído do Central de Ajuda Connect Bot, a mensagem perde o vínculo com ele. Na listagem de Comunicação e Marketing → Mensagens Rápidas, a coluna User ID aparece com um tracinho ( - ), e essas mensagens não podem ser editadas nem excluídas pelo painel, nem mesmo por um Administrador. Este artigo mostra como removê-las direto no banco de dados.
Pré-requisitos:
- Acesso SSH à VPS onde o Central de Ajuda Connect Bot está instalado.
- Acesso ao banco de dados, pelo PgAdmin ou pelo terminal (veja Banco de dados - Como acessar).
- Snapshot da VPS e backup do banco feitos antes de qualquer alteração.
Como funciona
As mensagens rápidas ficam na tabela FastReply do banco de dados. Cada mensagem guarda o ID do usuário que a criou na coluna userId. Quando esse usuário é excluído, o campo fica vazio (NULL), e o painel não tem mais como atualizar nem apagar o registro. A solução é localizar essas mensagens pelo userId vazio e excluí-las pelo banco.
Faça o snapshot e o backup antes de rodar qualquer comando que altere o banco. A exclusão é definitiva e não tem como desfazer pelo painel. O suporte não acessa a base de dados da sua instalação, e essa correção é feita pelo assinante, sob sua responsabilidade. Veja Manutenção e Segurança.
Etapa 1: Acesse o banco de dados
Pelo PgAdmin: conecte-se ao servidor e navegue até Databases > postgres > Schemas > public > Tables > FastReply. Para rodar os comandos das próximas etapas, clique com o botão direito no banco postgres e abra o Query Tool.
Pelo terminal: acesse a VPS via SSH e entre no PostgreSQL com:
docker exec -it postgresql psql -U postgres
O prompt muda para postgres=#, indicando que você já está dentro do banco.
Etapa 2: Confira as mensagens que serão removidas
Antes de excluir, liste as mensagens sem usuário vinculado:
SELECT * FROM "FastReply" WHERE "userId" IS NULL;
O resultado mostra as colunas da tabela, como id, key (o atalho), message, userId e tenantId. Confira se são mesmo as mensagens que você quer apagar.
No Central de Ajuda Connect Bot v4.0.5.6 ou superior, você também pode fazer essa conferência pelo painel do Superadmin, em Sistema > Dados & Config > Banco de Dados, na aba Consulta. Essa tela é somente leitura: serve para conferir, mas a exclusão (Etapa 3) continua sendo feita pelo PgAdmin ou pelo terminal. Veja Banco de dados.
Etapa 3: Remova as mensagens sem usuário
Com o snapshot feito, rode:
DELETE FROM "FastReply" WHERE "userId" IS NULL;
Esse comando remove as mensagens sem usuário de todas as empresas (tenants) da instalação. Para limpar só uma empresa, acrescente o filtro do tenant, por exemplo: DELETE FROM "FastReply" WHERE "userId" IS NULL AND "tenantId" = 1;
No terminal, digite \q para sair do PostgreSQL.
Etapa 4: Confira no painel
Acesse Comunicação e Marketing → Mensagens Rápidas e clique em Atualizar. As mensagens com - no User ID não aparecem mais.
Resumo
| Etapa | Onde / comando |
|---|---|
| Acessar o banco | PgAdmin (Query Tool) ou docker exec -it postgresql psql -U postgres |
| Conferir | SELECT * FROM "FastReply" WHERE "userId" IS NULL; |
| Remover | DELETE FROM "FastReply" WHERE "userId" IS NULL; |
| Validar | Comunicação e Marketing → Mensagens Rápidas → Atualizar |
Encerramento
Com as mensagens sem usuário removidas, a listagem volta a mostrar só mensagens que podem ser editadas e excluídas pelo painel. Para criar novas mensagens no lugar das removidas, veja Mensagens Rápidas.
Possíveis Erros e Soluções
role "postgres" does not exist ao entrar pelo terminal
Causa: instalação antiga, em que o usuário do banco tem outro nome. Solução: confira o usuário do banco no arquivo .env do back-end e use-o no lugar de postgres no comando docker exec -it postgresql psql -U <usuario>.
relation "FastReply" does not exist
Causa: o nome da tabela foi digitado sem aspas duplas ou com outra combinação de maiúsculas e minúsculas. Solução: escreva sempre "FastReply", com aspas duplas, exatamente como no exemplo.