Send media carousel with buttons

This endpoint allows sending a carousel with images and interactive buttons. It works the same way as the /send/menu endpoint with type: carousel, but using a different payload format.

Common Fields

This endpoint supports all common optional fields documented in the “Send Message” tag, including: delay, readchat, readmessages, replyid, mentions, forward, track_source, track_id, placeholders, and sending to groups.

Payload Structure

{
  "number": "5511999999999",
  "text": "Main text",
  "carousel": [
    {
      "text": "Card text",
      "image": "Image URL",
      "buttons": [
        {
          "id": "reply1",
          "text": "Button text",
          "type": "REPLY"
        }
      ]
    }
  ],
  "delay": 1000,
  "readchat": true
}

Button Types

• REPLY: Quick reply button

  • When clicked, sends the id value as a response to the chat
  • The id will be the text sent as a reply

• URL: Button with link

  • When clicked, opens the specified URL
  • The id must contain the full URL (e.g., https://example.com)

• COPY: Button to copy text

  • When clicked, copies the text to the clipboard
  • The id will be the text to be copied

• CALL: Button to make a call

  • When clicked, starts a phone call
  • The id must contain the phone number

Button Example

{
  "buttons": [
    {
      "id": "Yes, I want to buy!",
      "text": "Confirm Purchase",
      "type": "REPLY"
    },
    {
      "id": "[https://example.com/product](https://example.com/product)",
      "text": "View Product",
      "type": "URL"
    },
    {
      "id": "COUPON20",
      "text": "Copy Coupon",
      "type": "COPY"
    },
    {
      "id": "5511999999999",
      "text": "Speak to Seller",
      "type": "CALL"
    }
  ]
}

Complete Carousel Example

{
  "number": "5511999999999",
  "text": "Our Featured Products",
  "carousel": [
    {
      "text": "Smartphone XYZ\nThe most advanced smartphone in the line",
      "image": "[https://example.com/product1.jpg](https://example.com/product1.jpg)",
      "buttons": [
        {
          "id": "YES_BUY_XYZ",
          "text": "Buy Now",
          "type": "REPLY"
        },
        {
          "id": "[https://example.com/xyz](https://example.com/xyz)",
          "text": "View Details",
          "type": "URL"
        }
      ]
    },
    {
      "text": "Discount Coupon\nGet 20% OFF on any product",
      "image": "[https://example.com/coupon.jpg](https://example.com/coupon.jpg)",
      "buttons": [
        {
          "id": "DISCOUNT20",
          "text": "Copy Coupon",
          "type": "COPY"
        },
        {
          "id": "5511999999999",
          "text": "Speak to Seller",
          "type": "CALL"
        }
      ]
    }
  ],
  "delay": 0,
  "readchat": true
}