Evolution API

​

Instalación

pnpm add @botmesh/core @botmesh/evolution

​

Uso

import { EvolutionProvider } from '@botmesh/evolution'

const provider = new EvolutionProvider({
  baseUrl: 'http://localhost:8080',
  apiKey: process.env.EVOLUTION_API_KEY!,
  instance: 'my-instance',
  webhookSecret: process.env.EVOLUTION_WEBHOOK_SECRET!, // or webhookJwtKey
})
// POST /webhook/evolution → res.sendStatus(provider.ingest(body, headers))

• start() comprueba la instancia; si no está vinculada, el QR o el código de emparejamiento llega en la actualización connection (authPayload).
• Los gemelos LID/PN que envía Evolution se enlazan antes de emitir; pasa identityPersistence para mantener los ids estables entre reinicios.
• Encuestas, reacciones, edición (texto), escribiendo y confirmaciones de lectura; botones, listas y cards se degradan a texto numerado; template se rechaza, igual que una encuesta que WhatsApp no puede llevar (menos de 2 o más de 12 opciones, vacías o repetidas).
• Si Evolution deja de ofrecer códigos QR antes de vincular el número (QRCODE_LIMIT), la actualización connection llega como closed con motivo sessionInvalid: llama otra vez a start() para obtener un QR nuevo.
• Deja desactivado webhookByEvents en el webhook de la instancia: con él, Evolution añade el nombre del evento a la URL y una ruta de path exacto responde 404.

​

Siguientes pasos

• Canales: elegir un canal, la matriz de capacidades y el contrato común de los canales.
• WPPConnect: el otro gateway self-hosted, que comparte @botmesh/wa-gateway-kit.
• Servidor de webhooks: monta el provider con @botmesh/server.
• README del paquete