Webhook-based integration

Connect your dispatch system with our AI assistant through simple webhook endpoints. When a customer calls or sends a message, our system communicates with your backend in real-time to identify customers, estimate prices, create bookings, and handle cancellations. No complex SDKs or libraries required - just standard HTTP requests with JSON payloads.

Real-timeSecure HTTPSJSON Format
Request
POST
https://your-api.com/webhook
{
"event": "new_booking",
"customer": "John Doe",
"pickup": "Main Street 15",
"destination": "Airport"
}
Response
{
"status": "success",
"booking_id": "BK-2024-001",
"message": "Booking received"
}

Customer identification

Webhook API

When a customer calls, our system instantly identifies them by their phone number. Regular customers are recognized immediately, with their profile, favorite addresses, and active bookings ready for the AI assistant. This enables personalized service from the first second of the call.

Instant recognition

The system queries your dispatch database in real-time. Within milliseconds, the AI knows if this is a new or returning customer, enabling personalized greetings and faster service.

Address history

Frequent addresses are automatically retrieved - home, work, favorite destinations. Customers can simply say "take me home" and the AI already knows where to go.

Active bookings

If the customer has pending rides, the AI is immediately aware. They can ask about arrival time, modify the booking, or cancel - all handled seamlessly.

API Example: Incoming Connection

Request
{
"phoneNumber": "+48123456789",
"uniqueId": "call-abc123"
}
Response
{
"succeed": true,
"customer": {
"id": 1234,
"name": "John Doe",
"frequentAddresses": [...],
"activeBookings": [...]
}
}

Real-time estimation

Webhook API

Before confirming any booking, customers want to know when the taxi will arrive and how much it will cost. Our system communicates with your dispatch center to provide accurate, real-time estimates based on actual vehicle availability and current traffic conditions.

Arrival time

Get accurate ETA based on the nearest available vehicle. The system checks your fleet's current positions and calculates realistic arrival times.

Price estimation

Provide fare estimates before booking confirmation. Customers appreciate transparency, and accurate quotes build trust and reduce cancellations.

Vehicle availability

Real-time check of available vehicles in the pickup area. If no cars are nearby, the AI can suggest alternative pickup times or locations.

API Example: Estimate Taxi

Request
{
"phoneNumber": "+48123456789",
"customerId": "1234",
"beginAddress": {
"street": "Main Street",
"buildingNumber": "15"
},
"endAddress": {
"name": "Airport"
},
"pickupDate": "2024-01-15T14:30:00Z"
}
Response
{
"succeed": true,
"arrivalTime": 480,
"price": "45.00 PLN"
}

Instant booking

Webhook API

Once the customer confirms, the order is instantly created in your dispatch system. All collected information - addresses, time, special requirements - flows directly to your dispatch system for distribution according to your company's rules. No manual data entry, no delays, no errors.

Address validation

Addresses are validated against your system before booking. The AI ensures all location data is accurate and complete, reducing failed pickups.

Customer preferences

Special requirements like wheelchair access, child seats, or pet-friendly vehicles are captured and sent with the booking. Drivers arrive prepared.

Instant confirmation

Booking ID is returned immediately. The AI confirms the order to the customer with all details - pickup time, estimated fare, and how to identify the driver.

API Example: Create Booking

Request
{
"phoneNumber": "+48123456789",
"customerId": "1234",
"beginAddress": {
"street": "Main Street",
"buildingNumber": "15"
},
"endAddress": {
"name": "Airport"
},
"pickupDate": "2024-01-15T14:30:00Z",
"preferences": "child seat"
}
Response
{
"succeed": true,
"bookingId": 98765
}

Easy cancellation

Webhook API

Customers can cancel bookings through the same channels they used to order. The AI identifies their active bookings, confirms which one to cancel, and updates your dispatch system instantly. Clean, simple, and stress-free.

Booking identification

The system automatically finds the customer's active bookings. For multiple pending rides, the AI asks which one to cancel using clear, simple questions.

Instant status update

Cancellation is processed in real-time. Your dispatch system is updated immediately, freeing up the assigned driver for other orders.

Confirmation & feedback

Customers receive clear confirmation that their ride has been cancelled. The AI can also collect optional feedback to help improve your service.

API Example: Cancel Booking

Request
{
"phoneNumber": "+48123456789",
"customerId": "1234",
"bookingId": 98765
}
Response
{
"succeed": true
}

Data Structures

Reference documentation for the data structures used in webhook requests and responses.

Address
Data structure
FieldTypeDescription
streetstringStreet name
buildingNumberstringBuilding/house number
citystringCity name
namestringLocation name (e.g., "Airport", "Central Station")
latitudenumberGPS latitude coordinate
longitudenumberGPS longitude coordinate
Customer
Data structure
FieldTypeDescription
idnumberUnique customer identifier in your system
namestringCustomer's full name
companyNamestringCompany name (for business accounts)
frequentAddressesAddress[]List of frequently used addresses
activeBookingsTaxiBooking[]List of currently active bookings
TaxiBooking
Data structure
FieldTypeDescription
idnumberUnique booking identifier
beginAddressAddressPickup location
endAddressAddressDestination location
pickupDatestring (ISO)Scheduled pickup date and time
statusstringCurrent booking status
preferencesstringSpecial requirements (child seat, wheelchair, etc.)
TaxiPreference
Data structure
FieldTypeDescription
idnumberPreference identifier
namestringPreference name (e.g., "Child seat", "Wheelchair accessible")
descriptionstringDetailed description of the preference
Join our community to get weekly updates and unique gifts every Friday.
Taxi Copilot
© 2026 Taxi Copilot. All rights reserved.