WhatsApp

Estado: listo para producción a través de WhatsApp Web (Baileys). La puerta de enlace es propietaria de la(s) sesión(es) vinculada(s).

Instalación (bajo demanda)

• Incorporación (openclaw onboard) y openclaw channels add --channel whatsapp solicitan instalar el complemento de WhatsApp la primera vez que lo seleccionas.
• openclaw channels login --channel whatsapp también ofrece el flujo de instalación cuando el complemento aún no está presente.
• Canal de desarrollo + git checkout: predeterminado a la ruta local del complemento.
• Estable/Beta: instala el complemento oficial @openclaw/whatsapp de ClawHub primero, con npm como alternativa.
• El tiempo de ejecución de WhatsApp se distribuye fuera del paquete npm principal de OpenClaw para que las dependencias de tiempo de ejecución específicas de WhatsApp se mantengan con el complemento externo.

La instalación manual sigue disponible:

openclaw plugins install clawhub:@openclaw/whatsapp

Use el paquete npm básico (@openclaw/whatsapp) solo cuando necesite el registro alternativo. Fije una versión exacta solo cuando necesite una instalación reproducible.

Emparejamiento

La política de MD predeterminada es el emparejamiento para remitentes desconocidos.

Solución de problemas del canal

Manuales de diagnóstico y reparación multicanal.

Configuración del puerta de enlace

Patrones y ejemplos completos de configuración del canal.

Configuración rápida

1. Configurar la política de acceso de WhatsApp

   {
     channels: {
       whatsapp: {
         dmPolicy: "pairing",
         allowFrom: ["+15551234567"],
         groupPolicy: "allowlist",
         groupAllowFrom: ["+15551234567"],
       },
     },
   }

2. Vincular WhatsApp (QR)

   openclaw channels login --channel whatsapp

   Para una cuenta específica:

   openclaw channels login --channel whatsapp --account work

   Para adjuntar un directorio de autenticación de WhatsApp Web existente/personalizado antes del inicio de sesión:

   openclaw channels add --channel whatsapp --account work --auth-dir /path/to/wa-auth
   openclaw channels login --channel whatsapp --account work

3. Iniciar el puerta de enlace

   openclaw gateway

4. Aprobar la primera solicitud de emparejamiento (si usa el modo de emparejamiento)

   openclaw pairing list whatsapp
   openclaw pairing approve whatsapp

       Las solicitudes de emparejamiento caducan después de 1 hora. Las solicitudes pendientes están limitadas a 3 por canal.

Note

OpenClaw recomienda ejecutar WhatsApp en un número separado cuando sea posible. (Los metadatos del canal y el flujo de configuración están optimizados para esa configuración, pero las configuraciones con número personal también son compatibles.)

Patrones de despliegue

Número dedicado (recomendado)

Este es el modo operativo más limpio:

• identidad de WhatsApp separada para OpenClaw
• listas permitidas de MD y límites de enrutamiento más claros
• menor probabilidad de confusión en el chat propio

Patrón de política mínima:

{
  channels: {
    whatsapp: {
      dmPolicy: "allowlist",
      allowFrom: ["+15551234567"],
    },
  },
}

Respaldo con número personal

La integración admite el modo de número personal y escribe una línea base compatible con el autoservicio:

• dmPolicy: "allowlist"
• allowFrom incluye su número personal
• selfChatMode: true

En tiempo de ejecución, las protecciones de autoservicio se basan en el número propio vinculado y allowFrom.

Ámbito del canal solo para WhatsApp Web

El canal de la plataforma de mensajería se basa en WhatsApp Web (Baileys) en la arquitectura actual del canal de OpenClaw.

No hay un canal de mensajería Twilio WhatsApp separado en el registro de canales de chat integrado.

Modelo de tiempo de ejecución

• El Gateway posee el socket de WhatsApp y el bucle de reconexión.
• El perro guardián de reconexión utiliza la actividad de transporte de WhatsApp Web, no solo el volumen de mensajes de aplicación entrantes, por lo que una sesión de dispositivo vinculado silenciosa no se reinicia únicamente porque nadie haya enviado un mensaje recientemente. Un límite más largo de silencio de la aplicación aún fuerza una reconexión si siguen llegando tramas de transporte pero no se manejan mensajes de aplicación durante la ventana del perro guardián; después de una reconexión transitoria para una sesión activa recientemente, esa verificación de silencio de la aplicación utiliza el tiempo de espera normal del mensaje para la primera ventana de recuperación.
• Los tiempos del socket Baileys son explícitos bajo web.whatsapp.*: keepAliveIntervalMs controla los pings de la aplicación WhatsApp Web, connectTimeoutMs controla el tiempo de espera del apretón de manos de apertura y defaultQueryTimeoutMs controla los tiempos de espera de las consultas Baileys.
• Los envíos salientes requieren un escucha de WhatsApp activo para la cuenta de destino.
• Los envíos grupales adjuntan metadatos de mención nativa para los tokens @+<digits> y @<digits> en el texto y los subtítulos de medios cuando el token coincide con los metadatos del participante actual de WhatsApp, incluidos los grupos respaldados por LID.
• Los chats de estado y de difusión se ignoran (@status, @broadcast).
• El perro guardián de reconexión sigue la actividad del transporte de WhatsApp Web, no solo el volumen de mensajes entrantes de la aplicación: las sesiones de dispositivo vinculado silenciosas se mantienen activas mientras continúan los marcos de transporte, pero un estancamiento del transporte fuerza la reconexión mucho antes de la ruta posterior de desconexión remota.
• Los chats directos utilizan reglas de sesión de DM (session.dmScope; el valor predeterminado main contrae los DM a la sesión principal del agente).
• Las sesiones de grupo están aisladas (agent:<agentId>:whatsapp:group:<jid>).
• Los Canales/Boletines de WhatsApp pueden ser objetivos de salida explícitos con su JID nativo @newsletter. Los envíos de boletines de salida utilizan metadatos de sesión del canal (agent:<agentId>:whatsapp:channel:<jid>) en lugar de semánticas de sesión de DM.
• El transporte de WhatsApp Web respeta las variables de entorno de proxy estándar en el host de la puerta de enlace (HTTPS_PROXY, HTTP_PROXY, NO_PROXY / variantes en minúsculas). Se prefiere la configuración de proxy a nivel de host sobre la configuración de proxy específica de WhatsApp del canal.
• Cuando messages.removeAckAfterReply está habilitado, OpenClaw borra la reacción de reconocimiento de WhatsApp después de que se entrega una respuesta visible.

Ganchos del plugin y privacidad

Los mensajes entrantes de WhatsApp pueden contener contenido de mensajes personales, números de teléfono, identificadores de grupo, nombres de remitentes y campos de correlación de sesión. Por esa razón, WhatsApp no difunde cargas útiles de hook entrantes message_received a los complementos a menos que usted acepte explícitamente:

{
  channels: {
    whatsapp: {
      pluginHooks: {
        messageReceived: true,
      },
    },
  },
}

Puede limitar la participación a una sola cuenta:

{
  channels: {
    whatsapp: {
      accounts: {
        work: {
          pluginHooks: {
            messageReceived: true,
          },
        },
      },
    },
  },
}

Habilite esto solo para complementos en los que confíe para recibir contenido e identificadores de mensajes entrantes de WhatsApp.

Control de acceso y activación

Política de MDGroup policy + allowlistsMentions + /activation

channels.whatsapp.dmPolicy controla el acceso al chat directo:

• pairing (predeterminado)
• allowlist
• open (requiere que allowFrom incluya "*")
• disabled

allowFrom acepta números con estilo E.164 (normalizados internamente).

allowFrom es una lista de control de acceso de remitentes de MD. No regula los envíos de salida explícitos a JIDs de grupos de WhatsApp o JIDs de canales @newsletter.

Anulación multicuenta: `channels.whatsapp.accounts.

.dmPolicy(yallowFrom`) tienen prioridad sobre los valores predeterminados de nivel de canal para esa cuenta.

Detalles del comportamiento de tiempo de ejecución:

- los emparejamientos se persisten en el almacén de permitidos del canal y se fusionan con `allowFrom` configurado
- la automatización programada y la alternativa de destinatario de latido utilizan objetivos de entrega explícitos o `allowFrom` configurado; las aprobaciones de emparejamiento de MD no son destinatarios implícitos de cron o latido
- si no se configura ninguna lista de permitidos, el número propio vinculado se permite de forma predeterminada
- OpenClaw nunca empareja automáticamente los MD `fromMe` de salida (mensajes que te envías a ti mismo desde el dispositivo vinculado)

El acceso al grupo tiene dos capas:

1. Lista de permitidos de membresía del grupo (channels.whatsapp.groups)

   • si groups se omite, todos los grupos son elegibles
   • si groups está presente, actúa como una lista de permitidos del grupo ("*" permitidos)

2. Política de remitente del grupo (channels.whatsapp.groupPolicy + groupAllowFrom)

   • open: lista de permitidos de remitentes omitida
   • allowlist: el remitente debe coincidir con groupAllowFrom (o *)
   • disabled: bloquear toda la entrada del grupo

Respaldo de la lista de permitidos de remitentes:

• si groupAllowFrom no está configurado, el tiempo de ejecución recurre a allowFrom cuando esté disponible
• las listas de permitidos de remitentes se evalúan antes de la activación de mención/respuesta

Nota: si no existe ningún bloque channels.whatsapp en absoluto, el respaldo de la política de grupo del tiempo de ejecución es allowlist (con un registro de advertencia), incluso si channels.defaults.groupPolicy está configurado.

Las respuestas del grupo requieren mención de forma predeterminada.

La detección de menciones incluye:

• menciones explícitas de WhatsApp de la identidad del bot
• patrones de regex de mención configurados (agents.list[].groupChat.mentionPatterns, respaldo messages.groupChat.mentionPatterns)
• transcripciones de notas de voz entrantes para mensajes de grupo autorizados
• detección implícita de respuesta al bot (el remitente de la respuesta coincide con la identidad del bot)

Nota de seguridad:

• citar/responder solo satisface el filtro de mención; no otorga autorización al remitente
• con groupPolicy: "allowlist", los remitentes no incluidos en la lista de permitidos todavía se bloquean incluso si responden al mensaje de un usuario permitido

Comando de activación a nivel de sesión:

• /activation mention
• /activation always

activation actualiza el estado de la sesión (no la configuración global). Está restringido al propietario.

Comportamiento del número personal y del chat propio

Cuando el número propio vinculado también está presente en allowFrom, se activan las salvaguardas de autocomunicación de WhatsApp:

• omitir confirmaciones de lectura para los turnos de chat propio
• ignorar el comportamiento de activación automática de mention-JID que de otro modo te notificaría a ti mismo
• si messages.responsePrefix no está establecido, las respuestas de chat propio usan por defecto [{identity.name}] o [openclaw]

Normalización de mensajes y contexto

Sobre entrante + contexto de respuesta

Los mensajes entrantes de WhatsApp se envuelven en el sobre entrante compartido.

Si existe una respuesta citada, el contexto se añade de esta forma:

[Replying to

id:

]

[/Replying]

Los campos de metadatos de respuesta también se rellenan cuando están disponibles (`ReplyToId`, `ReplyToBody`, `ReplyToSender`, remitente JID/E.164).
Cuando el objetivo de la respuesta citada es medios descargables, OpenClaw los guarda a través del
almacén normal de medios entrantes y los expone como `MediaPath`/`MediaType` para que
el agente pueda inspeccionar la imagen referenciada en lugar de solo ver
`

`.

Marcadores de posición de medios y extracción de ubicación/contacto

Los mensajes entrantes de solo medios se normalizan con marcadores de posición como:

• `

-

-

-

-

`

Las notas de voz de grupos autorizadas se transcriben antes del filtrado de menciones cuando el
cuerpo es solo `

`, por lo que decir la mención del bot en la nota de voz puede activar la respuesta. Si la transcripción aún no menciona al bot, la transcripción se mantiene en el historial pendiente del grupo en lugar del marcador de posición sin procesar.

Los cuerpos de ubicación usan texto de coordenadas breve. Las etiquetas/comentarios de ubicación y los detalles de contacto/vCard se renderizan como metadatos no confinados cercados, no como texto de solicitud en línea.

Inyección de historial pendiente de grupos

Para grupos, los mensajes no procesados pueden almacenarse en el búfer e inyectarse como contexto cuando el bot finalmente se activa.

• límite predeterminado: 50
• configuración: channels.whatsapp.historyLimit
• alternativa: messages.groupChat.historyLimit
• 0 deshabilita

Marcadores de inyección:

• [Chat messages since your last reply - for context]
• [Current message - respond to this]

Confirmaciones de lectura

Las confirmaciones de lectura están habilitadas por defecto para los mensajes entrantes de WhatsApp aceptados.

Deshabilitar globalmente:

{
  channels: {
    whatsapp: {
      sendReadReceipts: false,
    },
  },
}

Anulación por cuenta:

{
  channels: {
    whatsapp: {
      accounts: {
        work: {
          sendReadReceipts: false,
        },
      },
    },
  },
}

El chat propio omite las confirmaciones de lectura incluso cuando están habilitadas globalmente.

Entrega, fragmentación y medios

Segmentación de texto

• límite de segmentación predeterminado: channels.whatsapp.textChunkLimit = 4000
• channels.whatsapp.chunkMode = "length" | "newline"
• el modo newline prefiere los límites de párrafo (líneas en blanco), y luego recurre a una segmentación segura en longitud

Comportamiento de medios salientes

• soporta cargas útiles de imagen, video, audio (nota de voz PTT) y documentos
• los medios de audio se envían a través de la carga útil audio de Baileys con ptt: true, por lo que los clientes de WhatsApp lo reproducen como una nota de voz de pulsar para hablar
• las cargas útiles de respuesta preservan audioAsVoice; la salida de nota de voz TTS para WhatsApp se mantiene en esta ruta PTT incluso cuando el proveedor devuelve MP3 o WebM
• el audio nativo Ogg/Opus se envía como audio/ogg; codecs=opus para la compatibilidad con notas de voz
• el audio no Ogg, incluida la salida MP3/WebM de Microsoft Edge TTS, se transcodifica con ffmpeg a Ogg/Opus mono de 48 kHz antes de la entrega PTT
• /tts latest envía la última respuesta del asistente como una sola nota de voz y suprime los envíos repetidos para la misma respuesta; /tts chat on|off|default controla el TTS automático para el chat actual de WhatsApp
• la reproducción de GIF animados es compatible a través de gifPlayback: true en envíos de video
• forceDocument / asDocument envía imágenes, GIF y videos salientes a través de la carga útil de documento de Baileys para evitar la compresión de medios de WhatsApp mientras se preserva el nombre de archivo resuelto y el tipo MIME
• los subtítulos se aplican al primer elemento multimedia al enviar cargas útiles de respuesta multimedia, excepto que las notas de voz PTT envían primero el audio y el texto visible por separado porque los clientes de WhatsApp no reproducen los subtítulos de notas de voz de manera consistente
• la fuente multimedia puede ser HTTP(S), file:// o rutas locales

Límites de tamaño de medios y comportamiento de respaldo

• límite de guardado de medios entrantes: channels.whatsapp.mediaMaxMb (predeterminado 50)
• límite de envío de medios salientes: channels.whatsapp.mediaMaxMb (predeterminado 50)
• las anulaciones por cuenta usan `channels.whatsapp.accounts.

.mediaMaxMb - las imágenes se optimizan automáticamente (redimensionamiento/barrido de calidad) para ajustarse a los límites a menos queforceDocument/asDocument` solicite la entrega como documento - ante un fallo en el envío de medios, la alternativa del primer elemento envía una advertencia de texto en lugar de eliminar silenciosamente la respuesta

Citar respuesta

WhatsApp admite las citas de respuesta nativas, donde las respuestas salientes citan visiblemente el mensaje entrante. Controle esto con channels.whatsapp.replyToMode.

Valor	Comportamiento
"off"	Nunca citar; enviar como un mensaje simple
"first"	Citar solo el primer fragmento de respuesta saliente
"all"	Citar cada fragmento de respuesta saliente
"batched"	Citar respuestas por lotes en cola dejando las respuestas inmediatas sin citar

El valor predeterminado es "off". Las anulaciones por cuenta usan channels.whatsapp.accounts.<id>.replyToMode.

{
  channels: {
    whatsapp: {
      replyToMode: "first",
    },
  },
}

Nivel de reacción

channels.whatsapp.reactionLevel controla la amplitud con la que el agente usa reacciones con emojis en WhatsApp:

Nivel	Reacciones de acuse de recibo	Reacciones iniciadas por el agente	Descripción
"off"	No	No	Sin reacciones en absoluto
"ack"	Sí	No	Solo reacciones de acuse de recibo (acuse de recibo previo a la respuesta)
"minimal"	Sí	Sí (conservador)	Reacciones de acuse de recibo + del agente con orientación conservadora
"extensive"	Sí	Sí (animado)	Reacciones de acuse de recibo + del agente con orientación animada

Predeterminado: "minimal".

Las anulaciones por cuenta usan channels.whatsapp.accounts.<id>.reactionLevel.

{
  channels: {
    whatsapp: {
      reactionLevel: "ack",
    },
  },
}

Reacciones de acuse de recibo

WhatsApp admite reacciones de reconocimiento inmediatas en la recepción entrante a través de channels.whatsapp.ackReaction. Las reacciones de reconocimiento están controladas por reactionLevel; se suprimen cuando reactionLevel es "off".

{
  channels: {
    whatsapp: {
      ackReaction: {
        emoji: "👀",
        direct: true,
        group: "mentions", // always | mentions | never
      },
    },
  },
}

Notas de comportamiento:

• enviadas inmediatamente después de que se acepta el mensaje entrante (previo a la respuesta)
• los fallos se registran pero no bloquean la entrega de respuestas normales
• el modo de grupo mentions reacciona en los turnos activados por menciones; la activación de grupo always actúa como omisión para esta verificación
• WhatsApp usa channels.whatsapp.ackReaction (el messages.ackReaction heredado no se usa aquí)

Reacciones de estado del ciclo de vida

Establezca messages.statusReactions.enabled: true para permitir que WhatsApp reemplace la reacción de ack durante un turno en lugar de dejar un emoji de recibo estático. Cuando está habilitado, OpenClaw usa la misma ranura de reacción de mensaje entrante para estados del ciclo de vida como en cola, pensando, actividad de herramientas, compactación, hecho y error.

{
  messages: {
    statusReactions: {
      enabled: true,
      emojis: {
        deploy: "🛫",
        build: "🏗️",
        concierge: "💁",
      },
    },
  },
}

Notas sobre el comportamiento:

• channels.whatsapp.ackReaction todavía controla si las reacciones de estado son elegibles para mensajes directos y grupos.
• WhatsApp tiene una ranura de reacción de bot por mensaje, por lo que las actualizaciones del ciclo de vida reemplazan la reacción actual en su lugar.
• messages.removeAckAfterReply: true borra la reacción de estado final después de la espera de hecho/error configurada.
• Las categorías de emoji de herramientas incluyen tool, coding, web, deploy, build y concierge.

Multicuenta y credenciales

Selección de cuenta y valores predeterminados

• los ids de cuenta provienen de channels.whatsapp.accounts
• selección de cuenta predeterminada: default si está presente, de lo contrario el primer id de cuenta configurado (ordenado)
• los ids de cuenta se normalizan internamente para la búsqueda

Rutas de credenciales y compatibilidad con versiones anteriores

• ruta de autenticación actual: `~/.openclaw/credentials/whatsapp/

/creds.json - archivo de respaldo:creds.json.bak - autenticación predeterminada heredada en~/.openclaw/credentials/` todavía se reconoce/migra para flujos de cuenta predeterminada

Comportamiento de cierre de sesión

`openclaw channels logout —channel whatsapp [—account

]` borra el estado de autenticación de WhatsApp para esa cuenta.

Cuando un Gateway es accesible, el cierre de sesión primero detiene el escucha de WhatsApp en vivo para la cuenta seleccionada para que la sesión vinculada no siga recibiendo mensajes hasta el próximo reinicio. `openclaw channels remove --channel whatsapp` también detiene el escucha en vivo antes de deshabilitar o eliminar la configuración de la cuenta.

En directorios de autenticación heredados, `oauth.json` se conserva mientras se eliminan los archivos de autenticación de Baileys.

Herramientas, acciones y escrituras de configuración

• El soporte de herramientas del agente incluye la acción de reacción de WhatsApp (react).
• Condicionales de acción:
  • channels.whatsapp.actions.reactions
  • channels.whatsapp.actions.polls
• Las escrituras de configuración iniciadas por el canal están habilitadas de forma predeterminada (desactívelas mediante channels.whatsapp.configWrites=false).

Solución de problemas

No vinculado (se requiere QR)

Síntoma: el estado del canal informa que no está vinculado.

Solución:

openclaw channels login --channel whatsapp
openclaw channels status

Vinculado pero desconectado / bucle de reconexión

Síntoma: cuenta vinculada con desconexiones repetidas o intentos de reconexión.

Las cuentas silenciosas pueden permanecer conectadas más allá del tiempo de espera normal del mensaje; el perro guardián se reinicia cuando se detiene la actividad de transporte de WhatsApp Web, se cierra el socket o la actividad a nivel de aplicación permanece en silencio más allá de la ventana de seguridad más larga.

Si los registros muestran status=408 Request Time-out Connection was lost repetidos, ajuste los tiempos del socket Baileys en web.whatsapp. Comience acortando keepAliveIntervalMs por debajo del tiempo de espera de inactividad de su red y aumentando connectTimeoutMs en enlaces lentos o con pérdidas:

{
  web: {
    whatsapp: {
      keepAliveIntervalMs: 15000,
      connectTimeoutMs: 60000,
      defaultQueryTimeoutMs: 60000,
    },
  },
}

Solución:

openclaw doctor
openclaw logs --follow

Si ~/.openclaw/logs/whatsapp-health.log dice Gateway inactive pero openclaw gateway status y openclaw channels status --probe muestran que la puerta de enlace y WhatsApp están sanos, ejecute openclaw doctor. En Linux, el doctor advierte sobre entradas de crontab heredadas que todavía invocan ~/.openclaw/bin/ensure-whatsapp.sh; elimine esas entradas obsoletas con crontab -e porque cron puede carecer del entorno de bus de usuario de systemd y hacer que ese script antiguo informe incorrectamente el estado de la puerta de enlace.

Si es necesario, vuelva a vincular con channels login.

El inicio de sesión con QR agota el tiempo de espera detrás de un proxy

Síntoma: openclaw channels login --channel whatsapp falla antes de mostrar un código QR utilizable con status=408 Request Time-out o una desconexión del socket TLS.

El inicio de sesión de WhatsApp Web utiliza el entorno de proxy estándar del host de la puerta de enlace (HTTPS_PROXY, HTTP_PROXY, variantes en minúsculas y NO_PROXY). Verifique que el proceso de la puerta de enlace herede el entorno de proxy y que NO_PROXY no coincida con mmg.whatsapp.net.

No hay ningún escucha activo al enviar

Los envíos salientes fallan rápidamente cuando no existe ningún escucha activo de puerta de enlace para la cuenta de destino.

Asegúrese de que la puerta de enlace se esté ejecutando y de que la cuenta esté vinculada.

La respuesta aparece en la transcripción pero no en WhatsApp

Las filas de la transcripción registran lo que generó el agente. La entrega en WhatsApp se verifica por separado: OpenClaw solo trata una respuesta automática como enviada después de que Baileys devuelve un ID de mensaje saliente para al menos un envío de texto o medio visible.

Las reacciones de reconocimiento son recibos previos independientes a la respuesta. Una reacción exitosa no prueba que la respuesta de texto o medio posterior haya sido aceptada por WhatsApp.

Verifique los registros de la puerta de enlace para auto-reply delivery failed o auto-reply was not accepted by WhatsApp provider.

Mensajes de grupo ignorados inesperadamente

Comprueba en este orden:

• groupPolicy
• groupAllowFrom / allowFrom
• entradas de la lista de permitidos de groups
• filtrado de menciones (requireMention + patrones de mención)
• claves duplicadas en openclaw.json (JSON5): las entradas posteriores sobrescriben a las anteriores, así que mantén un solo groupPolicy por ámbito

Si channels.whatsapp.groups está presente, WhatsApp aún puede observar mensajes de otros grupos, pero OpenClaw los descarta antes del enrutamiento de sesión. Añade el JID del grupo a channels.whatsapp.groups o añade groups["*"] para admitir todos los grupos mientras se mantiene la autorización del remitente bajo groupPolicy y groupAllowFrom.

Advertencia del tiempo de ejecución de Bun

El tiempo de ejecución de la puerta de enlace de WhatsApp debe usar Node. Bun está marcado como incompatible para la operación estable de la puerta de enlace de WhatsApp/Telegram.

Prompts del sistema

WhatsApp admite prompts del sistema estilo Telegram para grupos y chats directos a través de los mapas groups y direct.

Jerarquía de resolución para mensajes de grupo:

Primero se determina el mapa groups efectivo: si la cuenta define su propio groups, reemplaza completamente el mapa raíz groups (sin fusión profunda). La búsqueda del prompt se ejecuta entonces en el mapa único resultante:

1. Prompt del sistema específico del grupo (groups["<groupId>"].systemPrompt): se usa cuando la entrada específica del grupo existe en el mapa y su clave systemPrompt está definida. Si systemPrompt es una cadena vacía (""), se suprime el comodín y no se aplica ningún prompt del sistema.
2. Prompt del sistema con comodín de grupo (groups["*"].systemPrompt): se usa cuando la entrada específica del grupo está totalmente ausente del mapa, o cuando existe pero no define ninguna clave systemPrompt.

Jerarquía de resolución para mensajes directos:

Primero se determina el mapa direct efectivo: si la cuenta define su propio direct, reemplaza completamente el mapa raíz direct (sin fusión profunda). La búsqueda del prompt se ejecuta entonces en el mapa único resultante:

1. Prompt del sistema específico de directo (direct["<peerId>"].systemPrompt): se utiliza cuando la entrada del par específico existe en el mapa y su clave systemPrompt está definida. Si systemPrompt es una cadena vacía (""), se suprime el comodín y no se aplica ningún prompt del sistema.
2. Prompt del sistema comodín de directo (direct["*"].systemPrompt): se utiliza cuando la entrada del par específico está ausente totalmente del mapa, o cuando existe pero no define ninguna clave systemPrompt.

Note

dms sigue siendo el depósito de anulación del historial por MD ligero (`dms.

.historyLimit). Las anulaciones de prompts residen en direct`.

Diferencia con el comportamiento multicuenta de Telegram: En Telegram, el groups raíz se suprime intencionalmente para todas las cuentas en una configuración multicuenta, incluso para las cuentas que no definen su propio groups, para evitar que un bot reciba mensajes de grupos a los que no pertenece. WhatsApp no aplica esta protección: el groups raíz y el direct raíz siempre se heredan en las cuentas que no definen una anulación a nivel de cuenta, independientemente de cuántas cuentas estén configuradas. En una configuración multicuenta de WhatsApp, si desea prompts de grupo o directo por cuenta, defina el mapa completo en cada cuenta explícitamente en lugar de confiar en los valores predeterminados de nivel raíz.

Comportamiento importante:

• channels.whatsapp.groups es tanto un mapa de configuración por grupo como la lista de permitidos de grupos a nivel de chat. En el ámbito raíz o de cuenta, groups["*"] significa “se admiten todos los grupos” para ese ámbito.
• Solo añada un grupo comodín systemPrompt cuando ya quiera que ese ámbito admita todos los grupos. Si todavía solo quiere que un conjunto fijo de ID de grupos sean elegibles, no use groups["*"] para el valor predeterminado del prompt. En su lugar, repita el prompt en cada entrada de grupo permitida explícitamente.
• La admisión en grupos y la autorización de remitentes son verificaciones separadas. groups["*"] amplía el conjunto de grupos que pueden alcanzar el manejo de grupos, pero por sí solo no autoriza a todos los remitentes en esos grupos. El acceso del remitente aún se controla por separado mediante channels.whatsapp.groupPolicy y channels.whatsapp.groupAllowFrom.
• channels.whatsapp.direct no tiene el mismo efecto secundario para los MD. direct["*"] solo proporciona una configuración de chat directo predeterminada después de que un MD ya haya sido admitido por dmPolicy más allowFrom o las reglas del almacén de emparejamiento.

Ejemplo:

{
  channels: {
    whatsapp: {
      groups: {
        // Use only if all groups should be admitted at the root scope.
        // Applies to all accounts that do not define their own groups map.
        "*": { systemPrompt: "Default prompt for all groups." },
      },
      direct: {
        // Applies to all accounts that do not define their own direct map.
        "*": { systemPrompt: "Default prompt for all direct chats." },
      },
      accounts: {
        work: {
          groups: {
            // This account defines its own groups, so root groups are fully
            // replaced. To keep a wildcard, define "*" explicitly here too.
            "[email protected]": {
              requireMention: false,
              systemPrompt: "Focus on project management.",
            },
            // Use only if all groups should be admitted in this account.
            "*": { systemPrompt: "Default prompt for work groups." },
          },
          direct: {
            // This account defines its own direct map, so root direct entries are
            // fully replaced. To keep a wildcard, define "*" explicitly here too.
            "+15551234567": { systemPrompt: "Prompt for a specific work direct chat." },
            "*": { systemPrompt: "Default prompt for work direct chats." },
          },
        },
      },
    },
  },
}

Punteros de referencia de configuración

Referencia principal:

• Referencia de configuración - WhatsApp

Campos de WhatsApp de alta señal:

• acceso: dmPolicy, allowFrom, groupPolicy, groupAllowFrom, groups
• entrega: textChunkLimit, chunkMode, mediaMaxMb, sendReadReceipts, ackReaction, reactionLevel
• multicuenta: accounts.<id>.enabled, accounts.<id>.authDir, anulaciones a nivel de cuenta
• operaciones: configWrites, debounceMs, web.enabled, web.heartbeatSeconds, web.reconnect.*, web.whatsapp.*
• comportamiento de sesión: session.dmScope, historyLimit, dmHistoryLimit, dms.<id>.historyLimit
• prompts: groups.<id>.systemPrompt, groups["*"].systemPrompt, direct.<id>.systemPrompt, direct["*"].systemPrompt

Relacionado

• Emparejamiento
• Grupos
• Seguridad
• Enrutamiento de canales
• Enrutamiento multiagente
• Solución de problemas