Desarrolladores

Conecta tu software con tus operaciones de despacho.

Convierte pedidos en trabajos de reparto, envía los cambios de estado a tu sistema y crea un asistente de IA que pueda consultar el trabajo en RouteIQ Dispatch Software.

Dos formas de conectar

REST API + webhooks

De un pedido a una entrega asignada.

Llega un pedido de tu tienda o sistema de reservas. Tu integración crea el trabajo en RouteIQ Dispatch Software y mantiene actualizado el pedido original.

  1. Recibe el pedido

    Tu sistema aporta el cliente, el servicio, la recogida y la entrega.

  2. Crea el trabajo

    Envía el trabajo a RouteIQ Dispatch Software y guarda el ID devuelto.

  3. Asigna un conductor

    Elige un conductor y un vehículo aptos y envía la asignación.

  4. Sincroniza el estado

    Recibe eventos mediante un webhook y actualiza tu sistema de pedidos.

MCP

Pregunta por un trabajo. Obtén una respuesta de RouteIQ Dispatch Software.

Empieza con una pregunta sobre un trabajo existente. El asistente utiliza el conector para consultarlo y explica los datos recibidos.

Conversación ilustrativa · Datos de ejemplo

Tú

Muéstrame la recogida, la entrega y el conductor asignado a job-demo.

Tu asistente

Recogida: 18 Market Street. Entrega: 42 Harbor Avenue. ID del conductor asignado: driver-demo.

Este ejemplo consulta un trabajo. No crea ni asigna trabajos.

Qué ocurre antes de la respuesta

  1. Descubrir

    search_api encuentra la operación para consultar el trabajo.

  2. Inspeccionar y consultar

    describe_api proporciona el esquema; call_api envía el ID del trabajo a RouteIQ Dispatch Software.

  3. Explicar el resultado

    El asistente resume las paradas y el ID del conductor. Se aplican los permisos de tu clave API.

Ver la llamada de herramienta y los datos de ejemplo
Parámetros de MCP tools/call
{
  "name": "call_api",
  "arguments": {
    "operation": "GET /job/{id}",
    "path": {
      "id": "job-demo"
    }
  }
}
Campos seleccionados de la API · ejemplo
{
  "id": "job-demo",
  "driver_user_id": "driver-demo",
  "stops": [
    {
      "order": 0,
      "type": "pickup",
      "address": {
        "street_address": "18 Market Street"
      }
    },
    {
      "order": 1,
      "type": "dropoff",
      "address": {
        "street_address": "42 Harbor Avenue"
      }
    }
  ]
}
Configurar el conector local

Un cliente MCP compatible con procesos locales inicia el conector en tu equipo o servidor. Configura la URL de tu sitio y una clave de integración dedicada mediante la gestión de secretos del cliente. Sustituye el comando por la ruta absoluta del ejecutable instalado.

Formato de configuración · depende del cliente
{
  "mcpServers": {
    "routeiq": {
      "command": "/absolute/path/to/routeiq-mcp",
      "env": {
        "ROUTEIQ_API_URL": "https://YOUR-SITE.routeiq.app/api",
        "ROUTEIQ_API_KEY": "YOUR-INTEGRATION-KEY"
      }
    }
  }
}

Para asignar trabajos, configura las confirmaciones necesarias en tu cliente. El conector ejecuta las escrituras inmediatamente y no incluye una pantalla de aprobación.

Crea el flujo que necesitas

Consulta la referencia actual de la API

Crea una clave en Configuración → Claves API y elige el rol que necesita tu flujo. Guárdala en tu servidor o en la gestión de secretos del cliente MCP. Consulta los esquemas y la autenticación actuales en la referencia del backend.