How to Create Interactive Messages

Akece allows you to send interactive messages through the website chat widget — such as option lists, forms, image cards, and recommended articles. These messages can be created using the New Message API.

These formats help improve customer engagement, streamline data collection, and offer more dynamic support experiences.

Payload Examples

Below are examples of payloads you can use to send different types of interactive messages via the API.

1. Option List

Allows the customer to select one of the available options.

{
  "content": "Please choose one of the options below",
  "content_type": "input_select",
  "content_attributes": {
    "items": [
      { "title": "Option 1", "value": "option_1" },
      { "title": "Option 2", "value": "option_2" }
    ]
  },
  "private": false
}

2. Form

Collect custom information like email, free text, selection fields, and more.

{
  "content": "form",
  "content_type": "form",
  "content_attributes": {
    "items": [
      {
        "name": "email",
        "placeholder": "Enter your email",
        "type": "email",
        "label": "Email",
        "default": "[email protected]"
      },
      {
        "name": "message",
        "placeholder": "Write your message",
        "type": "text_area",
        "label": "Message",
        "default": ""
      },
      {
        "name": "name",
        "placeholder": "Enter your name",
        "type": "text",
        "label": "Name",
        "default": ""
      },
      {
        "name": "product",
        "label": "Product of interest",
        "type": "select",
        "options": [
          { "label": "🌯 Burrito", "value": "burrito" },
          { "label": "🍝 Pasta", "value": "pasta" }
        ]
      }
    ]
  },
  "private": false
}

3. Cards

Displays an image with a title, description, and action buttons.

{
  "content": "card message",
  "content_type": "cards",
  "content_attributes": {
    "items": [
      {
        "media_url": "https://image-link.jpg",
        "title": "Nike Sneakers 2.0",
        "description": "Perfect for running and comfort.",
        "actions": [
          {
            "type": "link",
            "text": "View more",
            "uri": "https://www.example.com"
          },
          {
            "type": "postback",
            "text": "Add to cart",
            "payload": "ITEM_SELECTED"
          }
        ]
      }
    ]
  },
  "private": false
}

4. Recommended Articles

Displays a list of knowledge base articles with titles, descriptions, and links.

{
  "content": "articles",
  "content_type": "article",
  "content_attributes": {
    "items": [
      {
        "title": "API Integration Guide",
        "description": "Learn how to get started with our API.",
        "link": "https://www.example.com/api-guide"
      },
      {
        "title": "Technical Documentation",
        "description": "Read our development and integration guidelines.",
        "link": "https://www.example.com/docs"
      }
    ]
  },
  "private": false
}

If you need help creating interactive messages in your account, reach out to us:
📩 [email protected] | 📱 @akece.ai