# Snapshot Bot Monitoring

### What is Snapshot Bot Monitoring?

Snapshot Bot Monitoring is used to monitor Snapshot proposals. It can monitor the creation of new proposals as well as changes in the status of existing proposals.

[Learn how Snapshot works](https://docs.snapshot.org/)

### Typical Scenarios for Snapshot Bot Monitoring

1. New proposal creation
2. Proposal entering the voting phase
3. Proposal voting ends
4. Proposal being deleted

**Supported Data Sources**

| Data Source | Type      | Stability |
| ----------- | --------- | --------- |
| Snapshot    | off chain | High      |

### How to Configure Snapshot Bot Monitoring?

After logging into the ChainBot platform, click on "Create Bot" -> "Snapshot Monitor" in the top right corner.

<figure><img src="/files/DNudKAgrtOivCSxrf70J" alt=""><figcaption><p>Create a Snapshot Bot</p></figcaption></figure>

#### Info Explanation

| Field | Description                                          | Required |
| ----- | ---------------------------------------------------- | -------- |
| Name  | Bot monitoring name                                  | Yes      |
| Space | Snapshot platform space name, usually an ENS domain. | Yes      |
| Tags  | Bot monitoring tags for easy search                  | Yes      |

#### Conditions Explanation

<table><thead><tr><th>Field</th><th width="249.33333333333331">Description</th><th>Required</th></tr></thead><tbody><tr><td>Event</td><td>Supported proposal status</td><td>Yes</td></tr></tbody></table>

#### Event Types

| Type             | Description                           |
| ---------------- | ------------------------------------- |
| proposal/created | New proposal created                  |
| proposal/start   | Proposal enters voting                |
| proposal/end     | Proposal voting ends                  |
| proposal/deleted | Proposal deleted                      |
| Any              | Superclass of the above four statuses |

#### Template Variables

<table><thead><tr><th width="219.33333333333331">Variable</th><th width="208">Description</th><th>Example</th></tr></thead><tbody><tr><td>$proposal.id</td><td>Proposal ID</td><td>proposal/0x38c654c0f81b63ea1839ec3b221fad6ecba474aa0c4e8b4e8bc957f70100e753</td></tr><tr><td>$proposal.title</td><td>Proposal title</td><td>SIP#20 Continued Balance and Rebalancing</td></tr><tr><td>$proposal.author</td><td>Proposal author</td><td>pistachiodao.eth</td></tr><tr><td>$proposal.state</td><td>Proposal state</td><td>proposal/created</td></tr><tr><td>$proposal.network</td><td>Proposal network, as ChainID</td><td>1</td></tr><tr><td>$proposal.link</td><td>Snapshot proposal link</td><td><a href="https://snapshot.org/#/stgdao.eth/proposal/0x714977397be501e7f854293401370ab89d8c9261f533d7bb551d0c29ade5755f">https://snapshot.org/#/stgdao.eth/proposal/0x714977397be501e7f854293401370ab89d8c9261f533d7bb551d0c29ade5755f</a></td></tr><tr><td>$event</td><td>Proposal status</td><td>proposal/created</td></tr><tr><td>$space</td><td>Proposal's space</td><td>pistachiodao.eth</td></tr><tr><td>$time</td><td>Proposal creation time</td><td>2022-11-29T03:20:46+08:00</td></tr></tbody></table>

#### Default Notification Template

{% code overflow="wrap" lineNumbers="true" %}

```shell
[{$bot.name}]
Proposal: {$snapshot.proposal.title}
Space: {$snapshot.space.id}
Event: {$snapshot.event}
Time: {$snapshot.time}
Detail: {$snapshot.proposal.link}
```

{% endcode %}

[Learn about alarm notification templates](https://github.com/ChainbotAI/doc-en/blob/master/advanced-features/alarm-notification-template/README.md)

#### Sample Notification Message

> \[ Stargate new proposal]
>
> Proposal: SIP #16 - New Assets - DAI, FRAX, sUSD, LUSD
>
> Space: stgdao.eth
>
> Event: proposal/created
>
> Time: 2022-09-30T19:23:47+08:00
>
> Detail: <https://snapshot.org/#/stgdao.eth/proposal/0xe6fef4aa9c8e9d162f694ab764b11c06918b9f199aafe43e0d85b12d8271011c>
>
> Created By [ChainBot.io](https://www.chainbot.io)

#### Snapshot Bot Monitoring Case

[Snapshot Bot Example](/bot-case/snapshot-bot-demo.md)


---

# 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.chainbot.io/basic-usage/bots/snapshot-bot.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.