Platform Integration
Connect external ride-hailing platforms like Uber, Careem, and others to your dispatch system -- manage credentials, sync trips, and track platform-sourced revenue.
The Platform Integration page allows you to connect your TransportechAI dispatch system with external ride-hailing and transportation platforms. When your drivers operate on platforms like Uber, Careem, Bolt, or others, this integration enables you to track those trips, sync revenue data, and maintain a unified view of your entire fleet operation.
Navigation: Dispatch > Platform Integration
Purpose
Many fleet operators have drivers working across multiple platforms simultaneously. Without integration, platform trip data lives in separate dashboards, making it difficult to get a complete picture of fleet performance and driver earnings. The Platform Integration feature allows you to:
- Connect to external ride-hailing platforms via API or data sync
- Automatically import trip records from connected platforms
- Track platform-sourced revenue alongside your direct bookings
- Maintain a single source of truth for all fleet operations
- Compare performance across different platforms
Connected Platforms
The main page displays a list of all platform integrations, both connected and available.
Platform Cards
Each platform is displayed as a card showing:
| Field | Description |
|---|---|
| Platform Name | The name and logo of the external platform (e.g., Uber, Careem, Bolt) |
| Connection Status | Connected, Disconnected, or Error |
| Last Sync | Timestamp of the most recent successful data sync |
| Trips Imported | Total number of trips imported from this platform |
| Revenue | Total revenue tracked from this platform |
| Drivers Linked | Number of your drivers who have active accounts on this platform |
Connection Statuses
| Status | Description |
|---|---|
| Connected | The integration is active and syncing data |
| Disconnected | The integration has been set up but is currently disabled |
| Error | The integration encountered a problem (expired credentials, API failure, etc.) |
| Not Configured | The platform is available for integration but has not been set up yet |
Setting Up a Platform Integration
To connect a new platform, click the Connect button on the desired platform card.
Connection Configuration
| Field | Type | Required | Description |
|---|---|---|---|
| Platform | Pre-selected | Yes | The platform you are connecting to |
| API Key | Text | Conditional | API key provided by the platform (if using API integration) |
| API Secret | Text | Conditional | API secret for authentication |
| Account Email | Text | Conditional | The email associated with your fleet's account on the platform |
| Organization ID | Text | Conditional | Your fleet's organization or company ID on the platform |
| Sync Frequency | Dropdown | Yes | How often data should be synced -- Every 15 minutes, Hourly, Every 6 hours, or Daily |
| Auto-Import Trips | Toggle | No | If enabled, new trips from the platform are automatically imported into the system |
The exact fields required vary depending on the platform. The setup wizard guides you through the specific authentication process for each platform, including any OAuth-based authorization flows.
Authentication Methods
Different platforms support different authentication methods:
| Method | Description |
|---|---|
| API Key | A static key and secret pair provided by the platform's developer portal |
| OAuth 2.0 | A secure authorization flow where you log into the platform and grant access to TransportechAI |
| CSV Upload | For platforms without API access, you can manually upload trip data as CSV files (see Trip Import) |
| Webhook | The platform sends trip data to TransportechAI in real time via webhook endpoints |
Managing Connected Platforms
Viewing Integration Details
Click on a connected platform card to see:
- Sync History -- A log of all sync attempts with status (Success, Partial, Failed) and record counts
- Error Log -- Details of any sync errors or warnings
- Driver Mapping -- Which of your drivers are linked to accounts on this platform
- Revenue Summary -- Revenue breakdown by time period from this platform
Driver Mapping
For the integration to correctly attribute platform trips to your drivers, each driver's external platform account must be mapped to their TransportechAI profile.
| Field | Description |
|---|---|
| Driver (TransportechAI) | The driver in your system |
| Platform Account | The driver's account ID or email on the external platform |
| Status | Mapped, Unmapped, or Conflict |
Unmapped drivers will still have their trips imported, but the trips will appear as "Unassigned" in the system. Regularly review the driver mapping to ensure all platform trips are correctly attributed.
Editing Connection Settings
Click Settings on a connected platform to modify:
- Sync frequency
- API credentials (if they need to be rotated)
- Auto-import preferences
- Data mapping rules (how platform fields map to TransportechAI fields)
Disconnecting a Platform
To disconnect a platform integration:
- Open the platform detail view.
- Click Disconnect.
- Confirm the action.
Disconnecting a platform stops all future data syncs. Historical trip data that was already imported remains in the system and is not deleted.
Data Sync Details
What Gets Synced
| Data Type | Description |
|---|---|
| Trips | Trip records including pickup, dropoff, distance, duration, and fare |
| Driver Earnings | The driver's earnings breakdown per trip as reported by the platform |
| Ratings | Passenger ratings from the platform |
| Cancellations | Cancelled trip records |
What Does Not Sync
| Data Type | Reason |
|---|---|
| Passenger Personal Data | Privacy regulations prevent syncing passenger details from external platforms |
| Payment Processing | Payment is handled by the external platform; only the fare amount is synced |
| Chat Messages | In-app communication between driver and passenger stays on the platform |
Revenue Tracking
Platform-sourced revenue is tracked separately in reports and on the Dispatch Dashboard:
| Metric | Description |
|---|---|
| Platform Gross Revenue | Total fares from platform trips |
| Platform Commission | The platform's commission or service fee deducted from fares |
| Fleet Net Revenue | Revenue received by your fleet after platform commission |
| Driver Payout | Amount paid to the driver for platform trips |
Platform revenue is included in the Finance Dashboard under the "Ride Hailing Revenue" category. This gives your finance team a complete picture of all revenue sources without needing to check each platform separately.
Tips
Set up automated syncing (every 15 minutes or hourly) for your primary platforms. This ensures your dispatch dashboard always reflects the most current data across all channels.
After connecting a new platform, perform an initial manual sync and review the imported data to verify that trips, fares, and driver mappings are correct before relying on automated imports.
Peak Hours
Configure peak hour time windows and pricing multipliers -- adjust fares automatically based on demand periods, weekdays, weekends, and special events.
Trip Import
Import trip records from external sources into TransportechAI -- upload CSV files, map columns, validate data, and reconcile imported trips with your dispatch records.