Bot de WhatsApp da FTW
Atendimento ao consumidor D2C · plataforma NeoAssist · situacao em 19 de agosto de 2026
1O que ja esta pronto
Tudo abaixo foi construido e testado no simulador da plataforma com dados reais de cliente.
Endpoint de identificacao do cliente
No arConsulta o CPF ou CNPJ direto no SAP Business One e devolve nome, codigo do cliente e primeiro nome ja tratado. Responde em 2,5 segundos.
Endpoint de historico de compras
No arConsulta pedidos de venda e notas fiscais no SAP, junta os dois, remove duplicidade e ordena por data. Devolve numero, data, valor, situacao, nota fiscal, transportadora e forma de pagamento. Extrai o numero que o cliente conhece do site, que fica gravado dentro do campo de observacao do documento.
Aviso de espera em toda consulta
No arAntes de cada consulta ao SAP o bot avisa que esta verificando. A conversa nunca fica em silencio enquanto o sistema responde.
Contingencia dos endpoints
No arSe o SAP cair, ficar lento ou o documento nao existir, a resposta continua valida e o bot segue a conversa em vez de travar. Antes o erro derrubava o atendimento.
Identificacao no inicio da conversa
No arO bot pede o CPF, consulta, vincula a ficha do consumidor na plataforma e cumprimenta a pessoa pelo nome.
Cadastro de quem nao tem ficha
No arQuem nao e encontrado informa nome e sobrenome. O bot confirma e registra, e nao pede de novo nas proximas conversas.
Abertura proativa
No arDepois de identificar, o bot cita o ultimo pedido e pergunta se o assunto e aquele, com opcao de mudar de assunto ou falar com atendente.
Contexto nos agentes de IA
No arOs quatro agentes de consumidor recebem nome, documento, codigo, ultimo pedido e historico. Eles nao pedem nada de novo e chamam a pessoa pelo nome.
Saida para atendente em qualquer ponto
No arBotao Falar com atendente no menu, transbordo pelos agentes e opcao na abertura proativa.
Tratamento de fila indisponivel e ocupada
No arOs dez nos de transbordo tinham vinte saidas sem destino. Fora do horario ou com fila cheia o cliente ficava sem nenhuma resposta. Agora existe mensagem para as duas situacoes, e o teste no simulador confirmou que a plataforma entrega as duas saidas ligadas aos blocos certos.
Menu enxugado para o consumidor FTW
No arSeis opcoes de consumidor mais uma porta de saida para quem nao e consumidor, para ninguem ficar sem caminho.
Fila de atendimento do CX criada
No arDepartamento CX Consumidor FTW cadastrado na plataforma, com prazo de 4 horas uteis, vinculado a arvore de categorias FTW e com as operadoras Renata Roberta e Brida Braceiro. O CX Casos que ja existia ficou intacto.
Horas uteis conferidas dia a dia
No arSegunda a quinta das 8h as 18h e sexta das 8h as 17h, para todas as nove origens de atendimento, incluindo Whatsapp e Chatbot. Sabado e domingo sem periodo, ou seja, fora do expediente.
2A prova
Conversas reais rodadas no simulador. A da esquerda usa um CPF que existe no SAP. A da direita usa um documento sem cadastro.
3O que estava quebrado e foi corrigido
Encontrado na revisao final, rodando o simulador em vez de confiar na tela do construtor. Sem esta etapa o bot iria ao ar mudo.
| Problema | Situacao |
|---|---|
| Sintaxe das variaveis Os textos usavam chaves duplas. A plataforma le porcentagem. Todo texto personalizado sairia com o codigo na cara do cliente. | Corrigido em 8 pontos |
| Variaveis nao declaradas A plataforma exige que cada variavel seja registrada em uma lista propria. A lista estava vazia. | 13 variaveis registradas |
| Sete ligacoes mortas As ligacoes entre os blocos novos tinham um caractere a mais no identificador. O desenho aparecia na tela e o motor ignorava. A conversa terminava logo apos o cliente digitar o CPF. | Refeitas e testadas |
| Comparacoes que nunca batiam As condicoes comparavam verdadeiro ou falso com texto. Nunca eram verdadeiras, entao todo cliente caia no caminho de quem nao tem cadastro. | Trocadas por comparacao de texto |
| Integracao com parametro errado A integracao ja existente enviava o documento com nome de campo que o endpoint nao le, e chegava vazia. Acumulava dez erros desde 5 de agosto. | Corrigida e testada |
| Caminho da variavel com ponto sobrando O codigo do cliente apontava para um caminho invalido e nunca era preenchido. | Corrigido |
| Saudacao sem nome O menu dizia Oi, com virgula e sem nome, para quem nao tinha cadastro. | Corrigido |
| Historico de compras incompleto A consulta lia apenas pedidos de venda. Auditando um cliente real no SAP encontramos 1 pedido e 5 notas fiscais: quatro compras eram faturadas sem pedido e ficavam invisiveis para o bot. O cliente tinha 5 compras e o bot enxergava 1. | Passa a somar notas fiscais |
| Sexta-feira com horario errado na plataforma A tela de horas uteis nao mostra os periodos na listagem, so ao abrir cada dia. Abrindo dia a dia descobrimos que a sexta estava cadastrada das 8h as 18h, uma hora a mais que a regra real, nas nove origens de atendimento. | Ajustada para 8h as 17h |
4O que falta e quem faz
Ordenado por criticidade. Nenhum item desta lista impede mais a abertura do numero, todos podem correr em paralelo com o bot ja atendendo.
| Prioridade | O que falta | Quem faz |
|---|---|---|
| Alto | Usuario de servico no SAP A conexao com o SAP usa hoje o usuario administrador com a senha em texto aberto dentro da automacao. Precisamos de um usuario dedicado, somente leitura, e mover a credencial para o cofre da ferramenta. | TI JL FIT |
| Alto | Renovacao preventiva do token do SAP Uma das consultas levou 16,8 segundos porque o token tinha expirado e foi renovado na hora. O limite da plataforma e 10 segundos. As demais ficaram em 2 segundos. | TI e Roque |
| Alto | Definir a origem do rastreio A auditoria no SAP mostrou que este cliente nao tem nenhum documento de entrega registrado, entao o codigo de rastreio nao esta la. Precisamos definir de onde vem: transportadora, plataforma de envio ou campo proprio. A transportadora ja conseguimos ler, esta na observacao do documento. | TI JL FIT e Roque |
| Medio | Massa de teste Precisamos de tres CPFs e tres CNPJs de teste com pedidos em situacoes diferentes, um cliente com titulo vencido e um documento inexistente. Hoje o teste roda com dado real. | TI JL FIT |
| Medio | Nome da assistente A persona ainda nao tem nome. Os textos estao neutros ate a definicao. | Marketing e CX |
| Medio | Base de conhecimento Sete artigos oficiais do projeto precisam ser cadastrados e vinculados aos agentes para reduzir transbordo. | CX |
| Medio | Consultas que ainda faltam Segunda via de boleto e situacao de pagamento. A nota fiscal ja aparece no historico. | TI JL FIT e Roque |
| Medio | Cadastro na ficha do consumidor O construtor nao tem bloco que grava nome e documento na ficha. Precisamos das chaves de API da NeoAssist para fazer isso por integracao. | NeoAssist |
| Medio | Capacidade simultanea das operadoras A fila CX Consumidor FTW ja existe com as duas operadoras. Falta definir quantos atendimentos cada uma recebe ao mesmo tempo e o que acontece quando as duas estiverem cheias, hoje o cliente cai na mensagem de fila ocupada. | CX |
| Baixo | Pacotes de execucao que faltam Sete arquivos citados no material recebido nao vieram, incluindo o marcado como executar primeiro. | Maykon |
| Baixo | Descricao do fluxo O fluxo esta em uso mas a descricao ainda diz rascunho, nao ativar sem revisao, herdada da versao anterior. | Roque |