Bot do Zendesk não está respondendo: 8 correções que realmente funcionam

Não há nada como o pânico de perceber que seu bot do Zendesk ficou em silêncio. Os clientes estão digitando perguntas e recebendo... nada. Ou pior, eles estão ficando presos em loops onde o bot continua fazendo a mesma pergunta de volta. Se você está aqui, provavelmente já verificou o óbvio e está procurando respostas que realmente funcionem.

Este guia apresenta oito correções comprovadas para quando seu bot do Zendesk para de responder. Cobriremos tudo, desde verificações rápidas de configuração até as limitações da plataforma que podem estar bloqueando você. E se você continuar batendo de frente com os bots nativos do Zendesk, mostraremos como as equipes estão resolvendo esses problemas com o eesel AI como uma abordagem alternativa.

Lista de verificação de diagnóstico rápido

Antes de mergulhar em correções específicas, execute esta triagem de dois minutos para restringir o que está acontecendo:

Verifique o escopo. O bot está falhando em um canal (como o chat da web), mas funcionando em outros (como o e-mail)? Isso aponta para um problema específico do canal, em vez de um problema em todo o bot.

Verifique se está publicado. No Zendesk, os bots podem ser salvos, mas não publicados. Vá para a Central de Administração > Canais > Bots e confirme se o seu bot aparece como "Publicado" e não apenas "Salvo".

Teste em modo anônimo. O cache e os cookies do navegador causam comportamentos estranhos. Abra uma janela anônima e teste a conversa do zero.

Revise as páginas de status. Verifique a página de status do Zendesk para descartar interrupções em toda a plataforma.

Capture os detalhes. Anote o ID da conversa, o carimbo de data/hora e exatamente o que o usuário digitou. Você precisará disso se precisar escalar para o suporte do Zendesk.

Se o problema persistir após essas verificações, passe para as correções específicas abaixo.

Causas comuns e soluções

1. Bot não está recebendo eventos ou carregando

Quando o widget simplesmente não aparece ou o bot nunca é acionado, o problema geralmente está na camada de integração entre seu site e o Zendesk.

Verifique a instalação do seu widget. O Web Widget do Zendesk precisa ser carregado em todas as páginas onde você deseja que o bot esteja disponível. Verifique se o script está presente no cabeçalho do seu site e se nenhuma política de segurança de conteúdo (CSP) o está bloqueando.

Cuidado com bloqueadores de anúncios e extensões de privacidade. Extensões de navegador como uBlock Origin ou Privacy Badger frequentemente bloqueiam os scripts do widget do Zendesk. Esta é uma das causas mais comuns de "o bot funciona para mim, mas não para os clientes". Teste com as extensões desativadas.

Verifique as credenciais do canal. Cada bot precisa ser publicado na marca e no canal corretos. Na Central de Administração, verifique se o seu bot está associado ao canal de mensagens que seus clientes estão realmente usando. Um bot publicado na marca errada não responderá, mesmo que todo o resto pareça correto.

2. Problemas de autenticação e permissão

Usuários conectados às vezes veem um comportamento do bot diferente dos visitantes anônimos. Isso geralmente remete à configuração de autenticação.

Conflitos de SAML vs JWT. Se você estiver usando SAML para autenticação de agentes, mas JWT para autenticação de usuários finais, o bot pode ficar confuso sobre com quem está falando. O sistema de mensagens do Zendesk espera métodos de autenticação consistentes. Revise suas configurações em Central de Administração > Canais > Mensagens e garanta que a autenticação esteja configurada uniformemente.

Conteúdo restrito da central de ajuda. Bots treinados em artigos da central de ajuda não responderão com conteúdo que o usuário não tenha permissão para ver. Se a sua central de ajuda tiver seções restritas, o bot pode simplesmente não ter nada a dizer a certos usuários. Ou abra os artigos relevantes ou treine o bot em fontes públicas adicionais.

Tempos limite de sessão de SSO. Quando a sessão de SSO de um usuário expira no meio de uma conversa, o bot geralmente para de responder em vez de lidar graciosamente com a falha de autenticação. Verifique as configurações de tempo limite de sessão do seu provedor de SSO e considere implementar o tratamento de tokens de atualização (refresh tokens) se sua integração suportar.

3. Conflitos de gatilhos e problemas de roteamento

O sistema de gatilhos (triggers) do Zendesk é poderoso, mas pode criar conflitos que interrompem silenciosamente as conversas do bot.

Gatilhos excessivamente amplos. Um gatilho configurado para disparar em "todos os tickets" pode interceptar as conversas do bot antes que elas sejam concluídas. Revise seus gatilhos (Central de Administração > Objetos e Regras > Gatilhos) e procure por qualquer um que possa estar capturando conversas do bot. Adicione condições como "Canal não é Mensagens" ou "Usuário atual não é usuário final" para excluir interações do bot.

Roteamento por horário comercial. Se o seu bot estiver configurado para passar para agentes durante o horário comercial, mas esses agentes estiverem em um grupo offline, a conversa pode ficar presa no limbo. O bot acha que a transferência foi bem-sucedida, mas nenhum agente a recebe. Verifique sua configuração de horário comercial e garanta que seus alvos de roteamento sejam grupos ativos.

Loops de atribuição de grupo. Algumas configurações de gatilho criam loops onde um ticket é atribuído ao Grupo A, o que aciona uma ação que o atribui ao Grupo B, que por sua vez aciona a reatribuição de volta ao Grupo A. O bot fica preso nesse loop e para de responder de forma significativa. Audite sua cadeia de gatilhos em busca de dependências circulares.

4. Falhas no reconhecimento de intenção

Quando o bot responde com "Não entendi" ou continua fazendo a mesma pergunta de esclarecimento, você está lidando com problemas de reconhecimento de intenção (intent recognition).

Dados de treinamento ambíguos. Se suas frases de treinamento para "Solicitação de reembolso" incluírem coisas como "Quero meu dinheiro de volta", mas sua intenção de "Cancelar assinatura" incluir "Não quero mais pagar", o bot não conseguirá distinguir entre reembolsos e cancelamentos. Revise seus dados de treinamento de intenção e garanta que as frases sejam específicas para cada intenção.

Intenções quase duplicadas. Ter intenções como "Verificar status do pedido" e "Onde está meu pedido" dilui a precisão do bot. Mescle intenções semelhantes e use a extração de entidades para lidar com variações. Uma intenção forte vence três intenções sobrepostas.

Falta de limites de confiança. Sem um limite mínimo de confiança (confidence threshold), o bot tentará adivinhar mesmo quando não tiver certeza. Defina um limite de confiança (geralmente 70-80%) para que o bot encaminhe para um humano em vez de dar uma resposta errada. Você pode configurar isso nas configurações de conversa do seu bot.

5. Problemas de conectividade da base de conhecimento

Bots que dependem de artigos da central de ajuda para obter respostas podem falhar silenciosamente quando esses artigos não estão acessíveis.

Permissões e visibilidade de artigos. Artigos de rascunho, artigos restritos a certos segmentos de usuários ou artigos em seções inativas não estarão disponíveis para o bot. Audite o conteúdo da sua central de ajuda e garanta que os artigos que você deseja que o bot use estejam publicados e visíveis para os públicos apropriados.

Problemas de organização de conteúdo. O bot funciona melhor quando sua central de ajuda tem uma categorização clara. Se tudo for jogado em "Geral", o bot terá dificuldade em encontrar conteúdo relevante. Implemente uma estrutura de categorias clara e marque os artigos com palavras-chave relevantes.

Artigos excluídos sem redirecionamento. Quando você exclui um artigo da central de ajuda no qual o bot foi treinado, o bot não sabe automaticamente que deve parar de referenciá-lo. Ele pode tentar vincular os usuários a uma página 404. Ao remover artigos, atualize os dados de treinamento do seu bot ou configure redirecionamentos para o conteúdo substituto.

6. Tempos limite (timeouts) de API e webhook

É aqui que as coisas ficam frustrantes. O Zendesk possui limites fixos de tempo limite para chamadas de API do bot, e estes não podem ser aumentados.

A restrição de tempo limite. De acordo com o suporte do Zendesk, as chamadas de API do bot têm um limite rígido de tempo limite. Se o seu bot precisar buscar informações em um sistema externo (como verificar estoque ou extrair dados do cliente) e essa busca demorar mais do que a janela de tempo limite, a chamada falha e o bot para de responder. Esta é uma limitação confirmada da plataforma, não um problema de configuração.

Erros de autenticação (401, 403). Quando as chamadas de API retornam erros de autenticação, o bot frequentemente falha silenciosamente em vez de exibir o erro. Verifique suas credenciais de API e garanta que os tokens não expiraram. Se estiver usando OAuth, verifique se o fluxo de atualização de token (refresh token) está funcionando.

Requisitos de tempo de resposta. Qualquer API que seu bot chame precisa responder rápido. Se você estiver integrando com sistemas externos lentos, considere armazenar em cache os dados solicitados com frequência ou mudar para webhooks assíncronos, se possível.

7. Configuração de tempo limite e inatividade

As mensagens do Zendesk e o chat legado lidam com tempos limite de forma diferente, e os padrões frequentemente causam confusão.

Diferenças entre Mensagens e Chat. No Zendesk Messaging (a plataforma mais nova), as conversas persistem entre as sessões. No Chat legado, não. Se você estiver no Messaging e o bot parecer "lembrar" de coisas que não deveria, ou se estiver no Chat e o bot esquecer tudo entre os carregamentos de página, você está vendo o comportamento esperado da plataforma que parece um bug.

O atraso de 4 dias para devolução. Aqui está um detalhe curioso: quando um ticket é marcado como Resolvido no Zendesk, há um atraso padrão de 4 dias antes que ele mude para o status Fechado. Durante essa janela, se o cliente enviar uma mensagem novamente, o mesmo ticket é reaberto em vez de criar um novo. O bot pode não interagir novamente porque vê isso como um ticket existente, não como uma nova conversa. Você pode ajustar esse atraso nas suas configurações de automação, mas não pode eliminá-lo totalmente.

Configurações de período de inatividade. Os bots podem ser configurados para passar para agentes após um período de inatividade. Se isso for definido como muito curto (como 30 segundos), o bot faz a transferência antes que o usuário termine de digitar. Revise as configurações de tempo limite de inatividade do seu bot e defina-as de acordo com o seu caso de uso.

8. Problemas específicos da plataforma (SDK móvel)

As implementações móveis têm suas próprias peculiaridades que não aparecem nos testes da web.

Diferenças entre SDK de Android e iOS. Os SDKs do Zendesk para Android e iOS lidam com a autenticação e o estado da conversa de forma diferente. Um bot que funciona perfeitamente na web pode falhar no celular devido a detalhes de implementação específicos do SDK. Teste em ambas as plataformas separadamente.

Autenticação JWT no celular. Aplicativos móveis que usam JWT para autenticação frequentemente têm dificuldades com a atualização do token. Se o JWT expirar no meio da conversa, o bot pode parar de responder. Implemente a lógica adequada de atualização de token no seu aplicativo móvel e teste casos extremos relacionados à expiração da sessão.

Problemas de integração de aplicativos. Se você estiver incorporando as mensagens do Zendesk dentro de um aplicativo nativo usando um WebView, poderá encontrar problemas de cookies e armazenamento que quebram o bot. Considere usar os SDKs nativos em vez de wrappers de WebView para um comportamento mais confiável.

Entendendo as limitações do Zendesk

Alguns problemas não são bugs, são restrições da plataforma que você precisa contornar.

Os tempos limite da API não podem ser aumentados. Este é o ponto principal. Se o seu bot precisar fazer chamadas de API externas que demorem mais do que a janela de tempo limite do Zendesk, você simplesmente não conseguirá fazer isso funcionar dentro da estrutura de bot nativa do Zendesk. Equipes que precisam de integrações complexas frequentemente batem nessa barreira.

O Flow Builder é legado para novos clientes. Se você criou sua conta do Zendesk após fevereiro de 2025, não terá acesso ao Flow Builder. Você está na nova plataforma de Agente de IA, que possui capacidades e limitações diferentes. A documentação que você encontra online pode referenciar recursos do Flow Builder que não existem no seu ambiente.

Agentes de IA Avançados são complementos pagos. Os recursos de Agente de IA que resolvem mais de 80% das conversas não estão incluídos nos planos básicos. Você precisa do complemento Agentes de IA Avançados, que requer entrar em contato com as vendas para obter preços. Os agentes de IA básicos têm capacidades mais limitadas.

O uso do Copilot é limitado. Na maioria dos planos do Zendesk, o Copilot (o assistente de escrita de IA para agentes) é limitado a 5 usos por agente por mês. Depois disso, os agentes perdem a assistência de IA no meio do turno. O acesso adicional ao Copilot custa US$ 50 por agente por mês.

Quando essas limitações se tornam bloqueios para o seu caso de uso, vale a pena avaliar se a IA nativa do Zendesk é a escolha certa ou se você precisa de algo mais flexível.

Quando considerar alternativas

Se você seguiu as correções acima e ainda está encontrando barreiras, talvez tenha superado o que os bots nativos do Zendesk podem oferecer. Aqui estão os sinais de que é hora de procurar alternativas como o eesel AI:

Você precisa de integrações de API complexas. Se o seu bot precisar buscar dados em vários sistemas, calcular preços ou realizar ações que demorem mais do que alguns segundos, as restrições de tempo limite do Zendesk o bloquearão. O eesel AI não possui restrições de tempo limite de API, portanto, seu bot pode levar o tempo necessário para reunir informações e concluir ações.

Você deseja testar antes de entrar no ar. O Zendesk não oferece uma maneira de simular conversas de bot em tickets históricos antes de implantar para os clientes. Com o eesel AI, você pode executar simulações em tickets passados para medir a precisão e identificar lacunas antes que qualquer cliente veja o bot.

Você prefere configuração em linguagem natural. Em vez de construir árvores de gatilhos complexas e diagramas de fluxo, você pode descrever o que deseja que o bot faça em linguagem natural. "Se o cliente perguntar sobre reembolsos com mais de 30 dias, recuse educadamente e ofereça crédito na loja." Sem código, sem árvores de decisão rígidas.

Você deseja uma implementação progressiva. Comece com o bot redigindo respostas para os agentes revisarem. Quando estiver confiante em seu desempenho, deixe-o enviar respostas diretamente. Em seguida, expanda para mais tipos de tickets. Essa progressão controlada não é possível com a abordagem "tudo ou nada" do Zendesk.

Equipes como a Discuss.io fizeram a mudança exatamente por esses motivos. Como disse o administrador do Zendesk deles: "O eesel AI simplifica nosso fluxo de trabalho, aumenta a produtividade e garante um nível mais alto de consistência no serviço."

Dicas de prevenção e monitoramento

Depois de colocar seu bot para funcionar, mantenha-o assim com estas práticas:

Acompanhe as métricas de integridade do bot. Monitore as taxas de resposta, taxas de encaminhamento e pontuações de satisfação do cliente semanalmente. Um aumento repentino nos encaminhamentos geralmente indica que uma alteração de configuração quebrou algo.

Configure testes automatizados. Crie um conjunto de conversas de teste que cubram as intenções mais comuns dos seus clientes. Execute-os semanalmente para detectar regressões antes que os clientes percebam.

Implante alterações de forma incremental. Não envie atualizações importantes do bot na tarde de sexta-feira. Faça alterações durante períodos de baixo tráfego e monitore problemas antes de expandir.

Revise os logs de conversa semanalmente. Gaste 30 minutos por semana lendo as conversas do bot que foram encaminhadas para agentes. Você notará padrões no que está confundindo o bot e poderá ajustar os dados de treinamento de acordo.

Colocando seu bot do Zendesk de volta online

Vamos recapitular as correções que realmente funcionam:

1. Verifique a instalação do widget e cuidado com bloqueadores de anúncios
2. Verifique a configuração de autenticação para usuários conectados
3. Audite gatilhos para conflitos e loops de roteamento
4. Limpe os dados de treinamento de intenção e defina limites de confiança
5. Garanta que os artigos da central de ajuda estejam acessíveis e organizados
6. Contorne as restrições de tempo limite da API (ou encontre uma plataforma sem elas)
7. Ajuste as configurações de tempo limite de inatividade e devolução
8. Teste as implementações do SDK móvel separadamente da web

Se você tentou tudo isso e ainda está travado, pode ser hora de escalar para o suporte do Zendesk com seus IDs de conversa e carimbos de data/hora. Ou, se você estiver enfrentando limitações fundamentais da plataforma, considere se a integração do eesel AI com o Zendesk pode ser uma solução melhor para suas necessidades.

O objetivo não é fazer os bots nativos do Zendesk fazerem algo para o qual não foram projetados. É dar aos seus clientes o suporte de que precisam, independentemente de como você consiga isso. Às vezes, isso significa corrigir a configuração. Às vezes, significa encontrar uma ferramenta que corresponda melhor aos seus requisitos.