evolution (version 0.1.0)

send_list: Send a list message

Description

Sends an interactive list message via Evolution API v2. List messages display a menu of selectable options organised into sections.

Usage

send_list(
  client,
  number,
  title,
  description,
  button_text,
  sections,
  footer = "",
  delay = NULL,
  verbose = FALSE
)

Value

A named list with the API response. The HTTP status code is stored in attr(result, "http_status").

Arguments

client

An evo_client() object.

number

Character. Recipient number with country code (e.g., "5581999990000" or "[phone]").

title

Character. List message title.

description

Character. List message body text.

button_text

Character. Text displayed on the list button (e.g., "View options").

sections

A list of section objects. Each section is a named list with title and rows, where rows is a list of named lists each containing title, optional description, and optional rowId.

footer

Character. Footer text (required by the API, defaults to "").

delay

Integer (ms). Optional presence delay before sending. Simulates typing before the message is sent.

verbose

Logical. If TRUE, logs request/response details with cli.

See Also

send_poll()

Examples

if (FALSE) {
send_list(client, "5581999990000",
  title = "Our Menu",
  description = "Select from the options below:",
  button_text = "View options",
  footer = "Powered by R",
  sections = list(
    list(title = "Drinks", rows = list(
      list(title = "Coffee", description = "Hot coffee", rowId = "1"),
      list(title = "Tea",    description = "Green tea",  rowId = "2")
    )),
    list(title = "Food", rows = list(
      list(title = "Cake", description = "Chocolate cake", rowId = "3")
    ))
  ))
}