Agentes IAWhatsAppExpressNode.js

Agente de IA para WhatsApp com Express.js e Zavu

Aprenda a receber webhooks do WhatsApp em uma API Express, verificar assinaturas e responder com agentes de IA gerenciados pela Zavu.

Escrito por: Jennifer VillalobosRevisado por: Victor Villalobos23 de dezembro de 202510 min de leitura
Ver como Markdown

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

terminal
mkdir whatsapp-agent && cd whatsapp-agent npm init -y bun install @zavudev/sdk express dotenv

Estrutura:

src/
├── app.js
├── webhook.js
└── zavu.js
.env

Cliente Zavu (src/zavu.js)

JavaScript
import Zavudev from '@zavudev/sdk' export const zavu = new Zavudev({ apiKey: process.env.ZAVUDEV_API_KEY })

Webhook (src/webhook.js)

JavaScript
import 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 ? ${timestamp}.${rawBody} : 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)) }

src/app.js:

JavaScript
import 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([${messageId}] ${from}: ${text}) } res.json({ status: 'ok' }) }) app.listen(process.env.PORT || 3000)

Criando o agente

Via dashboard (Senders → AI Agent) ou codigo:

JavaScript
const 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

ProviderModelos
OpenAIgpt-4o, gpt-4o-mini
Anthropicclaude-3-5-sonnet, claude-3-opus
Googlegemini-pro
Mistralmistral-large

Recursos extras

  • Knowledge Bases: zavu.senders.agent.knowledgeBases.create(senderId, ...) cria uma base que ja pertence ao agente; adicione docs (onboarding, politicas) com knowledgeBases.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.

Precisa de ajuda? Contate-nos ou junte-se à nossa comunidade Discord para suporte.

Demo

Veja em ação

Agende uma demonstração personalizada para ver como os Agentes IA da Zavu podem transformar sua comunicação com clientes.

Agente de IA para WhatsApp com Express.js e Zavu | Zavu Blog