Field Sales

Team Appointments And Calendar Connections

Set working hours, book and cancel visits, connect an optional personal calendar, and distinguish in-app reminders from delivered notifications.

Open The Team Calendar

From Follow-Ups, open Team Appointment Calendar at /follow-ups/calendar. The existing follow-up queue remains separate. Choose Day, Week or Month to review appointments.

Set the company timezone and the rep's working hours before booking. Unchecked days are unavailable. A visit must fit inside a working window, last no more than 12 hours and not overlap another active visit. Invalid or ambiguous daylight-saving times are rejected rather than guessed.

Book Or Cancel A Visit

  1. Choose the date, property, rep, title and visit times.
  2. Review the displayed timezone and availability before saving.
  3. Reload if the visit conflicts with another booking or the availability has changed.
  4. Cancel a visit when it will not happen; do not treat cancellation as deletion of every external record.

Members manage their own hours and visits. Administrators can manage company reps, reassign visits and select the available round-robin option. Round robin chooses among available eligible reps; it does not override working hours or make inactive users available.

Connect An Optional Calendar

Google and Microsoft calendar connections require separate application setup and the signed-in rep's consent. A configured integration is not a verified live connection. Without a connection, the calendar uses internal availability only and cannot account for unseen external events.

Check the connection and synchronization status before assuming an event reached an external calendar. Errors or pending work are not completed synchronization. Disconnecting removes the local connection and pending jobs, not provider events that already exist; review the provider calendar separately.

External calendar busy time is checked for connected reps when booking an appointment. Provider busy times can change independently after booking. The system checks both internal working hours and external calendars atomically before confirming a booking.

Manage Synchronization

The calendar displays pending sync jobs for your connections. Process next sync job manually processes one queued calendar event. Failed jobs retry automatically with exponential backoff. Provider sync errors remain queued without blocking internal appointment records.

External calendar changes may update the internal appointment if the provider event is edited. The system reconciles completed sync jobs to detect title or time changes. Provider edits must still respect working hours and avoid conflicts with other appointments. Changes that violate these rules are rejected and logged as errors.

Enable Background Processing Separately

Scheduled external-calendar synchronization and automatic reminder processing are opt-in. The deployment operator must enable FIELD_APPOINTMENTS_CRON_ENABLED=true before the appointment worker performs background work. By default, the worker does no work to avoid idle database cost; creating an appointment or connecting a calendar does not enable it automatically.

The scheduled worker also needs its deployment schedule, authentication and relevant calendar-provider configuration. Enabling the flag is not proof that external synchronization or reminder delivery has succeeded. Internal appointment records remain separate from the worker's background processing.

A configured cron worker processes batches of pending sync jobs, runs reminder generation for upcoming appointments, and reconciles completed external events. The worker processes up to 4 companies per batch and limits runtime to avoid exceeding serverless function timeouts. Pending jobs resume from durable database state after process crashes or deployment restarts.

Review Reminders

Notifications opens the appointment reminder inbox. In-app reminders are not evidence of delivered email, SMS or push notifications. Opening a reminder does not establish that the customer received or read anything.

Reminders are generated automatically for appointments starting within 15 minutes. Each reminder includes the appointment title, start time in company timezone, and a link to the calendar. Mark as read updates a single reminder. Dismiss removes the reminder from your inbox. Older reminders shows paginated history beyond the initial 20 items.

The system generates reminders only for active users and uncancelled appointments. Reminders use deterministic IDs to prevent duplicates if the cron worker runs multiple times for the same appointment window.

Need to see how KnockTracer fits your workflow?

Start with map-first sales tracking now, then layer in partner sync, install handoffs, and customer launch flows as your team grows.