Green API icon

Green API

Send WhatsApp messages via Green API

Actions29

Message → Send Interactive Buttons (Beta)

AI-generated

Overview

This node operation sends a WhatsApp message with interactive buttons using the Green API. It allows users to create messages that include up to three interactive buttons of different types (copy, call, or URL). This is useful for engaging recipients with actionable buttons directly in the message, such as copying text, initiating a call, or opening a link.

Use Case Examples

  1. Send a promotional message with buttons to copy a discount code, call customer support, or visit a website.
  2. Send a message with buttons for quick actions like copying a reference number or opening a URL for more information.

Properties

Name Meaning
Chat ID The identifier of the chat where the message will be sent. For private chats, use the format phone@c.us; for group chats, use chatId@g.us.
Quoted Message ID Optional ID of a message to quote in the reply.
Header Optional title or header text for the interactive message.
Body The main text content of the message. Supports emoji symbols.
Footer Optional footer text for the message.
Buttons A collection of up to three interactive buttons included in the message. Each button has a type (copy, call, or URL), a unique identifier, display text, and additional fields depending on the button type (copyCode for copy, phoneNumber for call, url for URL).
Override Credentials Optional override for the instance ID and API token credentials for this specific operation.

Output

JSON

  • chatId - The chat ID where the interactive button message was sent.
  • body - The main text content of the sent message.
  • header - The header text of the sent message, if provided.
  • footer - The footer text of the sent message, if provided.
  • buttons - Array of button objects sent with the message, each containing type, buttonId, buttonText, and type-specific fields like copyCode, phoneNumber, or url.
  • messageId - The unique identifier of the sent message returned by the API.
  • status - The status of the message sending operation as returned by the API.

Dependencies

  • Green API service
  • API credentials: instance ID and API token

Troubleshooting

  • Ensure that the chat ID is correctly formatted for private or group chats.
  • Verify that each button has the required fields based on its type (copyCode for copy, phoneNumber for call, url for URL). Missing required fields will cause errors.
  • Check that the API credentials (instance ID and API token) are valid and have not expired.
  • If the API request fails, review the error message for details and verify the data sent matches the expected format.
  • The maximum number of buttons allowed is three; exceeding this limit will cause an error.

Discussion