Integración basada en webhooks

Conecta tu sistema de despacho con nuestro asistente IA a través de simples endpoints webhook. Cuando un cliente llama o envía un mensaje, nuestro sistema se comunica con tu backend en tiempo real para identificar clientes, estimar precios, crear reservas y gestionar cancelaciones. Sin SDKs complejos ni bibliotecas - solo solicitudes HTTP estándar con payloads JSON.

Tiempo realHTTPS seguroFormato JSON
Solicitud
POST
https://your-api.com/webhook
{
"event": "new_booking",
"customer": "John Doe",
"pickup": "Main Street 15",
"destination": "Airport"
}
Respuesta
{
"status": "success",
"booking_id": "BK-2024-001",
"message": "Booking received"
}

Identificación del cliente

Webhook API

Cuando un cliente llama, nuestro sistema lo identifica instantáneamente por su número de teléfono. Los clientes habituales son reconocidos inmediatamente, con su perfil, direcciones favoritas y reservas activas listos para el asistente IA. Esto permite un servicio personalizado desde el primer segundo de la llamada.

Reconocimiento instantáneo

El sistema consulta tu base de datos de despacho en tiempo real. En milisegundos, la IA sabe si es un cliente nuevo o recurrente, permitiendo saludos personalizados y un servicio más rápido.

Historial de direcciones

Las direcciones frecuentes se recuperan automáticamente - casa, trabajo, destinos favoritos. Los clientes pueden simplemente decir "llévame a casa" y la IA ya sabe a dónde ir.

Reservas activas

Si el cliente tiene viajes pendientes, la IA lo sabe inmediatamente. Pueden preguntar por el tiempo de llegada, modificar la reserva o cancelar - todo gestionado sin problemas.

Ejemplo API: Conexión entrante

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

Estimación en tiempo real

Webhook API

Antes de confirmar cualquier reserva, los clientes quieren saber cuándo llegará el taxi y cuánto costará. Nuestro sistema se comunica con tu central de despacho para proporcionar estimaciones precisas en tiempo real basadas en la disponibilidad real de vehículos y las condiciones actuales del tráfico.

Tiempo de llegada

Obtén ETA preciso basado en el vehículo disponible más cercano. El sistema verifica las posiciones actuales de tu flota y calcula tiempos de llegada realistas.

Estimación de precio

Proporciona estimaciones de tarifa antes de la confirmación de reserva. Los clientes aprecian la transparencia, y las cotizaciones precisas generan confianza y reducen cancelaciones.

Disponibilidad de vehículos

Verificación en tiempo real de vehículos disponibles en el área de recogida. Si no hay coches cerca, la IA puede sugerir horarios o ubicaciones alternativas.

Ejemplo API: Estimar taxi

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

Reserva instantánea

Webhook API

Una vez que el cliente confirma, el pedido se crea instantáneamente en tu sistema de despacho. Toda la información recopilada - direcciones, hora, requisitos especiales - fluye directamente a tu sistema de despacho para distribución según las reglas de tu empresa. Sin entrada manual de datos, sin retrasos, sin errores.

Validación de direcciones

Las direcciones se validan contra tu sistema antes de la reserva. La IA asegura que todos los datos de ubicación sean precisos y completos, reduciendo recogidas fallidas.

Preferencias del cliente

Requisitos especiales como acceso para sillas de ruedas, sillas infantiles o vehículos que admiten mascotas se capturan y envían con la reserva. Los conductores llegan preparados.

Confirmación instantánea

El ID de reserva se devuelve inmediatamente. La IA confirma el pedido al cliente con todos los detalles - hora de recogida, tarifa estimada y cómo identificar al conductor.

Ejemplo API: Crear reserva

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

Cancelación fácil

Webhook API

Los clientes pueden cancelar reservas a través de los mismos canales que usaron para pedir. La IA identifica sus reservas activas, confirma cuál cancelar y actualiza tu sistema de despacho instantáneamente. Limpio, simple y sin estrés.

Identificación de reserva

El sistema encuentra automáticamente las reservas activas del cliente. Para múltiples viajes pendientes, la IA pregunta cuál cancelar usando preguntas claras y simples.

Actualización de estado instantánea

La cancelación se procesa en tiempo real. Tu sistema de despacho se actualiza inmediatamente, liberando al conductor asignado para otros pedidos.

Confirmación y feedback

Los clientes reciben confirmación clara de que su viaje ha sido cancelado. La IA también puede recopilar comentarios opcionales para ayudar a mejorar tu servicio.

Ejemplo API: Cancelar reserva

Solicitud
{
"phoneNumber": "+48123456789",
"customerId": "1234",
"bookingId": 98765
}
Respuesta
{
"succeed": true
}

Estructuras de datos

Documentación de referencia para las estructuras de datos utilizadas en solicitudes y respuestas webhook.

Address
Estructura de datos
CampoTipoDescripción
streetstringNombre de la calle
buildingNumberstringNúmero de edificio/casa
citystringNombre de la ciudad
namestringNombre de la ubicación (ej., "Aeropuerto", "Estación Central")
latitudenumberCoordenada GPS de latitud
longitudenumberCoordenada GPS de longitud
Customer
Estructura de datos
CampoTipoDescripción
idnumberIdentificador único del cliente en tu sistema
namestringNombre completo del cliente
companyNamestringNombre de la empresa (para cuentas empresariales)
frequentAddressesAddress[]Lista de direcciones frecuentemente utilizadas
activeBookingsTaxiBooking[]Lista de reservas actualmente activas
TaxiBooking
Estructura de datos
CampoTipoDescripción
idnumberIdentificador único de reserva
beginAddressAddressUbicación de recogida
endAddressAddressUbicación de destino
pickupDatestring (ISO)Fecha y hora programada de recogida
statusstringEstado actual de la reserva
preferencesstringRequisitos especiales (silla infantil, silla de ruedas, etc.)
TaxiPreference
Estructura de datos
CampoTipoDescripción
idnumberIdentificador de preferencia
namestringNombre de preferencia (ej., "Silla infantil", "Accesible para sillas de ruedas")
descriptionstringDescripción detallada de la preferencia
Desarrolladores
Únete a nuestra comunidad para recibir actualizaciones semanales y regalos exclusivos cada viernes.
Taxi Copilot
© 2026 Taxi Copilot. Todos los derechos reservados.