01
Slack → tasks
- Listen for action-item phrasing
- Agent creates a structured task
- Assigns and dates it automatically
OptimoRoute
17 tools available
OptimoRoute is an online route optimization and planning solution for delivery, logistics, and field service companies.
Connect OptimoRoute to Definable to turn discussions into tasks, roll up daily progress, reprioritise the roadmap on impact. Personas call OptimoRoute's 17 tools directly from chat or scheduled flows. Pair with a delivery persona — the agent keeps the tracker in lock-step with what the team is actually doing.
Common workflows with OptimoRoute
02
Daily standup digest
- Pull yesterday's task changes
- Summarise per assignee
- Post to the team channel
03
Roadmap re-prio
- Read open issues + recent customer feedback
- Persona scores by impact
- Suggests new ordering for review
OptimoRoute actions 17
Every OptimoRoute action below is a callable tool any Definable persona can invoke.
Create Order
Tool to create a new order or update an existing order in OptimoRoute. Use when you need to add delivery, pickup, or task orders to the system with location, time windows, and other constraints.
Create or Update Orders
Tool to bulk create, update, or replace multiple orders at once without geocoding. Use when you need to add new orders or modify existing ones efficiently. Supports up to 500 orders per request.
Delete All Orders
Tool to remove all orders and planned routes for a specified date. Use when you need to clear orders for a specific date or delete all orders system-wide if no date is provided.
Delete Order
Tool to remove a single order from the OptimoRoute system. Use when you need to delete a specific order by its orderNo.
Delete Orders
Tool to delete one or more orders from the system in bulk (max 500 per request). Use when you need to remove orders, either individually or in batch operations.
Get Order Completion Details
Tool to retrieve completion details for one or more orders including proof of delivery data. Use when you need to check order completion status, timing details, and form data.
Get Drivers
Tool to retrieve all drivers in the system. Use when you need up-to-date driver data including status and contact information.
Get Mobile Events
Tool to retrieve mobile events from drivers' field operations. Use when you need to track order completions, status changes (success, failed, on_duty, off_duty), and other field events for the currently active plan.
Get Orders
Tool to retrieve one or more orders from OptimoRoute. Use when you need detailed order information including location, time windows, and assignment details.
Get Planning Status
Tool to retrieve the status of an active planning/optimization process. Use when you need to check the progress of a planning job by providing its ID.
Get Planned Routes
Tool to retrieve all planned routes for a given date. Use when you need a detailed view of routes including optional stops, route parameters, and unassigned orders.
Get Order Scheduling Info
Tool to retrieve scheduling information for a specific order. Use when you need to check if an order is scheduled and get details like driver assignment, timing, and position.
Search Orders
Tool to search for orders in OptimoRoute based on criteria. Use when you need to find orders by date range, order identifiers, or order status. At least one of 'orders' or 'date_range' must be provided.
Start Planning
Tool to start the planning/optimization process for a specified date or date range. Use when you need to generate optimized routes for orders and drivers. Requires orders to be created before planning can begin.
Stop Planning
Tool to stop an active planning/optimization process. Use when you need to halt a running planning job by providing its ID.
Update Driver Parameters
Tool to update driver parameters for a specific date including work times, vehicle assignment, and start/end locations. Use when you need to modify driver availability or routing constraints. Note that this unschedules existing routes for the driver on the specified date.
Update Drivers Parameters
Tool to update parameters of multiple drivers for specified dates in bulk (max 500 per request). Use when you need to modify driver configuration including work hours, vehicle assignments, and location settings. Note: Existing routes for the specified drivers and dates will be unscheduled.
Agiled
Agiled is an all-in-one business management platform designed to streamline operations such as CRM, project management, finance, and more.
Asana
Tool to help teams organize, track, and manage their work.
Basecamp
Project management and team collaboration tool by 37signals
Breeze
Breeze is a project management software that helps teams plan, track, and collaborate on projects efficiently.
Bugherd
BugHerd is a visual feedback and bug tracking tool for websites, allowing clients and teams to report issues directly on live sites.
ClickUp
ClickUp unifies tasks, docs, goals, and chat in a single platform, allowing teams to plan, organize, and collaborate across projects with customizable workflows
Frequently asked questions
What can I automate with OptimoRoute on Definable?
Anything OptimoRoute exposes through its API. Common project management workflows on Definable include turn discussions into tasks, roll up daily progress, reprioritise the roadmap on impact. Personas can call any of the 17 OptimoRoute tools directly, then chain the result into another integration without you writing code.
How does OptimoRoute authentication work?
OptimoRoute uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.
Is the OptimoRoute integration included in my Definable plan?
Yes — every Definable plan, including Starter, includes access to all 17 OptimoRoute tools. You only need a separate OptimoRoute subscription if OptimoRoute itself charges per seat or per API call.
Is using OptimoRoute through Definable secure?
Every call from a persona to OptimoRoute is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.
How do I get started with OptimoRoute on Definable?
Sign up for Definable, open the integrations page, find OptimoRoute, and connect via OAuth or API key. You can immediately attach OptimoRoute to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
What OptimoRoute actions does Definable expose?
Definable exposes all 17 OptimoRoute actions as callable tools — including `Create Order`, `Create or Update Orders`, `Delete All Orders`, plus 14 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Ready to automate with OptimoRoute?
Wire it up in minutes. No coding required.