Skip to content

Changelog

Source: NEWS.md

evolution (development version)

evolution 0.1.0

Breaking changes

  • The global timeout option was renamed from evoapi.timeout to evolution.timeout to match the package name. The previous option name was silently ignored due to a mismatch between zzz.R and the internal request function (#1).

New features

  • send_list(): sends interactive list messages with sections and selectable rows, mapping to the Evolution API v2 sendList endpoint.

  • check_is_whatsapp(): verifies whether phone numbers are registered on WhatsApp via the chat/whatsappNumbers endpoint.

  • print.evo_client(): new S3 print method that displays instance name and base URL when inspecting a client object.

Improved error handling

  • .evo_post() now extracts and surfaces the actual API error message from the JSON response body (fields response$message or message), instead of showing a generic “Evolution API error (status)” string.

  • Non-JSON error responses (e.g., HTML from a 502/503 gateway error) are now handled gracefully instead of crashing with a parse error.

  • All send_*() functions now validate required arguments up front with clear cli error messages (e.g., "'number' must be a single non-empty character string").

  • evo_client() uses descriptive cli::cli_abort() messages instead of stopifnot(), with hints like "Use Sys.getenv(\"EVO_APIKEY\")" for the API key argument.

Improved logging (verbose mode)

  • Verbose output now includes response timing (e.g., ✔ HTTP 201 (0.34s)).

  • Verbose output now shows a preview of the response body (first 500 characters) to help with debugging.

  • Large base64 media fields are truncated in verbose logs to keep output readable.

Bug fixes

  • jid() now strips all non-digit characters (including +) before appending @s.whatsapp.net. Previously, jid("+5581...") produced an invalid JID with the + preserved.

  • send_list(): footer parameter now defaults to "" instead of NULL, because the Evolution API requires footerText to be present in the request body (HTTP 400 otherwise).

  • send_sticker() and send_whatsapp_audio() now pass media through .normalize_media(), enabling local file paths (e.g., "~/Downloads/sticker.webp") to be auto-encoded to base64. Previously only send_media() supported this.

  • .normalize_media() now calls path.expand() so that ~ in file paths is correctly resolved to the user’s home directory.

  • send_whatsapp_audio() removed unused parameters (link_preview, mentions_everyone, mentioned) that are not part of the sendWhatsAppAudio API endpoint.

  • send_buttons() now emits a cli::cli_warn() at runtime alerting that interactive buttons are not supported on the Baileys (WhatsApp Web) connector and may be discontinued. The warning suggests send_poll() as an alternative.

  • send_list() now emits a cli::cli_warn() at runtime alerting that interactive list messages are not supported on the Baileys (WhatsApp Web) connector and may be discontinued. The warning suggests send_poll() as an alternative.

Documentation

  • Fixed author name typo in DESCRIPTION: “Vaconcelos” → “Vasconcelos”.

  • README now accurately lists all exported functions including send_list() and check_is_whatsapp().

  • README includes new sections: verbose output example, configuration table, and send_list() / check_is_whatsapp() usage examples.

  • All roxygen documentation improved with @description, @examples, @seealso cross-references, and more specific @return descriptions.

  • Added jsonlite to Imports (used for response preview in verbose mode).

evolution 0.0.1

CRAN release: 2025-11-20