Skip to main content
Interactive endpoints build WhatsApp native-flow or template-style messages. Some of them are license-limited in the code through the scan limit check.
WhatsApp interactive message support can vary by account type, recipient app version, region, and WhatsApp changes. Test every payload with your own device before exposing it to customers.

​
Endpoint map

EndpointPurpose
POST /send/buttonsSend text with one or more quick reply or CTA buttons.
POST /send/mediabuttonSend buttons with image, video, or document header media.
POST /send/templateSend a template-style button message.
POST /send/listSend a list message with sections and rows.
POST /send/locationbuttonSend a native request-location button.
POST /send/pixbuttonSend a PIX payment button payload.
POST /send/reviewpaySend review-and-pay style payment payload.
POST /send/carouselSend a carousel with text cards and buttons.
POST /send/carouselmediaSend a carousel where cards include media.

​
Button types

Carousel handlers support button types like:
TypeBehavior
urlOpens a URL.
webviewOpens a URL with webview interaction flags.
replySends a quick reply payload.
copyCopies a code value.
callStarts a phone call CTA.
{
  "phone": "15551234567",
  "message": "Choose a product",
  "carousel": [
    {
      "text": "Starter plan",
      "buttons": [
        {
          "id": "starter",
          "label": "Select",
          "type": "reply"
        },
        {
          "label": "Open",
          "url": "https://example.com/starter",
          "type": "url"
        }
      ]
    }
  ]
}
/send/carouselmedia supports media per card: 
{
  "phone": "15551234567",
  "message": "Catalog",
  "carousel": [
    {
      "text": "Product",
      "media_url": "https://example.com/product.jpg",
      "media_type": "image",
      "caption": "Product photo",
      "buttons": [
        {
          "id": "buy-1",
          "label": "Buy",
          "type": "reply"
        }
      ]
    }
  ]
}
media_type must be one of image, video, audio, or document, but the card header currently builds image, video, or document media.

​
PIX and review pay

PIX and review-and-pay endpoints live in pix.go. Use them for Brazil payment-style WhatsApp messages. Keep the payload values consistent with your payment provider and validate amounts server-side before calling WaGo.