Configuration Reference

Configuration Reference#

Waton low-level connection behavior is driven by DEFAULT_CONNECTION_CONFIG.

Source of truth#

Configuration defaults are defined in:

  • waton/defaults/config.py

The runtime merges defaults with overrides passed to:

  • WAClient(storage, ws_url=None, **config_overrides)

Connection and protocol defaults#

  • ws_url: WhatsApp Web websocket endpoint.

  • origin: default origin string.

  • version: tuple used in client version payload.

  • browser: browser/platform tuple.

  • country_code: locale hint in payload.

Timeouts and intervals#

  • connect_timeout

  • frame_timeout

  • keepalive_interval

  • qr_timeout

Reconnect behavior#

  • auto_restart_on_515

  • max_restart_attempts

Incoming handling/reliability#

  • auto_ack_incoming

  • max_retry_receipts

  • max_recent_sent_messages

  • auto_retry_on_decrypt_fail

  • max_decrypt_retry_requests

  • enable_placeholder_resend

  • placeholder_resend_on_retry

App-state/message-secret cache#

  • max_message_secrets_cache

Incoming node buffering#

  • enable_offline_node_buffer

  • incoming_node_buffer_size

  • incoming_node_yield_every

Call behavior#

  • auto_reject_calls

Minimal override example#

from waton.client.client import WAClient
from waton.infra.storage_sqlite import SQLiteStorage

storage = SQLiteStorage("waton.db")
client = WAClient(
    storage,
    connect_timeout=30.0,
    keepalive_interval=20.0,
    auto_restart_on_515=True,
    max_restart_attempts=2,
)

Recommendations#

  • Keep defaults unless you have specific operational requirements.

  • Tune timeouts gradually and observe reconnect/error behavior.

  • For production, pair config changes with focused tests.

Next steps#

Contents