nhill40 | Posts: 40

Email delivery status?

0 votes
In doing some testing in my sandbox, I noted that if I submit a package with a signer with an invalid email address, early the next morning I got a delivery failure notification to my email inbox. I'm curious if there is a way to actively monitor email delivery status via the API? I've looked over the package JSON looking for a field along these lines (something like an "emailDeliveryStatus"), but I'm not seeing anything. Does anyone know if such a field exists or if any other email delivery status monitoring options are available?

harishaidary | Posts: 1812

Reply to: Email delivery status?

0 votes
Hi there, There is no way to retrieve the delivery status of an email through the API. What I can suggest is to create a callback listener and subscribe to the EMAIL_BOUNCE event. If you don't receive any notifications that an email has been bounced, you can be pretty much assured that the email has been sent. Also, the reason why you received the failure delivery email the next morning is because you entered an invalid (non-existing) domain. In these cases, you'll receive the bounce notification the next day. However, if the domain is correct but the user incorrect, you'll receive the bounce notification within minutes.

nhill40 | Posts: 40

Reply to: Email delivery status?

0 votes
Haris - thank you for the info! An event-based solution is actually preferable to the type of solution I was asking about in my original question, so this is perfect! Many thanks - I'll take a look!

nhill40 | Posts: 40

Reply to: Email delivery status?

0 votes
One interesting thing I noted in reviewing those docs - is it true that the only way to see these events is through setting up a 'callback' via one of your SDK options? Put another way, is there a way to subscribe/view/query/etc events directly via the SignLive API, or is using one of the SDKs are only option?

mwilliams | Posts: 957

Reply to: Email delivery status?

1 votes
Hey nhill40, The easiest way is actually through the UI, but you can definitely set the callback URL, key, and subscribed events through the REST API. If you look at this guide, you'll see how to locate this in the UI and how to use the REST API to set it up. Feature Guides - Callback Notifications Hope this helps.

nhill40 | Posts: 40

Reply to: Email delivery status?

0 votes
Ah! Thank you! My apologies - I am well familiar with that set of documentation, but I completely overlooked that particular entry. I'll take a look!

nhill40 | Posts: 40

Reply to: Email delivery status?

0 votes
OK, hand a chance to review all of this information and it looks like a really nice option - this should fit our needs nicely (and then some!) One follow up task our security people had for me is to follow up with eSignLive to find out what the origin of these callback POSTs will be, as they would like to build a firewall rule in front of the API we stand up to receive them. Does anyone have some advice on how to track that information down?

mwilliams | Posts: 957

Reply to: Email delivery status?

0 votes

Take a look at this guide: https://community.onespan.com/documentation/onespan-sign/guides/quick-start-guides/developer/environment-urls-ip-addresses#aanchor88 Whitelisting the IP from your instance of eSignLive should take care of that for you. Be sure to check out the Callback Key setting as well. That key will come via the auth header on the http call so you can verify that eSignLive is who actually sent you the notification.


nhill40 | Posts: 40

Reply to: Email delivery status?

0 votes
Holy smokes, you guys are on it - thank you! My only hope is that you don't get tired of repeatedly telling me to "read the docs...search the forums...read the docs...search the forums..." :D

mwilliams | Posts: 957

Reply to: Email delivery status?

0 votes
Haha! Don't worry, we won't get tired of helping! :) Have a great weekend!

nhill40 | Posts: 40

Reply to: Email delivery status?

0 votes
We're forging ahead with implementing an endpoint to receive callbacks on, but an interesting question came up - If you guys aren't able to get a successful POST to go through (like if our service is down or if there were some sort of network issue), I assume that you retry in a bit - correct? Meaning, if our service was temporarily down, we wouldn't miss out on any events (we'd receive them all once the next successful POST came through).

harishaidary | Posts: 1812

Reply to: Email delivery status?

0 votes
If the esignlive application isn't able to make a successful POST request to your callback URL, you will be notified via email. The esignlive application will not retry to make a post for the same event.

nhill40 | Posts: 40

Reply to: Email delivery status?

0 votes
Cool, thanks for the info - we'll design accordingly. So, are those events just lost then? Or is there some other mechanism by which we can go out and learn about them?

nhill40 | Posts: 40

Reply to: Email delivery status?

0 votes
Just a bump to see if anyone has an advice on this. To recap: Assuming we've setup an endpoint to allow eSignLive to POST events to us, my understanding is if that endpoint is for whatever reason unavailable, we'll be notified via email that eSignLive was unable to deliver events to us. My question is what happens (if anything) to those missed events? Is there some sort of alternate mechanism available for us to receive those, or is it a "at most once" delivery paradigm from the eSignLive perspective? Thank you!

harishaidary | Posts: 1812

Reply to: Email delivery status?

0 votes
Once you receive the email notification for a callback failure, eSignLive will not resend or attempt to resend that specific event and there isn't a possibility to retrieve it.

nhill40 | Posts: 40

Reply to: Email delivery status?

0 votes
OK, that's what we needed to know - we'll design accordingly, thank you!

nhill40 | Posts: 40

Reply to: Email delivery status?

0 votes
For event callback notification, does eSignLive always make 1 POST per event, or are events ever batched up into collections and sent all at once? Specifically, I'm wondering because it looks as though EMAIL_BOUNCE events get sent out the following morning after the failed email attempt - I'm curious if we had multiple bounce backs on a given day, the following morning would we expect a sequence of POSTs (one for each event) or a single POST with a collection? Thanks, Nick

mwilliams | Posts: 957

Reply to: Email delivery status?

0 votes
Hey Nick, You will receive a notification (POST request) for each event, individually. Rolling them into a single call would mean that we delay sending a notification for a particular window of time. The goal of the callback listener is to work in the "close-to-real-time" world.

nhill40 | Posts: 40

Reply to: Email delivery status?

0 votes
Yes, makes sense - thank you for the speedy response.

mwilliams | Posts: 957

Reply to: Email delivery status?

0 votes
You're very welcome! As always, let us know whenever you have questions!

Hello! Looks like you're enjoying the discussion, but haven't signed up for an account.

When you create an account, we remember exactly what you've read, so you always come right back where you left off