Send Interactive Messages

Interactive list messages allow you to present users with a list of options to choose from.

Arguments	Explanation
type	The type of the message e.g 'text' | 'interactive' | 'file' | 'video' | 'image'
interactive	The body of the interactive message further documentation can be found here Meta Documentation

Construct a request & the expected response using the specified API endpoint

We partially support interactive messages. These messages will appear in the conversation history as encoded JSON within a text-type message, preserving their original structure and content.

Construct a request

{
    "type": "interactive",
    "interactive": {
        "type": "list",
        "header": {
            "type": "text",
            "text": "Survey"
        },
        "body": {
            "text": "How likely are you to recommend whatsapp to a friend?"
        },
        "footer": {
            "text": "Please make your selection"
        },
        "action": {
            "button": "Answers",
            "sections": [
                {
                    "title": "Your score:",
                    "rows": [
                        {
                            "id": "001",
                            "title": "1"
                        },
                        {
                            "id": "002",
                            "title": "2"
                        }
                    ]
                }
            ]
        }
    }
}

Expected response

{
    "messages": [
        {
            "id": "669ea9e5d366ff7faaed4272",
            "received": "2024-07-22T18:50:13.927Z",
            "author": {
                "avatarUrl": "https://www.gravatar.com/avatar/00000000000000000000000000000000.png?s=200&d=mm",
                "type": "business"
            },
            "content": {
                "type": "text",
                "text": "{\"type\":\"list\",\"header\":{\"type\":\"text\",\"text\":\"CSAT Survey\"},\"body\":{\"text\":\"How likely are you to recommend whatsapp to a friend?\"},\"footer\":{\"text\":\"Please make your selection\"},\"action\":{\"button\":\"Answers\",\"sections\":[{\"title\":\"Your score:\",\"rows\":[{\"id\":\"001\",\"title\":\"1\"},{\"id\":\"002\",\"title\":\"2\"}]}]}}"
            },
            "source": {
                "type": "api:conversations"
            }
        }
    ]
}

The provided YAML configuration below defines an API specification using the OpenAPI (formerly known as Swagger) format.

Reply with Interactive Message

API call to reply (send) an interactive message

POSThttps://virtserver.swaggerhub.com/info513/LK.1/1.0.0/v1.1/org/:{orgId}/whatsapp/appuser/{appUser}/reply/

Path parameters

orgId*string

appUser*string

Body

application/json

typestring

Example: "interactive"

interactiveobject

Response

201

Successfully Replied with Interactive Message.

Body

application/json

messagesarray of object

Request

JavaScriptCurlPython

const response = await fetch('https://virtserver.swaggerhub.com/info513/LK.1/1.0.0/v1.1/org/:{orgId}/whatsapp/appuser/{appUser}/reply/', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

201

{
  "messages": [
    {
      "id": "669ea9e5d366ff7faaed4272",
      "received": "2024-07-22T18:50:13.927Z",
      "author": {
        "avatarUrl": "https://www.gravatar.com/avatar/00000000000000000000000000000000.png?s=200&d=mm",
        "type": "business"
      },
      "content": {
        "type": "text",
        "text": "{\"type\":\"list\",\"header\":{\"type\":\"text\",\"text\":\"CSAT Survey\"},\"body\":{\"text\":\"How likely are you to recommend WhatsApp to a friend?\"},\"footer\":{\"text\":\"Please make your selection\"},\"action\":{\"button\":\"Answers\",\"sections\":[{\"title\":\"Your score:\",\"rows\":[{\"id\":\"001\",\"title\":\"1\"},{\"id\":\"002\",\"title\":\"2\"},{\"id\":\"003\",\"title\":\"3\"},{\"id\":\"004\",\"title\":\"4\"},{\"id\":\"005\",\"title\":\"5\"}]}]}}"
      },
      "source": {
        "type": "api:conversations"
      }
    }
  ]
}