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

# Polling agent

# Polling Agent

The Polling Agent lets you ask your team a question and get a structured summary of responses — all through Slack, without scheduling a meeting or chasing people manually.

***

## How it works

You write a question from the ProMarshal dashboard. The agent sends it to each active team member as a Slack DM and collects their responses. When the response window closes, you receive a summary in Slack showing who responded, what they said, and who did not reply.

***

## Starting a poll

From your project dashboard, go to the **Polling** section and enter:

* **Your question** — free-form text, up to 300 characters
* **Response format** — free text, or multiple choice with optional comments
* **Response window** — minimum 30 minutes, default 90 minutes

ProMarshal rewrites the question for clarity before sending it to your team.

***

## What team members receive

Each member gets a Slack DM with your question. They reply directly in Slack. Responses are collected and attributed by name.

If a member does not respond, ProMarshal sends nudges at **30 minutes** and **60 minutes** after the poll starts. No response after the deadline is recorded as no reply.

***

## Response summary

When the poll closes, you receive a Slack message with:

```
Here is the team response summary.

Question: [your question]

Responded: 4/6
Pending: Alex, Sam

[Grouped responses with member names]
```

The summary includes:

* Total responded vs total invited
* Names of members who did not respond
* All responses grouped by answer (for multiple choice) or listed individually (for free text)

***

## Timing and limits

| Setting                          | Value                                |
| -------------------------------- | ------------------------------------ |
| Default response window          | 90 minutes                           |
| Minimum response window          | 30 minutes                           |
| Nudges sent at                   | 30 min and 60 min after poll starts  |
| Grace period after window closes | 60 minutes (late responses accepted) |
| Poll rate limit                  | 120 polls per minute per workspace   |

***

## Requirements

* Slack connected to the project
* At least one team member with **active** status

Jira is not required for polling.


Built with [Mintlify](https://mintlify.com).