WhatsApp

Referencia de configuración

Ajustes de WhatsApp CLI: valores predeterminados, ámbitos y variables de entorno.

Usa esta página cuando necesite el nombre exacto, el valor predeterminado o el alcance de una configuración, o el nombre de una variable de entorno. Enumera todas las configuraciones que lee wa y qué valor gana.

Ninguna configuración puede contener un secreto: el archivo no tiene campos para las claves del dispositivo, un número de teléfono o una identificación de chat.

¿Qué valor gana?

Para cada configuración, la primera de estas que se establece:

  1. una opción en la línea de comando (--limit 50, --record, --timeout 30s)
  2. una variable de entorno (WA_PROFILE, WA_TIMEOUT)
  3. la propia entrada del perfil en el archivo de configuración
  4. defaults en el archivo de configuración, compartido por cada perfil. Cinco, el valor predeterminado incorporado

wa <profile> config show imprime cada configuración vigente y de dónde proviene.

El archivo

~/.config/whatsapp-cli/config.json. Ninguna configuración elige un perfil: la primera palabra (wa work …) o WA_PROFILE lo nombra. Sin ninguno de los dos, un comando que usa una cuenta se detiene con el código de salida 2 y enumera los perfiles en esta computadora. Un archivo que todavía tiene default_profile de un wa anterior también detiene ese comando; wa config unset default_profile lo elimina.

ConfiguraciónPredeterminadoQué haceAnulado por uno ejecutado por
limit20filas por página de una lista--limit
timeout_msningunocuánto tiempo puede esperar una solicitud, en milisegundos; para todo el comando utilice --timeoutninguno
colordesde la terminalcolor en la vista de tablaninguno; sin configuración, NO_COLOR lo apaga
sender_colorsfalseun color por remitente en la vista de tabla de mensajesninguno
search_catch_upfalsepreparar chats recién almacenados para búsqueda local: su gráfico y, cuando estén instalados, sus vectores--catch-up, --no-catch-up
picture_searchfalsebuscar imágenes almacenadas por lo que muestran, una vez descargado el modeloninguno
recordfalsemantener cada carrera--record, --no-record
keep_runs_for_days30las ejecuciones registradas anteriores a esta se eliminan cuando se conserva la siguienteninguno
permissionstodo permitido, excepto eliminar y algunos otros cambios preguntarqué puede hacer el perfil, por comandoninguno; --yes solo responde ask, nunca levanta deny
sends_per_hour30la mayor cantidad de envíos en cualquier horaninguno
requests_per_minuteel ritmo del CLIsolicita un minuto, compartido por cada proceso del perfil; 0 lo apagaWA_REQUESTS_PER_MINUTE
transcribe_withautoquién convierte la voz en texto: auto, messenger o local--local o --model
speech_modelningunoque utiliza el modelo de voz descargado --local--model
read_other_botsfalseaceptar mensajes identificados como provenientes de otros bots; Sólo perfiles de botsninguno
update_checktruela línea diaria "existe una versión más nueva"; sólo bajo defaultsninguno; WA_NO_UPDATE_CHECK, NO_UPDATE_NOTIFIER o CI apágalo
skill_hinttrueuna línea, como máximo una vez al día, para un agente cuya copia de el skill falta o es anterior; sólo bajo defaultsninguno
embedding_providerlocalmodelo local o openai--embedding-provider
embedding_modelpredeterminado del proveedormodelo de incrustación--model
embedding_base_urlpredeterminado del proveedorincorporación de punto final API--base-url
embedding_dimsmodelo predeterminadoentero 1–65,536--dims
analysis_provideragentagent, openai o anthropicbuild --analysis-provider
analysis_modelningunomodelo de análisisbuild --model
analysis_base_urlpredeterminado del proveedorpunto final API de análisisbuild --base-url
modelsningunomodelos externos por finalidadVariables WA_MODELS_*

Las configuraciones para la raíz de búsqueda, los países telefónicos, las tareas y los grupos de cuentas (search_stemmers.*, phone_countries, task_*, account_groups.*) se enumeran en wa config set.

El archivo se escribe 0600 cuando se creó por primera vez. No guarda ningún secreto.

Un perfil de bot

Un número de WhatsApp Business en la Cloud API de Meta (wa <profile> bot …) mantiene tu configuración en bot en el archivo: wa <profile> config set --bot <setting> <value>. Son identificadores de la página de configuración de API del Panel de aplicaciones, no secretos; el token de acceso se encuentra en el llavero del sistema (un número de WhatsApp Business como bot).

ConfiguraciónPredeterminadoQué haceAnulado por uno ejecutado por
phone_number_idningunoel número de empresa del que habla cada comando botComandos --phone-number-id en bot api
waba_idningunola cuenta de WhatsApp Business que contiene las plantillas del número--waba-id en comandos bot api
graph_versionv23.0la versión Graph API en cada solicitudninguno

Variables de entorno

VariablesQué hace
WA_PROFILEel perfil, cuando la primera palabra no nombra a nadie
WA_PROFILE_LOCKfija el proceso a un perfil; cualquier otro se rechaza
WA_TIMEOUTlo mismo que --timeout: 500ms, 30s o 2m para todo el comando
WA_REQUESTS_PER_MINUTEigual que requests_per_minute, y lo supera
WA_CONFIG_DIR, WA_STATE_DIR, WA_CACHE_DIRmover los tres directorios
MESSAGING_STOREla ruta del archivo de almacén local
WIRECAT_STATE_DIRla carpeta WireCat que comparte cada CLI: el almacén local y los modelos de voz
WA_READ_ONLY1 hace que este proceso sea de solo lectura: todo cambio, vinculación y desvinculación del dispositivo incluido, se rechaza
WA_ENGINEla ruta de un programa de motor a ejecutar en lugar del instalado
WA_ENGINE_LOGun archivo al que el motor añade sus advertencias, números de teléfono enmascarados; desarmado, no registra nada
WA_NO_UPDATE_CHECK1 desactiva la línea diaria "Existe una versión más nueva"
NO_COLORsin color en la vista de tabla
WA_EMBEDDING_*, WA_ANALYSIS_*, WA_MODELS_*configuración del modelo