We have a very straight-forward DocuSign integration where the users can add signers and send document for signing from our document management tool and the signer level updates are automatically fetched by tool and available to requester within our tool itself.
We recently ran into a rather unexpected situation with our DocuSign integration, wherein DocuSign updated/changed/resolved one of the signer's email address to a different email address. Thus, whenever we (tool) tried to fetch the updates corresponding to that signer, DocuSign kept returning null pointer exception (as the signer with that email no longer existed for the DocuSign).
On after retrieving the audit details for this envelope, we were able to understand the above issue. This was logged in DocuSign envelope history as "Recipient email resolved". On DocuSign Admin account, this entry is shown as below:
DocuSign Envelope History Screenshot
I have tried to dig into DocuSign documentation (product & API both) to know more about "Recipient email resolved" action but to no avail.
My queries are -
Has anyone run into similar situation in past?
What is the root cause/reason because of which DocuSign automatically resolves (changes) the email address of the recipient?
Is there a way to suppress this behavior? If not, is there a way to retrieve the status update against original email address instead of having to manually update the email in our tool?
Additional Information:
Our tool is built such that it allows the customers to configure their own DocuSign account
The email address rarely changes. This only happens on occasions where the signer has specifically provided DocuSign with their preferred email address and alternates. There's no option for you to suppress this behavior.
You can check the envelope to get the signer information later to see the change if you wish.
Hope this helps
Related
I have two problems with Docusign, first, always it sent the envelope with the same account, no matter who is logged always is sending using the same account, i don't know why.
Second, i want to change the subject and message, i am using the example for apex toolkit and i am using the template, but always it show the same subject Documents for your DocuSign signature.
https://www.docusign.com/blog/dsdev-sending-template-apex-toolkit
To change the subject of a message you can use the withEmail method and edit the emailSubject property. See the API reference for more details: https://developers.docusign.com/docs/salesforce/apex-toolkit-reference/envelope.html
Do your salesforce users have the DocuSign Sender permission? I'm thinking that could be the reason that envelopes aren't being sent from their account.
I am using Remote Signing with the DocuSign api, but I want to know how to determine what action the recipient took (i.e. they signed, declined to sign, viewed, etc). How do I do this?
You want the status of the envelopes you sent?
Best technique is to create a webhook and have DocuSign call your server when the envelope's status changes.
You can create DocuSign notification message subscriptions at either the account level or at the individual envelope level.
See this blog entry for more info. Ask additional questions on StackOverflow if you have any difficulties.
Is there any way programmatically (using Java) to stop the signer from getting a notification and receiving the completed document?
I see an option in the user profile but I want to set it while sending an envelope.
You could use embedded signing. That way DocuSign would not know the email address of the signer.
You should also check with your legal counsel about your plan. Asking someone to sign a document and then not giving them a copy of it is unusual behavior.
I am using the DocuSign API in an embedded manner. I create an envelope and add signers, the first signer always being set as embedded. This allows me to retrieve a URL that is then embedded in an iframe.
However, I also wish, to trigger an email (as soon as the envelope has been created, NOT upon completion) that gets sent to the primary recipient/signer as if they were a nonembedded signer.
I tried adding the signer twice, with the same role, to the recipients, but that didn't work. No email was sent.
Is there a way to accomplish this?
I believe there is a setting to enable this but that it needs to be enabled by someone on DocuSign's side, like your account manager. If you do not have an account manager yet please respond to the auto-generated emails that were sent out to you once you created your account, you should have 3 of them.
The account settings available are only for Completion emails. However, the REST API also supports an embeddedRecipientStartURL parameter on the signer object that triggers a normal DocuSign email. The value of this parameter is the URL that should be included in the email. This means you can link back to your own application and request the recipient view as normal.
Check here for more detail: Signer embeddedRecipientStartURL. Note: if you set this to a value of "SIGN_AT_DOCUSIGN" then DocuSign will provide its own URL and take care of signing. The trade-off is that you won't be able to initiate any bespoke authentication you are doing in your own application.
i Am Using Docu Sign demo Sample. with help of Demo Sample i am Creating an Application and Trying to Send Email to my Recipient but my recipient is not receiving any mail. i checked email credential and firewall all are okay.
But i am getting Success status by .
EnvelopeStatus status = client.CreateAndSendEnvelope(envelope);
// If we succeeded, go to the status
if (status.SentSpecified)
{
AddEnvelopeID(status.EnvelopeID);
Response.Redirect("GetStatusAndDocs.aspx", false);
}
Status.SentSpecified is true all time.
i dont know where is the Problem?
Thanks in Advance to Assist me.
Normally when DocuSign recipients are not receiving emails it's because one (or more) of the following reasons:
The email notification is not enabled for the action in question (usually signature request).
Security or spam software is catching/filtering the email before it reaches the recipient.
You are setting the recipient as an embedded recipient.
An invalid or incorrect email address has been provided in the request.
Possible resolutions for each
Check email notification preferences by logging into the DocuSign Console and going to Preferences -> Manage Email Notifications.
Check your security software settings, firewalls, spam/junk mail filtering, inspect logs, etc.
Embedded recipients by default do not receive an email (since they are immediately signing). Making a recipient Embedded means setting the clientUserId property for them. To NOT make them an embedded recipient do NOT set the clientUserId property (don't include it in the request at all)
Ensure the intended email addresses are being set.
Something else that might help debug these types of issues - you can always request the problematic envelope through an API call and inspect it. If using the DocuSign SOAP API you can do this through the RequestEnvelope() call, if using REST look to do a GET call on the /accounts/{accountId}/envelopes/{envelopeId} URI
I would like to add to what #Ergin mentioned that there are Features to enable sending of emails to Embedded receipients.
You should look for these two somewhat confusingly named features:
Suppress Emails to Embedded Signers (checked by default)
Use Envelope Complete Email for (non-suppressed) Embedded Signers
The fix for me was to uncheck the first one and check the second one. This page has a more thorough description:
Suppress Email to Embedded Signers (Check box) – When selected an email completion notice is not sent to embedded signers when envelope signing is completed. This option is only used with the embedded signing function of the DocuSign API and cannot be selected if the Use Envelope Complete Email for (non-suppressed) Embedded Signers option is selected.
Use Envelope Complete Email for (non-suppressed) Embedded Signers (Check box) - When selected an email completion notice is sent to embedded signers when envelope signing is completed. This option is only used with the embedded signing function of the DocuSign API.
As a note you will need to modify this under the DocuSign Admin portal's "Signing Settings".