Documentation

Managing Drivers

The Drivers page lets you create and manage profiles for the people who operate your vehicles. Driver profiles can include photos, contact information, license details, and Telegram integration for notifications.

Viewing Drivers

The Drivers table displays:

• Photo: Driver's profile photo (hover to see a larger preview)
• Name: Driver's full name
• Email: Contact email address
• Phone: Contact phone number
• Telegram Chat ID: Telegram user ID for receiving notifications
• Identifier: Your custom ID for the driver (e.g., employee number)
• Sync Status: Connection status with the tracking server (Pending, Synced, Failed)

Use the Columns button to show or hide table columns.

Searching for Drivers

Use the search field to find drivers by name, email, identifier, or phone number.

Adding a Driver

1. Click the Add Driver button.
2. Fill in the driver details:
   • Photo (Optional): Upload a profile photo.
   • License Image (Optional): Upload an image of the driver's license.
   • Name (Required): Driver's full name.
   • Identifier (Required): Your ID for this driver (e.g., employee number). Must be unique.
   • Email (Optional): Contact email address. Used for email notifications before shifts.
   • Phone (Optional): Contact phone number.
   • Telegram Chat ID (Optional): The driver's Telegram user ID. The driver can find this by starting the NexaBus Telegram bot — it will display their Chat ID, which they then share with you to enter here.
3. Click Create Driver.

Editing a Driver

1. Find the driver in the table.
2. Click the actions menu (three dots) in that row.
3. Select Edit.
4. Update the information as needed.
5. Click Update Driver.

You can also update or remove the photo and license image when editing.

Deleting a Driver

1. Find the driver in the table.
2. Click the actions menu (three dots) in that row.
3. Select Delete.
4. Confirm the deletion.

Warning: Deleting a driver removes them from any assigned vehicles.

Understanding Sync Status

Drivers sync with the NexaBus tracking server:

• Pending: Currently syncing
• Synced: Successfully connected
• Failed: Sync failed - click to retry

If a driver shows "Failed", click the Retry button to attempt synchronization again.

Telegram Bot

NexaBus includes a Telegram bot that drivers can use to view their assigned trips and receive shift reminders. The bot supports English and Russian and automatically detects the driver's language preference from their Telegram settings.

Connecting a Driver to the Bot

To link a driver to the bot, the driver needs to share their Telegram Chat ID with an administrator, who then enters it in the driver's profile.

1. The driver opens Telegram and starts the NexaBus bot.
2. The bot displays their Telegram Chat ID.
3. The driver shares this Chat ID with an administrator.
4. The administrator enters it in the Telegram Chat ID field of the driver's profile.

Bot Commands

Interactive Menu

Once registered, drivers can use the bot's interactive menu:

• My Trips — Shows all routes assigned to the driver for today, including start/end times and vehicle.
• Stops — Shows all stops for a route with names, addresses, and passenger counts.
• Passengers — Shows the list of passengers assigned to a specific stop.
• Refresh — Reloads the current view with the latest data.
• My Chat ID — Displays the driver's Chat ID.

Trip Start Notifications

Drivers can receive an automatic Telegram message before their shift starts. The notification includes:

• Route name and vehicle
• Shift start and end times
• Full stop list in order
• A Google Maps link with directions to all stops

To enable notifications:

1. The driver must be registered with the bot (have a Telegram Chat ID in their profile).
2. Go to Team Settings > Notifications and enable Driver Trip Start Telegram Notifications.
3. Set how many minutes before the shift the notification should be sent.

Permissions

You need the appropriate permissions to add, edit, or delete drivers. If these options are not visible, contact your administrator to request access.