# Engagement Tools

These two shortcodes, `[post_box]` and `[live_feed]`, allow you to gather user input, display live feedback, or even embed polls within articles or across different sections of your website.

By using these shortcodes, you can:

* **Personalize the User Experience**: Place input boxes and live feeds in strategic locations to create a tailored, interactive journey for your users.
* **Foster Engagement**: Encourage user participation by collecting comments, questions, or poll responses directly on relevant pages or articles.
* **Enable Dynamic Interactions**: Use live feeds to showcase real-time updates, making it easy for users to see new comments, feedback, or event discussions as they happen.

These shortcodes are ideal for embedding live Q\&A sections, enabling community discussions, or placing polls in articles to keep users engaged without redirecting them to another page.

Whether you're running a live event, creating an interactive blog, or fostering community engagement, `[post_box]` and `[live_feed]` give you the flexibility to seamlessly integrate these features into your content.

***

### **\[post\_box]**

The `[post_box]` shortcode allows users to post comments, questions, or other input into a feed. It includes a customizable placeholder for the input field.

* **Parameters**:
  * **content\_feed** *(required)*: The target event where user input will be posted.
  * **placeholder** *(optional)*: Text displayed in the input field before the user types anything.
    * **Default**: *Post a comment or question.*
* **Usage Examples**:

| **Example**                                         | **Description**                                     |
| --------------------------------------------------- | --------------------------------------------------- |
| `[post_box content_feed="1234"]`                    | Displays a post box with the default placeholder.   |
| `[post_box placeholder="Share your thoughts here"]` | Displays a post box with a custom placeholder text. |

***

### **\[live\_feed]**

The `[live_feed]` shortcode displays a live feed of user-generated content or updates from a specific content feed.

* **Parameters**:
  * **content\_feed** *(required)*: Specifies the event feed to display.
* **Usage Examples**:

| **Example**                       | **Description**                         |
| --------------------------------- | --------------------------------------- |
| `[live_feed content_feed="1234"]` | Displays the default live content feed. |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wavecast.io/publishing/shortcodes/engagement-tools.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.