Assistente de IA no WhatsApp

O agente não lê o catálogo bruto. Monte uma tabela de consumo com os itens elegíveis pela regra do negócio: imóvel marcado para exibição no site e com status de venda, venda e aluguel ou em negociação; lançamento separado de usado; locação com aluguel maior que zero e abaixo de um teto que corta valor digitado errado; produto ativo. Uma linha por item, com as colunas que o cliente pergunta: tipo, bairro, quartos, área, valor e link.

Campos aninhados (infraestrutura, características, fotos) viram texto legível, com um rótulo por campo. Valor sai no padrão brasileiro (R$ 1.250.000,00). Valor zero ou nulo vira uma frase fixa, como 'Entre em contato para informações de valores', nunca R$ 0,00. Lançamento mostra 'a partir de'; usado mostra o valor. A primeira foto vem com URL pública.

O motor SQL do lakehouse não tem função de similaridade de texto. Pré-compute um índice invertido com peso pela raridade do termo e um dicionário de apelidos validado pela área (qj para queijo, bov para bovino). Marque qual palavra do cadastro é a categoria: em muitos ERPs a primeira palavra da descrição é o produto e o resto é marca ou sabor. Sem isso, quem pede picanha recebe um empanado sabor picanha.

Canal externo é superfície de ataque. As consultas ficam fixas no backend; o texto do cliente entra só como parâmetro, validado por lista de caracteres permitidos. A credencial do agente é um token MCP com escopo nas tabelas de consumo, nunca uma chave de API com acesso total. O escopo é congelado na criação: incluir uma tabela exige gerar e trocar o token, e a data de vencimento do token entra no monitoramento.

Quando o mesmo agente atende vários clientes, cada linha leva o tenant_id e o agente filtra por ele sempre. O cache de itens e o cache de contatos ficam em tabelas separadas, cada uma com o seu tenant. Cliente novo entra por configuração, não copiando a transformação de outro.

Expor estoque, custo ou dado de outro cliente num canal externo exige aval escrito. Num caso real, foi aprovado responder se há estoque, não quanto há. Registre a condição junto da aprovação: se o agente passar a mostrar a quantidade, a aprovação deixa de valer. Dado pessoal de outros contatos nunca sai na resposta.

Se o item não existe no catálogo, o agente diz que não encontrou e oferece parecidos. Se existe e está sem estoque, vendido ou reservado, diz que está indisponível. Item vendido ou reservado nunca aparece como disponível.

Escreva quando a IA passa a conversa para um atendente: negociação de preço, reclamação, envio de documento, pergunta fora do catálogo ou pedido do cliente. Cada transferência fica registrada com motivo, fila e horário. O indicador é a parcela de atendimentos resolvidos sem transbordo, por fila e por dia fechado.

Conversa real tem mais de um turno; conversa de um turno é só a abordagem inicial. Agendamento conta só quando existe na tabela de agendamentos; status como pré-agendado ou em atendimento não é visita. Se cliente e IA gravam o mesmo horário em cada turno, o tempo de resposta não é calculável e não deve ser reportado.

A tabela de consumo roda por evento logo depois da fonte, nunca em gatilho manual. Cada linha guarda a data da última carga. Se a carga atrasou além do limite combinado, o agente não confirma disponibilidade e diz que um atendente vai confirmar.