Understanding the Calendar block detector agent

The Calendar block detector agent helps you maintain an accurate and bookable calendar by automatically finding potentially problematic blocks. It scans your portfolio for blocks that are stale or lack a clear explanation, so you can review and resolve them before they impact your availability and revenue.

This agent is read-only. It identifies and reports on calendar blocks but does not create, edit, or remove any blocks on your calendar.

Understand the Calendar block detector agent

The Calendar block detector agent runs automatically once a week on Mondays at 08:00. The agent can also be triggered manually.

During each run, the agent does the following:

1. Scans calendar block activity across your entire portfolio.
2. Flags open blocks that are stale or unexplained. A block is unexplained when it has no reason or has "Other" selected as the reason, and its note doesn't explain it either.
3. Lists who blocked or unblocked which dates and why.
4. Generates a report with its findings for you to review.

A note explains a block when it gives a reason for it, for example "owner stay", "painting the bedroom", or a guest's name. The agent doesn't flag these blocks, even if the reason field is empty or set to "Other". A note with only filler, such as "block", a number, or dates, doesn't count as an explanation, so the agent still flags the block.

Run the Calendar block detector agent manually

In addition to the scheduled run, you can trigger the agent manually at any time from the Agents hub.

Step by step:

1. Sign in to your Guesty account.
2. In the side navigation menu, select Agents hub.
3. At the top, select the Operations tab.
4. Click the Calendar block detector tile.
5. Under "When it runs", click Run now.

Review the results and status of the run in the activity feed.

Review the activity feed

Follow the steps below to review your activity feed.

Step by step:

1. Sign in to your Guesty account.
2. In the side navigation menu, select Agents hub.
3. In the left submenu, click Agent activity.
4. Click the relevant row with the agent's name to review the report details in the right-side panel. 

Understand the report status and details

If the agent detects blocks that need your attention, the report includes the following details for each flagged block:

• The affected listing's name
• The affected dates
• The number of affected nights
• The type of block
• The priority level and the reason it was flagged
• The name of the user who created the block
• The date the block was last edited
• Any added notes

If there are more flagged blocks than the report shows, the report says "Showing M of N". M is the number of blocks shown, and N is the total number of flagged blocks.

If the agent can't read the calendar blocks, the report says that the scan failed. A failed scan is never shown as "nothing to review".

Review and act on flagged blocks

The agent's report highlights calendar blocks that may need your attention. Review each flagged item and decide what action to take — for example, add a reason or note, or remove the block if it's no longer needed.