> ## Documentation Index
> Fetch the complete documentation index at: https://docs.armin.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# Poste Italiane

> Let Torben AI read where a Poste Italiane parcel is.

The Poste Italiane integration lets [Torben AI](https://docs.armin.cx/ask-torben.md) look up a Poste Italiane parcel by its tracking number and answer "Where is my parcel?" with the movements Poste Italiane recorded.

> [!NOTE]
>
> There is nothing to enter. Poste Italiane publishes no self-serve tracking API, so this connection holds no API key: connecting it is how you tell Chatarmin CX that you ship with Poste Italiane and that Torben AI may look up your parcels on poste.it's public tracking page, the same page your team would open by hand.

## What it reads

For one tracking number, the lookup returns:

* Its latest **movements** (up to 20), newest first, each with its time, place and Poste Italiane's own wording, such as *"la spedizione è in consegna"* (out for delivery).
* Poste Italiane's **expected delivery** text, when it shows one.
* Whether a movement is on the way **back to your shop**.

Torben AI translates Poste Italiane's Italian wording for your customer. It never changes a shipment, redirects a parcel, books a redelivery or sends a message to Poste Italiane.

### Returns

A parcel on its way back to your shop can still read *"la spedizione è in transito"* (in transit). Poste Italiane marks such movements as a return, and Chatarmin CX reads that mark, so a return to your shop is never told to the customer as a parcel on its way to them.

## Set it up

**1. Open integrations**

[Open integrations](https://armin.cx/app/_/settings/integrations) from your workspace settings and choose **Poste Italiane**.

If it is not listed, contact your Chatarmin CX account team to enable it for your workspace.

**2. Connect**

Click **Connect**, optionally give the connection a name, and save.

**3. Allow the lookup in a Playbook**

Add **Track a shipment** for Poste Italiane to the [Playbook](https://docs.armin.cx/ai-agents/skills-and-actions.md) that should use it. In a customer chat, Torben AI may only look up a tracking number that came from the customer's verified order.

To test it, ask [Torben AI](https://docs.armin.cx/ask-torben.md) on a ticket with a recent Poste Italiane parcel where that parcel is. The answer lists its latest movements.

## Data and access

Each lookup sends Poste Italiane only the tracking number, over poste.it's public tracking page. Torben AI sees only the tracking number and the movements' wording, places and times, and the expected-delivery text. poste.it's answer names no sender, recipient or address. Nothing is written to Poste Italiane.

poste.it's answer for a tracking number is kept for 15 minutes: when a customer asks again or another agent looks up the same parcel, Torben AI reuses it instead of asking poste.it again.

## Disconnect

Open the connection's **Connected** menu, choose **Disconnect**, and confirm **Delete**. Torben AI stops looking up Poste Italiane parcels. Your parcels are not changed.

## Troubleshooting

### Torben AI says Poste Italiane tracking is unavailable right now

poste.it limits how many lookups it answers in a short time. When it does, Torben AI says tracking cannot be checked right now instead of guessing. Try again a little later; the limit clears by itself.

### Every lookup says the reference is unknown

* Check the number for typos, for example `3UW1TOA009128`.
* The number may belong to another carrier, or Poste Italiane may not have registered the parcel yet. An unknown number is never reported as a parcel that does not exist.
* A new parcel can stay unknown for up to 15 minutes after Poste Italiane registers it, because the earlier answer is kept for that long.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.