Add Sensor for delivered USPS mail.

[ClaymoreTech4]

USPS added the ability to receive an email once mail was delivered.

USPS started new service to receive and email once mail is delivered, below is a screenshot to set it up and the email you receive once you mail is delivered.

It would be fantastic to have a sensor to show Mail delivered to be able to run automations.

Thank you



MAIL DELIVERY NOTIFICATION



 MAIL

View Dashboard



Your mail has been delivered today,
June 18!

Please note that Mail Delivery Notifications are not assurances that a specific mailpiece visible in your Informed Delivery Daily Digest Email or Dashboard has been delivered.

We value your feedback as we seek to continuously improve the accuracy of this feature.  After checking your mailbox today, please tell us about your experience with this notification:

 

You subscribed to this feature with USPS® Product Technology Innovation, 475 L'Enfant Plaza SW, Washington, DC 20260. If you no longer wish to receive Mail Delivery Notifications, you can click here to unsubscribe.

If you need assistance, please email questions or concerns to [email protected].

Copyright© 2024 United States Postal Service®. All Rights Reserved. The Eagle Logo is among the many trademarks of the U.S. Postal Service® . This is an automated email, please do not reply to this message. This message is for the designated recipient only and may contain privileged, proprietary, or otherwise private information. If you have received it in error, please delete. Any other use of the email by you is prohibited.

USPS.com | Privacy Policy | FAQs

[firstof9]

What's the from address and the subject of the email?
This option isn't yet available in my area so I cannot test.

[ClaymoreTech4]

[firstof9]

Notes:

    "usps_mail_delivered": {
        "email": [
            "[email protected]",
            "[email protected]",
            "[email protected]",
            "USPS Informed Delivery",
        ],
        "subject": ["Your Mail Was Delivered"],
    },

Binary Sensor:

    "usps_mail_delivered": BinarySensorEntityDescription(
        name="USPS Mail Delivered",
        key="usps_mail_delivered",
        device_class=BinarySensorDeviceClass.UPDATE,
    ),

[firstof9]

Please try 0.3.29b0.

[ClaymoreTech4]

Installed, Will let you know.

[firstof9]

Please note the sensor is disabled by default, so you'll need to enable it.

[ClaymoreTech4]

Yesterday I installed and enabled the sensor before the mail was delivered. The Binary Sensor did not update. Unfortunately I will be out of town starting tomorrow with a mail hold until 07-08-24. Thank you

[firstof9]

If you can get some debug logs that'd be a big help debugging.

[ClaymoreTech4]

No problem, I turned on debugging. How often does the integration check gmail?

[firstof9]

That's user configurable. The default is every 30 mins.

[github-actions]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs.

[gpeavy]

Notes:

    "usps_mail_delivered": {

        "email": [

            "[email protected]",

            "[email protected]",

            "[email protected]",

            "USPS Informed Delivery",

        ],

        "subject": ["Your Mail Was Delivered"],

    },

Binary Sensor:

    "usps_mail_delivered": BinarySensorEntityDescription(

        name="USPS Mail Delivered",

        key="usps_mail_delivered",

        device_class=BinarySensorDeviceClass.UPDATE,

    ),

I believe the Notes above were not added to the codebase with the sensor.

[firstof9]

I see them:

Home-Assistant-Mail-And-Packages/custom_components/mail_and_packages/const.py

Lines 212 to 220 in 1e8c614

	"usps_mail_delivered": {
	"email": [
	"[email protected]",
	"[email protected]",
	"[email protected]",
	"USPS Informed Delivery",
	],
	"subject": ["Your Mail Was Delivered"],
	},

[gpeavy]

My bad. Hmm. I looked at main. Didn't realize the releases are from dev. The sensor is not working for me. I have no mail coming today but I will turn on debug logs for tomorrow.

[gpeavy]

So I get the "Your Mail Was Delivered" email even when there is no mail. I searched the debug logs after the next run of the integration and they do not include the text "Your Mail Was Delivered".

[firstof9]

does the from address match any of those in the list?

I don't have this option available in my area for USPS, I could use a raw email to improve testing.

If you're using gmail it'll be the option that says "show original" in the 3 dots menu to the right.
You can pass it to me at firstof9 at gmail.com.

[gpeavy]

Email sent. Hope it helps!

[firstof9]

I'll scrub your PII from it, thanks!

[firstof9]

Ok this should work as expected in 0.4.0b7, make sure you're enabling the sensor in the config called "USPS Mail Delivered" for this sensor to update properly, there's another sensor called "USPS Delivered" which is for packages.

[gpeavy]

Is this correct? Am I missing something?

[firstof9]

Is this correct?

Looks correct, "Mail USPS Delivered" should be the one.