@botmesh/core) es una reescritura de la v1, que se publicaba como
@bot-wa/bot-wa-baileys (BaileysClass). El motor es nuevo y agnóstico de
transporte: todo lo de la conexión de WhatsApp (sesión, QR, JIDs, auth) se
movió a un provider que construyes y le pasas al bot. Esta página resume
qué cambia; la guía paso a paso con ejemplos de antes y después es
MIGRATION-v1-to-v2.
Qué corresponde a qué
Comportamiento que cambia
- Los triggers de texto comparan por igualdad normalizada, no por
“contiene”. Pide
{ pattern, match: 'contains' }donde lo necesitabas (Conceptos básicos). - Los handlers de tipo (
onType,bot.when(IMAGE, …)) son de baja especificidad: un handler más específico que también coincide gana salvo que llame actx.pass(). - El evento
'message'se emite para todo mensaje procesado; el catch-all para lo que nadie manejó esbot.onMessage(). - En grupos, las conversaciones son por participante por defecto
(
conversationScope: 'chat'recupera una por chat). - Solo ESM, Node.js 22 o posterior (ver Paquetes y versiones).
- Los flujos
.persistent()solo sobreviven a un reinicio con un store persistente (Store persistente).
Herramientas que ayudan
- La regla de ESLint
botmesh/no-v1-apimarca las llamadas de la v1 y de BuilderBot que ya no existen y nombra su reemplazo. - Canales lista todos los providers que sustituyen a la conexión de WhatsApp integrada.
Siguientes pasos
- Inicio rápido: un proyecto v2 desde cero.
- Flujos conversacionales: el DSL
flow()en detalle. - Guía de actualización: pasar entre prereleases de 2.0.