This guide explains how to connect TrackB to the Newo Platform to enable real-time delivery status lookups in AI-powered conversations. Once configured, the AI Employee can retrieve shipment status using a customer's tracking number and report back exactly what the TrackB API returns.
Prerequisites
Before you begin, confirm that you have:
An active Newo Platform account with Builder access
A customer agent to add the integration to
No external API credentials are required — the TrackB integration uses built-in access tokens managed by the platform.
Create the TrackB project
Before configuring attributes, add the TrackB integration module to the customer's Builder. Follow the steps in Create a new project using these values:
Field | Value |
|
|
|
|
|
|
|
|
Ensure Auto update enabled is turned on, then click Create.
Once the project is created, click the three dots icon next to it and select Force Update Project to pull the latest module version.
Then click Publish All.
Configure TrackB attributes
The TrackB integration works out of the box with its default settings. The following optional attributes are available in the Attributes page under section 12. TrackB Settings:
Attribute | Default | Description |
|
| Automatically adds the Delivery Status Lookup scenario and intent to the Canvas on publish. |
|
| Applies the default TrackB configuration to the ConvoAgent on setup. |
No changes are required unless you want to disable automatic scenario creation or agent attribute overrides.
Verify the setup
After publishing, confirm that the integration provisioned correctly:
Open the Canvas for the customer's agent.
Confirm a Delivery Status Lookup scenario is present.
Confirm a Delivery Status Lookup intent is present within that scenario.
🗒️ NOTE
If the scenario or intent is missing, confirm that trackb_setup_scenarios is set to True and click Publish All again.
How delivery lookup works
When a customer asks about a delivery, the agent:
Extracts the tracking number from the conversation using LLM-powered identification.
Queries the TrackB API:
GET https://track.pasts.lv/api/v1/consignment/tracking?id={tracking_number}Reads back the exact status returned by the API — no interpretation or speculation is added.
🗒️ NOTE
The agent reports only what is explicitly present in the TrackB API response. If a status field is unavailable, the agent states that rather than guessing or inferring a delivery timeline.
Test the integration
Test the integration through the Newo conversation interface (voice or chat).
Start a conversation and say: "What's the status of my delivery? My tracking number is [tracking_number]."
Verify the agent returns the status reported by TrackB.
Confirm the agent does not add interpretations or speculate about delivery timelines beyond what the API returned.
Limitations
Limitation | Details |
Single tracking number per turn | Only one tracking number can be looked up per conversation turn. |
TrackB service only | The integration is specific to TrackB (track.pasts.lv). Other carriers are not supported. |
On-demand lookups only | The agent does not proactively notify customers of status changes. |