-
Notifications
You must be signed in to change notification settings - Fork 89
Home
The Mail and Packages integration creates sensors for supported shippers to show a snapshot of mail and packages that are scheduled to be delivered the current day. It provides a count of in transit and delivered packages that are scheduled to be delivered the current day. It also generates the number of USPS mail pieces and provides a rotating GIF of the USPS provided images of the mail, if available, for the current day.
From your instance of HASS, the Mail and Packages integration connects to the email account you supply where your shipment notifications are sent. It reviews at the subject lines of the current day's emails from the shipping companies and counts the subject lines that match known language from the shipping companies about their transit status. For USPS Informed delivery emails, it also downloads the mail images to combine them into a rotating GIF.
The email can not be deleted until the next day. You can have your email filtered into a folder and have the integration watch that folder.
- All procedures are done locally on your machine.
- No external services are used to process your email.
- No data is sent outside of your local instance of Home Assistant
| Shipper | Subject | Body Text | Tracking Number | |
|---|---|---|---|---|
| USPS | USPSInformeddelivery@informeddelivery.usps.com | Your Daily Digest | none | n/a |
| USPS | auto-reply@usps.com | Expected Delivery on | out for delivery | Subject |
| USPS | auto-reply@usps.com | Item Delivered | none | n/a |
| UPS | mcinfo@ups.com | UPS Update: Package Scheduled for Delivery Today | Tracking Number | Body / Subject |
| UPS | mcinfo@ups.com | UPS Update: Follow Your Delivery on a Live Map | Tracking Number | Body / Subject |
| UPS | mcinfo@ups.com | Your UPS Package was delivered | none | n/a |
| FEDEX | TrackingUpdates@fedex.com | Delivery scheduled for today | none | n/a |
| FEDEX | TrackingUpdates@fedex.com | Your package is scheduled for delivery today | none | Subject |
| FEDEX | TrackingUpdates@fedex.com | Your package has been delivered | none | n/a |
| Amazon USA | shipment-tracking@amazon.com | none | will arrive: | Subject |
| Amazon USA | order-update@amazon.com | none | Delivered: Your | Subject |
| Amazon Canada | shipment-tracking@amazon.ca | none | will arrive: | Subject |
| Amazon UK | shipment-tracking@amazon.co.uk | none | will arrive: | Subject |
| Amazon India | shipment-tracking@amazon.in | none | will arrive: | Subject |
| DHL | donotreply_odd@dhl.com | DHL On Demand Delivery | scheduled for delivery TODAY | Body |
| DHL | donotreply_odd@dhl.com | DHL On Demand Delivery | has been delivered | n/a |
| Canada Post | donotreply@canadapost.postescanada.ca | Delivery Notification | n/a | n/a |
Please note this list is not a complete listing.
Amazon uses a several of the shippers listed above a long with their own contractor delivery crew. When amazon ships through an outside carrier the integration will pick those emails and display the count through that shippers sensors. When Amazon ships through an internal contractor they provide a shipping notification with the body text "will arrive:" about 2 or 3 days before they expect it to be delivered.
The integration scans for these emails the current day and previous 2 days. If the "deliver by:" date matches the current day the value is increased by 1. Amazon now provides a delivered notification* for internal contractor deliveries. These emails are searched for in the current day only the same way the other shipper delivered emails are counted.
Amazon is not fully integrated into the integrations accumulative sensors.