如何在 DocuSign 中使用 SMS-Authentication

Question

I'm trying to implement the SMS authentication with the aid of the DocuSign-SDK library.

var signer = new Signer {...};

signer.RequireIdLookup = "true";
signer.IdCheckConfigurationName = "SMS Auth $";
signer.SmsAuthentication = new RecipientSMSAuthentication {
SenderProvidedNumbers = new List<string> {
    "0171*******"  
   }
};

When I try to send this envelope to the DocuSign API it will reply with the following error message:

Error calling CreateEnvelope: {"errorCode":"INVALIDAUTHENTICATIONSETUP","message":"Recipient phone number is invalid. Phone number for SMS Authentication: provided is invalid. }

INVALIDAUTHENTICATIONSETUP: Authentication is not setup correctly for the recipient.

Is there something I have to enable on the DocuSign Admin page? I couldn't find any feature or something like that I need to enable.

Did I implement it the wrong way? Maybe someone can give me some suggestions.

Thanks

BTW: The given phone number should be valid.

Answer 1

Your code is using the older method, the new method code is provided in GitHub , I'll post it here too. You can find the article on Dev Center.

string workflowId = phoneAuthWorkflow.WorkflowId;

EnvelopeDefinition env = new EnvelopeDefinition()
{
    EnvelopeIdStamping = "true",
    EmailSubject = "Please Sign",
    EmailBlurb = "Sample text for email body",
    Status = "Sent"
};

byte[] buffer = System.IO.File.ReadAllBytes(docPdf);

// Add a document
Document doc1 = new Document()
{
    DocumentId = "1",
    FileExtension = "pdf",
    Name = "Lorem",
    DocumentBase64 = Convert.ToBase64String(buffer)
};

// Create your signature tab
env.Documents = new List<Document> { doc1 };
SignHere signHere1 = new SignHere
{
    AnchorString = "/sn1/",
    AnchorUnits = "pixels",
    AnchorXOffset = "10",
    AnchorYOffset = "20"
};

// Tabs are set per recipient/signer
Tabs signer1Tabs = new Tabs
{
    SignHereTabs = new List<SignHere> { signHere1 }
};


string workflowId = workflowId;

RecipientIdentityVerification workflow = new RecipientIdentityVerification()
{
    WorkflowId = workflowId,
    InputOptions = new List<RecipientIdentityInputOption> {
        new RecipientIdentityInputOption
        {
Name = "phone_number_list",
ValueType = "PhoneNumberList",
PhoneNumberList = new List<RecipientIdentityPhoneNumber>
{
    new RecipientIdentityPhoneNumber
    {
        Number = phoneNumber,
        CountryCode = countryAreaCode,
    }
}
        }
    }
};

Signer signer1 = new Signer()
{
    Name = signerName,
    Email = signerEmail,
    RoutingOrder = "1",
    Status = "Created",
    DeliveryMethod = "Email",
    RecipientId = "1", //represents your {RECIPIENT_ID},
    Tabs = signer1Tabs,
    IdentityVerification = workflow,
};

Recipients recipients = new Recipients();
recipients.Signers = new List<Signer> { signer1 };
env.Recipients = recipients;

Answer 2

When I'm using the new method as @Inbar wrote, I can't get the needed workflowId from the AccountsApi .

var client = new ApiClient(ApiClient.Demo_REST_BasePath);

var token = "eyJ1...";
client.Configuration.DefaultHeader.Add("Authorization", "Bearer " + token);

var accountsApi = new AccountsApi(client);    
var response = accountsApi.GetAccountIdentityVerification(accountId);

var result = response.IdentityVerification; // Is empty. Why?

It seems that I have no IdentityVerification options which I can use for the authentication.

How can I enable such IdentityVerification options?

Or what else do I need to pay attention to?