ROI real de 7 filtros customizados no atendimento: números que você precisa ver

Lucas (CEO Toolzz)
17 de abril de 2026

No dinâmico mundo do atendimento ao cliente, a capacidade de segmentar e priorizar conversas é crucial para otimizar recursos e aumentar a satisfação do cliente. Filtros customizados no Toolzz Chat permitem que as empresas criem visões personalizadas de suas filas de atendimento, direcionando os agentes para as conversas mais relevantes e urgentes.

O Cenário do Atendimento Desorganizado

Imagine uma central de atendimento onde todos os tickets são tratados da mesma forma, independentemente da prioridade do cliente, do assunto ou do histórico. Esse cenário, infelizmente comum, leva a:

• Agentes sobrecarregados e frustrados
• Tempos de resposta mais longos
• Clientes insatisfeitos
• Perda de oportunidades de venda

Empresas que não investem em ferramentas de segmentação e priorização de atendimento acabam desperdiçando recursos valiosos e perdendo vantagem competitiva.

Pré-requisitos para Implementação

Para implementar filtros customizados no Toolzz Chat via API, você precisará de:

1. Conta Toolzz Chat: Acesse chat.toolzz.ai para criar sua conta.
2. Token de API: Obtenha seu token de API após fazer login no Toolzz Chat. Vá em Configurações > API > Gerar Novo Token.
3. Conhecimento básico de API: Familiaridade com requisições HTTP, métodos (GET, POST, PUT, DELETE) e formato JSON.

Obtendo o Token de API

Para obter o token de API, siga estes passos:

1. Acesse chat.toolzz.ai.
2. Faça login com suas credenciais.
3. No menu lateral, clique em Configurações.
4. Selecione a opção API.
5. Clique no botão Gerar Novo Token.
6. Copie o token gerado e guarde-o em um local seguro. Ele será necessário para autenticar suas requisições à API.

Arquitetura da Solução

A arquitetura da solução com filtros customizados no Toolzz Chat envolve o seguinte fluxo:

1. Cliente: Inicia uma conversa via WhatsApp, Instagram, chat no site ou outro canal.
2. Toolzz Chat: Recebe a mensagem e a armazena na inbox.
3. Filtros Customizados: A API permite criar filtros que segmentam as conversas com base em critérios como:
   • Tags
   • Atributos do cliente (ex: plano, região)
   • Tempo de espera
   • Palavras-chave na mensagem
4. Agentes: Visualizam as filas de atendimento filtradas, priorizando as conversas mais relevantes.
5. Automação (Opcional): Integração com agentes de IA da Toolzz AI para respostas iniciais e qualificação de leads.

Configuração na Interface do Toolzz Chat

Antes de usar a API, você pode criar alguns filtros básicos diretamente na interface do Toolzz Chat:

1. Acesse chat.toolzz.ai.
2. Faça login com suas credenciais.
3. No menu lateral, clique em Filtros.
4. Clique no botão Novo Filtro.
5. Defina os critérios do filtro (ex: conversas com a tag "urgente").
6. Salve o filtro.

Esses filtros criados na interface podem servir como base para a criação de filtros mais complexos via API.

Implementação via API: Criando Filtros Customizados

A API do Toolzz Chat permite criar, listar, atualizar e excluir filtros customizados. Vamos focar na criação de um novo filtro.

Endpoint: Create a Custom Filter

• URL: https://api.toolzz.com.br/chat/v1/custom_filters
• Método HTTP: POST
• Headers:
  • Content-Type: application/json
  • Authorization: Bearer SEU_TOKEN_DE_API

Body JSON

{ "name": "Clientes Premium com Problemas Técnicos", "description": "Filtro para clientes do plano premium que estão com problemas técnicos.", "conditions": [ { "field": "tags", "operator": "contains", "value": "premium" }, { "field": "tags", "operator": "contains", "value": "problema_tecnico" } ], "priority": "high", "team_id": 123 }

Tabela de Parâmetros

Code Blocks

cURL

bash curl -X POST
'https://api.toolzz.com.br/chat/v1/custom_filters'
-H 'Content-Type: application/json'
-H 'Authorization: Bearer SEU_TOKEN_DE_API'
-d '{ "name": "Clientes Premium com Problemas Técnicos", "description": "Filtro para clientes do plano premium que estão com problemas técnicos.", "conditions": [ { "field": "tags", "operator": "contains", "value": "premium" }, { "field": "tags", "operator": "contains", "value": "problema_tecnico" } ], "priority": "high", "team_id": 123 }'

JavaScript

javascript const axios = require('axios');

const data = { name: 'Clientes Premium com Problemas Técnicos', description: 'Filtro para clientes do plano premium que estão com problemas técnicos.', conditions: [ { field: 'tags', operator: 'contains', value: 'premium', }, { field: 'tags', operator: 'contains', value: 'problema_tecnico', }, ], priority: 'high', team_id: 123, };

const config = { headers: { 'Content-Type': 'application/json', Authorization: 'Bearer SEU_TOKEN_DE_API', }, };

axios .post('https://api.toolzz.com.br/chat/v1/custom_filters', data, config) .then((response) => { console.log(response.data); }) .catch((error) => { console.error(error); });

Python

python import requests import json

url = 'https://api.toolzz.com.br/chat/v1/custom_filters' headers = { 'Content-Type': 'application/json', 'Authorization': 'Bearer SEU_TOKEN_DE_API' } data = { 'name': 'Clientes Premium com Problemas Técnicos', 'description': 'Filtro para clientes do plano premium que estão com problemas técnicos.', 'conditions': [ { 'field': 'tags', 'operator': 'contains', 'value': 'premium' }, { 'field': 'tags', 'operator': 'contains', 'value': 'problema_tecnico' } ], 'priority': 'high', 'team_id': 123 }

response = requests.post(url, headers=headers, data=json.dumps(data))

print(response.json())

Response JSON

{ "id": 456, "name": "Clientes Premium com Problemas Técnicos", "description": "Filtro para clientes do plano premium que estão com problemas técnicos.", "conditions": [ { "field": "tags", "operator": "contains", "value": "premium" }, { "field": "tags", "operator": "contains", "value": "problema_tecnico" } ], "priority": "high", "team_id": 123, "created_at": "2023-10-27T10:00:00Z", "updated_at": "2023-10-27T10:00:00Z" }

Este JSON de resposta indica que o filtro foi criado com sucesso. O campo id contém o ID do filtro criado, que pode ser usado para atualizar ou excluir o filtro posteriormente.

Endpoint: List All Custom Filters

Para listar todos os filtros customizados existentes, utilize o seguinte endpoint:

• URL: https://api.toolzz.com.br/chat/v1/custom_filters
• Método HTTP: GET
• Headers:
  • Content-Type: application/json
  • Authorization: Bearer SEU_TOKEN_DE_API

bash curl -X GET
'https://api.toolzz.com.br/chat/v1/custom_filters'
-H 'Content-Type: application/json'
-H 'Authorization: Bearer SEU_TOKEN_DE_API'

A resposta será um array de objetos JSON, onde cada objeto representa um filtro customizado.

Endpoint: Update A Webhook Object

Para atualizar um filtro customizado, utilize o seguinte endpoint:

• URL: https://api.toolzz.com.br/chat/v1/custom_filters/{filter_id}
• Método HTTP: PUT
• Headers:
  • Content-Type: application/json
  • Authorization: Bearer SEU_TOKEN_DE_API

O corpo da requisição deve conter os campos que você deseja atualizar. Por exemplo, para alterar a prioridade de um filtro, você pode usar o seguinte JSON:

{ "priority": "medium" }

Webhooks

Os webhooks podem ser usados para receber notificações quando um novo filtro é criado, atualizado ou excluído. Isso permite que você sincronize os filtros do Toolzz Chat com outros sistemas.

Para configurar um webhook, siga os passos abaixo:

1. Acesse chat.toolzz.ai.
2. Faça login com suas credenciais.
3. No menu lateral, clique em Configurações.
4. Selecione a opção Webhooks.
5. Clique no botão Novo Webhook.
6. Defina a URL do webhook e os eventos que você deseja receber.

Testando a Integração

Para testar a integração, siga estes passos:

1. Crie um filtro customizado via API.
2. Inicie uma conversa no Toolzz Chat que corresponda aos critérios do filtro.
3. Verifique se a conversa aparece na fila de atendimento filtrada.

Erros Comuns e Troubleshooting

• Erro de autenticação: Verifique se o token de API está correto.
• Erro de validação: Verifique se o JSON do body da requisição está formatado corretamente e se os campos obrigatórios estão presentes.
• Filtro não funciona: Verifique se as condições do filtro estão corretas e se correspondem às características da conversa.

Se você encontrar algum erro, consulte a documentação da API do Toolzz Chat em docs.toolzz.dev/chat-reference/ para obter mais informações.

Benefícios e ROI da Implementação

A implementação de filtros customizados no Toolzz Chat traz diversos benefícios e um ROI significativo:

1. Aumento da Eficiência: Agentes focam em conversas prioritárias.
2. Melhora da Satisfação do Cliente: Respostas mais rápidas e personalizadas.
3. Redução de Custos: Otimização de recursos e diminuição do tempo de atendimento.
4. Aumento das Vendas: Identificação e priorização de leads qualificados.
5. Melhor Gestão da Equipe: Visibilidade clara das filas de atendimento e distribuição eficiente de tarefas.
6. Dados e Métricas: Extração de insights valiosos sobre o desempenho do atendimento.
7. Escalabilidade: Adaptação fácil a mudanças nas necessidades do negócio.

Comparativo: Toolzz Chat vs. Concorrentes

Enquanto diversas plataformas de atendimento ao cliente oferecem funcionalidades de filtragem, o Toolzz Chat se destaca pela sua flexibilidade e integração com agentes de IA. Veja um comparativo:

Embora Zendesk e Freshdesk sejam concorrentes relevantes, o Toolzz Chat oferece uma combinação única de flexibilidade, integração com IA e facilidade de uso, tornando-o a escolha ideal para empresas que buscam otimizar seu atendimento ao cliente.

Pronto para levar seu atendimento para o próximo nível? Conheça a Toolzz e descubra como nossos filtros customizados podem aumentar o ROI do seu negócio.

Conclusão

A implementação de filtros customizados no Toolzz Chat é uma estratégia inteligente para empresas que desejam otimizar seu atendimento ao cliente, aumentar a eficiência da equipe e melhorar a satisfação do cliente. Ao segmentar e priorizar as conversas mais relevantes, você garante que seus agentes estejam sempre focados nas tarefas mais importantes, resultando em um ROI significativo.

Potencialize com agentes de IA da Toolzz

O Toolzz Chat cuida do atendimento humano. Mas e se um agente de IA da Toolzz AI respondesse as primeiras perguntas, qualificasse o lead, e só transferisse para o humano quando necessário? Com Custom Functions, seu agente consulta CRM, agenda reuniões e resolve problemas — tudo por WhatsApp. Já imaginou interagir com essa automação por voz?