Agente de IA para WhatsApp com Express.js e Zavu
Express continua sendo uma escolha rapida para criar webhooks. Use-o com o AI Gateway da Zavu para liberar agentes inteligentes no WhatsApp sem lidar com SDKs de IA separados.
Setup
terminalmkdir whatsapp-agent && cd whatsapp-agent npm init -y bun install @zavudev/sdk express dotenv
Estrutura:
src/
├── app.js
├── webhook.js
└── zavu.js
.envCliente Zavu (src/zavu.js)
JavaScriptimport Zavudev from '@zavudev/sdk' export const zavu = new Zavudev({ apiKey: process.env.ZAVUDEV_API_KEY })
Webhook (src/webhook.js)
JavaScriptimport crypto from 'crypto' // X-Zavu-Signature: t=<segundos>,v2=<hex> (v1=<hex> em webhooks antigos). // v2 assina "<t>.<body>"; v1 assina apenas o body. export function verifySignature(rawBody, header) { const secret = process.env.ZAVU_WEBHOOK_SECRET if (!header || !secret) return false const parts = {} for (const piece of header.split(',')) { const i = piece.indexOf('=') if (i > 0) parts[piece.slice(0, i)] = piece.slice(i + 1) } const timestamp = Number(parts.t) if (!Number.isFinite(timestamp)) return false const age = Math.floor(Date.now() / 1000) - timestamp if (age > 300 || age < -60) return false const received = parts.v2 ?? parts.v1 if (!received) return false const signed = parts.v2 ?: rawBody const expected = crypto.createHmac('sha256', secret).update(signed).digest('hex') if (expected.length !== received.length) return false return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(received)) }${timestamp}.${rawBody}
src/app.js:
JavaScriptimport express from 'express' import { verifySignature } from './webhook.js' const app = express() // Body cru: a assinatura cobre os bytes exatos que a Zavu enviou app.post('/webhooks/whatsapp', express.raw({ type: 'application/json' }), (req, res) => { const rawBody = req.body.toString('utf8') const signature = req.headers['x-zavu-signature'] if (!verifySignature(rawBody, signature)) { return res.status(401).send('invalid signature') } const event = JSON.parse(rawBody) if (event.type === 'message.inbound') { // Com o agente ativado, a Zavu responde sozinha. Aqui voce so registra // ou aplica sua propria logica de negocio. const { messageId, from, text } = event.data console.log() } res.json({ status: 'ok' }) }) app.listen(process.env.PORT || 3000)[${messageId}] ${from}: ${text}
Criando o agente
Via dashboard (Senders → AI Agent) ou codigo:
JavaScriptconst senderId = process.env.ZAVU_SENDER_ID await zavu.senders.agent.create(senderId, { name: 'Atendente Express', provider: 'zavu', model: 'gpt-4o-mini', systemPrompt:Voce e um atendente Zavu. Seja direto e gentil., includeContactMetadata: true, contextWindowMessages: 10 }) // O agente e criado desativado. Ative-o quando estiver configurado: await zavu.senders.agent.update(senderId, { enabled: true })
Modelos suportados
| Provider | Modelos |
|---|---|
| OpenAI | gpt-4o, gpt-4o-mini |
| Anthropic | claude-3-5-sonnet, claude-3-opus |
| gemini-pro | |
| Mistral | mistral-large |
Recursos extras
- Knowledge Bases:
zavu.senders.agent.knowledgeBases.create(senderId, ...)cria uma base que ja pertence ao agente; adicione docs (onboarding, politicas) comknowledgeBases.documents.create. - Ferramentas HTTP:
zavu.senders.agent.tools.create(senderId, ...)registra um endpoint seu que o agente chama quando precisa de um dado. - Metricas: a aba Agent do sender e
zavu.senders.agent.stats(senderId)mostram tokens, custo, latencia e execucoes. - Fallback: com
fallbackEnabled, uma mensagem de texto ou template do WhatsApp que falhar e reenviada por SMS, se o sender tiver SMS. Fora da janela de 24h, use um template.
Deploy
- Use Railway, Render ou Fly.io
- Configure variaveis (
ZAVUDEV_API_KEY,ZAVU_WEBHOOK_SECRET,ZAVU_SENDER_ID) - Habilite HTTPS (Proxy/CDN) e rotacione o segredo periodicamente
Pronto! Seu agente Express responde clientes no WhatsApp com IA de ultima geracao. Agende uma demo para ver workflows mais avancados.