为每个签名者创建私人消息

Question

根据DocuSign Documentation，可以发送信封，信封中的每个签名者都会收到一封“私信”＃34;。我查看了DocuSign REST API文档，但无法找到对私人消息的任何引用，或者有关如何创建私有消息的详细信息。

有人可以提供有关＆＃34;私信＆＃34;的REST API实施的详细信息。特征？另外一个例子DocuSign .Net SDK会很棒。

Answer 1

您可以为每个收件人指定 emailNotification 属性。文档here

以下是createEnvelope请求示例。

  

POST / v2 / accounts / {accountId} / envelope

{
  "status": "sent",
  "recipients": {
      "signers": [
          {
             "email": "janedoe@acme.com",
             "name": "jane doe",
             "recipientId": 1,
             "emailNotification": {
                "emailSubject": "Please sign the  document(s) (jane doe)",
                "emailBody": "Hello Jane Doe,\r\n\r\nYour have a new document to view and sign.  Please click on the View Documents link below, review the content, and sign the document.  ",
                "supportedLanguage": "en"
              },
              "tabs": {"signHereTabs": [ { "documentId": "1", "pageNumber": "1", "xPosition": "80", "yPosition": "80"}]}
          },
          {
             "email": "johnsmith@acme.com",
             "name": "john smith",
             "recipientId": 2,
             "emailNotification": {
                "emailSubject": "Please sign the  document(s) (john smith)",
                "emailBody": "Hello john smith,\r\n\r\nYour have a new document to view and sign.  Please click on the View Documents link below, review the content, and sign the document.  ",
                "supportedLanguage": "en"
              },
              "tabs": {"signHereTabs": [ { "documentId": "1", "pageNumber": "1", "xPosition": "80", "yPosition": "180"}]}
          }
      ]
  },
  "documents": [
      {
          "documentId": "1", "name": "Contract", "fileExtension": "txt", "documentBase64": "RG9jIFRXTyBUV08gVFdP"
      }
  ]
}

使用C＃SDK

完整代码here

    public void CreateEnvelopeSeparateEmailNotificationForRecipients()
    {
        string accountID = Init();

        byte[] fileBytes = System.IO.File.ReadAllBytes(@"C:\temp\test.pdf");
        var envDef = new EnvelopeDefinition()
        {
            Status = "sent",
            Recipients = new Recipients()
            {
                Signers = new List<Signer>() 
                {
                    new Signer()
                    {
                        Email = "janedoe@acme.com",
                        Name = "jane doe",
                        RecipientId = "1",
                        RoutingOrder = "1",
                        EmailNotification = new RecipientEmailNotification()
                        {
                            EmailSubject = "Please sign the  document(s) (jane doe)",
                            EmailBody = "This is email body for Jane Doe"
                        },
                        Tabs = new Tabs() { SignHereTabs =  new List<SignHere>(){ new SignHere() { DocumentId = "1", XPosition = "100",YPosition = "300", PageNumber = "1" } } }
                    },
                    new Signer()
                    {
                        Email = "johnsmith@acme.com",
                        Name = "JohnSmith",
                        RecipientId = "2",
                        RoutingOrder = "1",
                        EmailNotification = new RecipientEmailNotification()
                        {
                            EmailSubject = "Please sign the  document(s) (John Smith)",
                            EmailBody = "This is email body for John Smith"
                        },
                        Tabs = new Tabs() { SignHereTabs =  new List<SignHere>(){ new SignHere() { DocumentId = "1", XPosition = "200",YPosition = "300", PageNumber = "1" } } }
                    }
                }
            },
            Documents = new List<Document>()
            {
                new Document()
                {
                    DocumentBase64 = System.Convert.ToBase64String(fileBytes),
                    Name = "Contract",
                    DocumentId = "1"
                }
            }               
        };

        EnvelopesApi envelopesApi = new EnvelopesApi();
        EnvelopeSummary envelopeSummary = envelopesApi.CreateEnvelope(accountID, envDef);
    }