> ## Documentation Index
> Fetch the complete documentation index at: https://chatbotx.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Poll Manager

> Create and manage interactive timed voting polls with multi-channel share links, automated post-vote flows, and real-time demographic analytics.

**Poll Manager** enables you to create interactive voting campaigns directly within chat conversations. You can collect customer preferences, conduct team votes, run community contests, and gather product feedback across multiple messaging channels.

> [card] Time-Bound Campaigns
>
> Set precise start and end dates. The system automatically manages active, upcoming, and expired poll states.

> [card] Omnichannel Sharing
>
> Generate channel-specific deep links with automated payload parameters for Messenger, WhatsApp, Instagram, Telegram, and Webchat.

> [card] Post-Vote Automation
>
> Trigger automated follow-up flows immediately when a contact votes to deliver rewards, thank-you messages, or apply tags.

> [card] Demographic Analytics
>
> Track total votes, candidate shares, and demographic breakdowns by gender in real-time with visual distribution charts.

## Access Poll Manager

To access the Poll Manager dashboard:

**1. Open Tools**

Click **Tools** in the left navigation sidebar.

**2. Select Poll Manager**

Click the **Poll Manager** card to open the dashboard.

![Tools Poll Manager Navigation](https://mintcdn.com/chatbotx/GzuAgGIK3pIf0DeS/images/tools_poll_manager_navigation.png?fit=max\&auto=format\&n=GzuAgGIK3pIf0DeS\&q=85\&s=b762e55a4cf02f86ed5cfabb8846181b)

## Manage polls

The Poll Manager dashboard lists all created polls with their key metrics:

![Poll Manager Dashboard List](https://mintcdn.com/chatbotx/GzuAgGIK3pIf0DeS/images/poll_manager_dashboard_list.png?fit=max\&auto=format\&n=GzuAgGIK3pIf0DeS\&q=85\&s=438f39bdb70c09b0de193056a10368f0)

The list displays the following information for each poll:

* **Name**: The display title of the poll.
* **Start Date**: The start date and time when voting opens.
* **End Date**: The end date and time when voting closes.
* **Votes**: The total number of registered votes submitted so far.

Use the search bar at the top to filter polls by name. To perform actions on an existing poll, click the three-dots (**...**) menu on the right:

* **Edit**: Modify the poll name, voting period, cover image, candidate list, or post-vote flow.
* **Get Link**: Open the sharing dialog to copy deep links for connected channels.
* **View Analytics**: Open the real-time reporting dashboard to analyze voting results and voter demographics.
* **Delete**: Permanently remove the poll.

You can also select multiple polls using the checkboxes on the left and delete them in bulk.

## Create a new poll

Click the **+ Add** button at the top right of the dashboard to create a new poll.

**1. Configure general information and voting period**

Fill in the core poll details in the top card:

![Poll Manager Create Form Details](https://mintcdn.com/chatbotx/GzuAgGIK3pIf0DeS/images/poll_manager_create_form_details.png?fit=max\&auto=format\&n=GzuAgGIK3pIf0DeS\&q=85\&s=5e8cb3c8d3134222dc0eb3c90596498a)

* **Name**: Enter a clear, descriptive title for the poll. This appears as the main heading in chat cards.
* **Voting period**: Specify the **Start date** and **End date** with times. Contacts can only vote during this window.
  * *Before start date*: The chat card displays a **Not started** status.
  * *Active window*: The chat card displays a **Voting started** status with an active **Vote** button.
  * *After end date*: The chat card displays a **Voting ended** status and closes voting.
* **Image**: Upload an optional cover image (JPG, PNG) to illustrate the poll topic in chat cards.

**2. Add candidates or options**

Scroll to the **Candidates or Options** section to define the voting choices:

![Poll Manager Candidates And After Vote Flow](https://mintcdn.com/chatbotx/GzuAgGIK3pIf0DeS/images/poll_manager_candidates_and_after_vote_flow.png?fit=max\&auto=format\&n=GzuAgGIK3pIf0DeS\&q=85\&s=13e9a3853beb7696ad95c79c7835805a)

Each poll requires a minimum of **2** and supports up to **10** options:

* **Candidate name**: Enter the name of the choice or candidate.
* **Description**: Add brief supporting details, descriptions, or itineraries.
* **Image**: Upload a representative photo or banner for the option.
* Click **+ Add More** to add additional candidates.
* Click the trash icon to remove an option (available when more than 2 options exist).

**3. Set post-vote automation (optional)**

Click **More Options** at the bottom of the form to configure automated actions:

* **Flow to be sent after the user votes**: Select a Flow that executes immediately after a contact casts a vote. Use this flow to:
  * Send a personalized thank-you message confirming their selection.
  * Deliver a discount code, coupon, or digital reward.
  * Add a Contact Tag or update a Contact Custom Field for future audience segmentation.

**4. Save the poll**

Click **Save** to publish the poll. It will immediately appear in your Poll Manager list.

## Share poll links across channels

To distribute your poll to contacts and social audiences:

1. In the Poll Manager dashboard, click the three-dots (**...**) menu next to the poll and select **Get Link**.

![Poll Manager Get Link Modal](https://mintcdn.com/chatbotx/GzuAgGIK3pIf0DeS/images/poll_manager_get_link_modal.png?fit=max\&auto=format\&n=GzuAgGIK3pIf0DeS\&q=85\&s=40ce498a90e23d6f45a82f3f4b39f810)

2. The dialog provides ready-to-use deep links:
   * **Omnichannel**: A universal link that routes contacts based on their device and channel preference.
   * **Connected Channels**: Direct deep links configured with the `pl_<pollId>` parameter for **Facebook Messenger**, **Instagram**, **WhatsApp**, **Telegram**, and **Webchat**.

Click **Copy** next to any channel to paste the link into ad campaigns, social media posts, broadcast messages, or website buttons.

> [!NOTE]
>
> Channels that do not support automated deep link referral parameters, such as TikTok or Google App, are labeled accordingly in the dialog.

## In-chat voting experience

When contacts access the poll link via any supported messaging channel, ChatbotX handles the entire voting flow interactively:

![Poll Manager Chat Voting Carousel](https://mintcdn.com/chatbotx/GzuAgGIK3pIf0DeS/images/poll_manager_chat_voting_carousel.png?fit=max\&auto=format\&n=GzuAgGIK3pIf0DeS\&q=85\&s=4a417b2ccb8eb1f3ece5b5a5d690798a)

1. **Poll introduction card**: The contact receives a greeting card displaying the cover image, poll title, voting window, and a **Vote** button.
2. **Interactive candidate carousel**: Tapping **Vote** displays a carousel of candidate cards. Each card displays the candidate's image, title, description, and an individual **Vote** button.
3. **Instant confirmation**: Tapping the button under a candidate registers the vote immediately. The bot responds with confirmation message: *"Your vote was successfully registered."* alongside a **Polls** button.
4. **Changing votes**: If a contact changes their mind while the poll is active, they can tap **Vote** on another candidate. The system automatically updates their record and decrements their previous choice.
5. **Automated follow-up**: If a post-vote Flow was configured, it triggers right after the confirmation message.

## View analytics and reporting

Click **... > View Analytics** next to any poll to review detailed results and voter demographics:

![Poll Manager Analytics Dashboard](https://mintcdn.com/chatbotx/GzuAgGIK3pIf0DeS/images/poll_manager_analytics_dashboard.png?fit=max\&auto=format\&n=GzuAgGIK3pIf0DeS\&q=85\&s=913e7bcd3547996ef76418b52d2f1ba7)

The analytics dashboard provides comprehensive insights:

### Overview metrics and table

* **Total votes**: The aggregate number of validated votes cast across all channels.
* **Detailed candidate table**:
  * **Name**: The candidate or option title.
  * **Total votes**: Absolute vote count received.
  * **T%**: Percentage share of total votes.
  * **Male votes**: Total votes cast by male contacts.
  * **M%**: Proportion of votes from male contacts.
  * **Female votes**: Total votes cast by female contacts.
  * **F%**: Proportion of votes from female contacts.

### Visual charts

* **Results chart**: A visual breakdown showing the distribution of votes across all candidates.
* **Votes per gender chart**: A demographic donut chart illustrating voter participation across identified gender segments (Male, Female, Unknown).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.