Tay

Assistente pessoal no WhatsApp: um agente de IA que conversa por texto, áudio e foto e só mexe em agenda, lembretes e dinheiro por ferramentas que não inventam.

Case
/004 · 2026
Papel
Consultoria de produto, arquitetura do agente, desenvolvimento da engine, do site, do portal e do painel
Stack
NestJS 11, PostgreSQL 16 + pgvector, Redis + BullMQ, Gemini pelo Vercel AI SDK, Next.js 16, WhatsApp Cloud API, Asaas
/01 contexto

Uma assistente que conversa como gente e não inventa nenhum dado.

A usuária manda áudio, foto, print ou texto pelo WhatsApp oficial da Meta, e a Tay organiza agenda, lembretes, listas, pessoas, finanças e, no plano para empreendedoras, os clientes. Um modelo de linguagem conduz a conversa inteira; o que é dado mora na engine. Antes do código, ficou decidido o que o modelo pode fazer sozinho e o que só uma ferramenta faz.

  1. O modelo conversa, a engine decide

    Nada de classificador barrando a conversa nem resposta enlatada. Mas agenda, lembrete e dinheiro só mudam por ferramenta: o modelo nunca é a fonte da verdade.

  2. Ferramentas grossas

    Cada ferramenta é um fluxo completo (agendar, reagendar, fechar o mês), com validação na entrada e resultado que o modelo só repete.

  3. Só a dona da conta

    A Tay nunca escreve para terceiros, nem para as clientes da usuária: quando precisa, entrega o texto pronto para ela copiar. Fora da janela de 24 h, só com template aprovado pela Meta.

/02 produto

As telas, como foram construídas.

Capturas e gravações do produto rodando, sem montagem.

atay.com.br
Página de vendas · a conversa de exemplo no celular
Página de vendas · a conversa de exemplo no celular
Áudio, foto, print ou mensagem
Áudio, foto, print ou mensagem
Bom-dia com a agenda, boa-noite com o que ficou
Bom-dia com a agenda, boa-noite com o que ficou
atay.com.br
Pro meu negócio · agenda, financeiro e clientes
Pro meu negócio · agenda, financeiro e clientes
Tudo começa no WhatsApp
Tudo começa no WhatsApp
Planos com cobrança recorrente
Planos com cobrança recorrente

Ver a identidade no portfólio da Heffer Studio ›

/03 arquitetura

Como o sistema se organiza.

Camadas da aplicação e a estrutura real do repositório.

  1. CanalWhatsApp Cloud API oficial · webhook → fila BullMQ · áudio e imagem nativos
  2. AgenteGemini 3.1 Flash-Lite pelo Vercel AI SDK · prompt em camadas com cache
  3. EngineNestJS 11 · 40 ferramentas · guardas contra invenção e ações destrutivas
  4. DadosPostgreSQL 16 com RLS por usuária · pgvector para memória · Redis
  5. SuperfíciesNext.js 16: site, portal, checkout e painel interno · cobrança pelo Asaas
tree
tay/
├─ apps/api/ ............ engine NestJS · 40 ferramentas
├─ apps/api/evals/ ...... cenários contra o modelo real
├─ apps/web/ ............ site, portal e checkout
├─ apps/admin/ .......... painel interno · custos e turnos
├─ packages/shared/ ..... planos e contratos em zod
├─ packages/ui/ ......... tema da marca, web e admin
├─ packages/emails/ ..... e-mails transacionais
└─ docs/adr/ ............ decisões registradas
/04 implementação

Decisões que sustentam o produto.

  1. 01

    Confirmar antes de apagar

    Exclusões passam por confirmação em duas fases, amarrada ao item exato, com uma trava extra que atravessa turnos: um sim solto não apaga a coisa errada.

  2. 02

    A resposta conferida com o que aconteceu

    Guardas no código comparam o que a Tay diz com o que as ferramentas fizeram, e o painel marca cada suspeita de invenção, turno a turno, para revisão.

  3. 03

    Custo medido por conversa

    Persona e ferramentas formam um prefixo estável que o cache do modelo reaproveita; o custo de cada turno aparece no painel interno.

  4. 04

    Isolamento no banco

    Cada usuária só enxerga os próprios dados por políticas de segurança por linha no Postgres, não só por filtro no código.

  5. 05

    Testado contra o modelo real

    Além dos testes unitários, uma suíte de cenários roda contra o modelo de produção com um juiz automático, e um simulador conversa com a Tay ao longo de uma semana inteira.

/05 entrega

O que foi entregue.

A Tay está em produção com usuárias reais: número de WhatsApp próprio, templates aprovados pela Meta, cobrança ativa e cada turno da conversa auditável no painel.

  • 40ferramentas determinísticas
  • 500+arquivos de teste na engine
  • 96migrações versionadas
  • 3apps sobre a mesma engine
  • Consultoria de produto
  • Agente de IA no WhatsApp
  • Engine com 40 ferramentas
  • Site de vendas e portal web
  • Cobrança recorrente
  • Painel interno com custos e turnos

métricas de uso a incluir quando medidas em produção

Próximo case ›CronofioApp nativo de iPhone que monta um cronograma capilar de quatro semanas: motor de regras em Swift, IA só no servidor e marca desenhada junto.
heffer@dev: ~/novo-projeto

$ heffer contato --novo-projeto agenda aberta · 1º semestre 2027

Antes do código, a decisão.

› Um brief completo ou uma ideia solta servem. Na primeira conversa entendemos o problema e mostramos como o diagnóstico chega a um escopo fechado.

› e-mail ...... dev@heffer.studio

› whatsapp .... +55 00 00000-0000

contatos provisórios
Respondemos em até dois dias úteis.

$