Skip to content

Coerce and normalize button specs for Whapi interactive messages

Source: R/utils.R
whapi_coerce_buttons_base.Rd

Internal helper that converts a data.frame/tibble or list of button definitions into a normalized list-of-lists, applying a few rules:

  • Accepts aliases label / name and maps them to title;

  • Requires a non-empty title;

  • Auto-generates id when missing using slugification plus uniqueness enforcement (e.g., "Buy Now" -> "buy_now", duplicates become "buy_now_2", "buy_now_3", ...).

This is useful before building payloads for Whapi interactive endpoints (e.g., buttons, mixed actions, etc.).

Usage

whapi_coerce_buttons_base(buttons, verbose = TRUE)

Arguments

buttons

A data.frame/tibble with columns per button (e.g. title, id, etc.) or a list of named lists. Can be NULL (returns empty list).

verbose

Logical (default TRUE). If TRUE, prints progress messages via cli (how many buttons, how many ids auto-generated, etc.).

Value

A list of named lists (one per button), each guaranteed to have at least title (non-empty). If a button had no id, a slugified, unique id is created.

See also

whapi_slugify(), whapi_make_unique()

Examples

# From tibble (title only -> ids auto-generated)
# tibble::tribble(~title, "Buy Now", "Buy Now", "Learn More") |>
#   whapi_coerce_buttons_base()

# From list (mix with/without id)
# whapi_coerce_buttons_base(list(
#   list(title = "Website", url = "https://example.com"),
#   list(title = "Website")  # will get an auto id too
# ))