Skip to main content
List messages present a menu with sections and options, perfect for support menus or product selection.

Send a List Message

const message = await zavu.messages.send({
  to: "+14155551234",
  text: "Choose a support topic:",
  channel: "whatsapp",
  messageType: "list",
  content: {
    listButton: "View Options",
    sections: [
      {
        title: "Account",
        rows: [
          { id: "password", title: "Reset Password", description: "Change or reset your password" },
          { id: "billing", title: "Billing Issue", description: "Questions about charges" }
        ]
      },
      {
        title: "Orders",
        rows: [
          { id: "track", title: "Track Order", description: "Check delivery status" },
          { id: "return", title: "Return Item", description: "Start a return request" }
        ]
      }
    ]
  }
});

Specifications

PropertyRequirement
Max sections10
Max rows per section10
Section titleMax 24 chars
Row IDMax 200 chars, unique per message
Row titleMax 24 chars
Row descriptionOptional, max 72 chars
List button (listButton)Required, max 20 chars
Body text (text)Required

Handling List Responses

When a user selects an option, you receive a webhook:
{
  "event": "message.received",
  "data": {
    "from": "+14155551234",
    "type": "list_reply",
    "list": {
      "id": "track",
      "title": "Track Order",
      "description": "Check delivery status"
    }
  }
}

Use Cases

  • Support menus
  • Product categories
  • Service selection
  • FAQ navigation
  • Multi-step workflows