Schedule by Reform

Installation and connection

Installation

1. In Kommo, open Settings → Integrations (the marketplace) and find Schedule by Reform.
2. Click Install and allow access to the account. An administrator does this once.

The connection is automatic: no keys or tokens to enter. After installation Kommo opens Schedule in the left menu, and Kommo employees and groups are pulled in automatically.

First launch

The first time the schedule is opened, the administrator sees a small "Need help with the setup?" window. There you can leave your name, company and phone number so the Reform team can help with the setup. Name and phone are filled in from the Kommo profile. The window is optional: Send submits the request, Not now closes it for good, and the widget works without it.

The Schedule section

Where to find it

Settings → Schedule. After publication in the marketplace, it becomes a separate item in the Kommo left menu.

What's on the screen

1 2 3 4 5 6 7 8 9 10

1. Period: ‹ › arrows and the Today button.
2. View: Week / 2 weeks / Month.
3. Current time and the schedule time zone.
4. The Fill from template button.
5. Copy forward, Log and Settings buttons.
6. Today is highlighted in the header.
7. Current employee status under the name and a colored dot on the avatar.
8. Working day cell: shift time, a working-day bar with the break and a "break 13–14" label.
9. Sick leave (orange).
10. Day off (hatched).

Grid and cells

• Grid: rows are employees grouped by group; columns are days.
• Working day cell: shift time (for example, 09:00–18:00), a working-day bar where the break shows as an orange gap, and a "break 13–14" label. In the Month view the cell is compact: "9–18" and the bar; the full time and break appear in a tooltip on hover.
• Other day types: day off (hatched), vacation (green), sick leave (orange), an empty "+" cell means the day isn't filled in.

Current employee status

The line under the name shows where the employee is now: "At work until 19:00", "On break until 14:00", "Starts Thu Sep 24 09:00", "No shifts". Updates once a minute.

Green dot: at work

Yellow: on a break

Grey: not at work

2 weeks and Month views

Navigation

• Horizontal scrolling: two-finger swipe on a touchpad, the scrollbar under the grid, mouse wheel with Shift held, or dragging with the mouse by the date row, the employee column or a group name.
• The employee column and the date row stay pinned while scrolling.

Theme and language

The window adapts to Kommo's light or dark theme and switches along with it. The schedule window follows the Kommo user's language: English or Russian.

Editing the schedule

One or several days

1. Click a cell: the editing panel opens on the right.
2. To change several days or employees at once, drag the mouse across cells (or select with Shift / ⌘ / Ctrl held).
3. In the panel, choose the day type: Working / Day off / Vacation / Sick leave.
4. For a working day, set the shift start and end and the breaks (the Add break button; there can be several breaks). Quick picks are available: "09:00–18:00 · lunch 13:00", "08:00–17:00 · lunch 12:00", "10:00–19:00 · lunch 14:00", "09:00–14:00".
5. Save applies the changes; Clear removes the shift (the day becomes unfilled).

Night shifts

If the end time is earlier than the start (for example, 22:00–06:00), the shift ends the next day. A break at 02:00 is supported too.

Fill from template

The Fill from template button in the top panel.

1. Check the employees (there is "select all").
2. Choose the period (4 weeks by default).
3. Pattern:
   • By weekdays: check the working days (Mon–Fri by default);
   • Rotation (2/2 etc.): how many working days in a row and how many days off; counted from the first date of the period.
4. Working hours and breaks.
5. The Overwrite days that are already filled checkbox: turn it off to fill only empty days.
6. Apply.

Copy forward

Copies the displayed week (or 2 weeks) to the next period of the same length. Filled days in the new period are overwritten. Not available in the Month view.

Import from Google Sheets

Settings → Import tab, for teams that kept the schedule in a spreadsheet.

• Select everything in the sheet from cell A1 to the last date, copy and paste it into the field.
• Sheet format: the first row holds dates (DD.MM.YYYY); then one row per employee with 4 columns per date: start, lunch start, lunch end, end. "н" means a day off (or no lunch). Time can be written as "9" or "9:30".
• Employees are matched by name; new ones are added.

Employees and groups

Where: Settings → Employees and Groups.

• Employees and groups are pulled from Kommo automatically when the schedule is opened (at most once every 10 minutes); to do it manually, use Refresh from Kommo.
• For each employee: order in the grid (arrows), group, and the Active checkbox. Inactive employees get no leads and are hidden in the grid (you can show them in General settings).
• You can add an employee who isn't in Kommo (for the schedule and the API; the pipeline doesn't assign leads to them).
• Groups can be renamed, added and deleted; a group is used in queues and in the API.

Queues and weights

Where: Settings → Queues. A queue defines who gets leads and how. The "Main" queue is created on installation. Create a queue per source or pipeline: even with the same people, each queue has its own round, its own count and its own weights.

Grab

A new lead is first offered to everyone at work. Each of them sees a popup in the bottom right corner of Kommo with the lead name, amount and a time bar. The first to click Take grabs the lead and becomes responsible right away, without a task or note. The popup closes for everyone else.

• Where to turn it on: Settings → Queues → "Grab: first offer the lead to everyone at work": 15, 20, 30, 45, 60, 90 or 120 seconds.
• Nobody grabbed it (or everyone clicked ✕): the queue distributes the lead as usual, by schedule and weights, with a task and a note.
• Several leads at once wait in line: the next popup appears once the previous lead is decided. Leads for different people are offered in parallel.
• Only those at work by the schedule (not at lunch or on a break) with Kommo open in a browser see the popup; the mobile app doesn't show it.
• The log marks these leads as "grabbed".

Digital Pipeline trigger

1. Open Leads → Automate (Digital Pipeline) for the pipeline you need.
2. On the stage you need (usually the first), click Add trigger and choose Schedule by Reform.
3. In the Queue field, choose a queue from the list (the first one by default).
4. Choose when to fire (for example, when a lead is created / moved to the stage) and click Done.

From then on, every lead on the stage gets a responsible user within a few seconds, plus a task and a note if enabled. Different sources: different stages or pipelines with triggers for different queues; a split by a lead field can be done with a Kommo trigger condition or a Sensei process.

How the widget chooses the responsible user

Examples

Assignment log

Where: the Log button in the top panel.

The last 100 assignments: when, which lead (with a link to it), who it was assigned to, why ("was at work" / "starts first" / "kept the current assignee" / "grabbed" / "backup — no main assignees at work") with a detail such as "by weight: 60% share among those at work", when they start, and the source and queue (pipeline · Website / API · Social).

API for Sensei, Make and other services

Key

Settings → API. There you'll also find Copy and Issue a new key; the old key stops working. Pass it as key=… in the request or in the X-Api-Key header.

Address and format

https://kommo-schedule.kibetsnn.workers.dev/api/...

• The actual address is shown in the settings.
• GET or POST requests (JSON or form).
• Responses are flat JSON with no nesting, convenient for Sensei webhooks: fields are available as body.user_id and so on.
• Times in responses are in the schedule time zone (2026-09-23 15:00) and in unix seconds (fields with the _unix suffix).

Common parameters

Requests

Sensei webhook, step by step

1. URL: https://kommo-schedule.kibetsnn.workers.dev/api/pick, request type POST.
2. Headers: X-Api-Key with the key from Settings → API (48 characters: digits and a–f; don't confuse it with the Kommo integration keys).
3. POST parameters: queue = Website, lead_id = lead.id.
4. Turn on Process the response from the server. On the left, the field path always with body.: body.user_name, body.on_duty_now; on the right, the process parameter.
5. After the step, a condition, e.g. on_duty_now = 1 → "at work", otherwise → "not at work".

Errors

Add body.error and http.status to the response mapping: Sensei doesn't treat 400/404 as a step error, and without them the parameters just stay empty.

Edit access

Where: Settings → Access (administrators only).

1. In the list of Kommo users, check Can edit schedule for the people you need.
2. To limit a person to their groups, check those groups; if no groups are checked, they can edit the schedule of all groups.
3. Save. The permissions take effect the next time this user opens the schedule.

General settings

Where: Settings → General.

• Name of the account in the schedule.
• Schedule time zone: all shifts and API responses use it (taken from Kommo on connection).
• Language of notes in leads: English or Russian.
• Show inactive employees in the grid.

FAQ and troubleshooting

Support