Skip to main content
POST
/
api
/
v1
/
track-and-trace
/
trigger-dispatch-call
Trigger a dispatch call
curl --request POST \
  --url https://api.fleetworks.ai/api/v1/track-and-trace/trigger-dispatch-call \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "toPhone": "+15551234567",
  "loadNumber": "FW-123456",
  "driverName": "John Smith",
  "dotNumber": 1234567,
  "metadata": {
    "internal_load_id": "ABC123",
    "dispatch_id": "DISP-456"
  }
}'
{
  "success": true,
  "call": {
    "id": 12345,
    "fromPhone": "+15551234567",
    "toPhone": "+15559876543",
    "status": "IN_PROGRESS",
    "conversationId": 67890,
    "createdAt": "2024-03-15T14:30:00.000Z",
    "updatedAt": "2024-03-15T14:35:00.000Z"
  }
}

Authorizations

​
Authorization
string
header
required

An authentication token that identifies the organization associated with the event. You can reach out to FleetWorks team to request a token.

Body

application/json
​
toPhone
string
required

Phone number to call in E.164 format. Must include country code with + prefix (e.g., +15551234567). For extensions, append ;ext= followed by the extension number (e.g., +15551234567;ext=123).

Example:

"+15551234567"

​
loadNumber
string
required

Your load reference number. This is used to retrieve load details from FleetWorks including pickup/delivery locations, appointment times, equipment requirements, and reefer settings.

Example:

"FW-123456"

​
driverName
string
required

The name of the driver who will be handling this load. The AI agent will verify this during the call to ensure they're speaking with the correct person.

Example:

"John Smith"

​
dotNumber
integer
required

The DOT number of the carrier. This is used to retrieve carrier information.

Example:

1234567

​
metadata
object

Optional. Custom metadata as key-value pairs that will be included in webhook events. This allows you to map calls back to your internal systems when receiving webhooks. Values can be strings or numbers.

Example:
{
  "internal_load_id": "ABC123",
  "dispatch_id": "DISP-456",
  "priority": 1
}

Response

Success

​
success
boolean
​
call
object | null

Call details if the call was successfully initiated.

⌘I