Docusignapi 从信封中检索发件人姓名和电子邮件?

Docusignapi 从信封中检索发件人姓名和电子邮件?,docusignapi,Docusignapi,我有一个服务帐户,它正在使用DocuSign的轮询来检索状态发生更改的信封列表。这些信封是由不同的内部用户发送的。当我去取回信封时,我想取回谁是信封的发件人(发件人的姓名和电子邮件) 我最初将此信息排除在信封对象之外,但它不是: Envelope envInfo = envelopesApi.GetEnvelope(AccountId, envelopeId); 我尝试了其他各种API调用并查看了文档,但它们似乎都没有提供获取发件人姓名和电子邮件的方法 可以检索此信息吗?DocuSign不以这

我有一个服务帐户,它正在使用DocuSign的轮询来检索状态发生更改的信封列表。这些信封是由不同的内部用户发送的。当我去取回信封时,我想取回谁是信封的发件人(发件人的姓名和电子邮件)

我最初将此信息排除在
信封
对象之外,但它不是:

Envelope envInfo = envelopesApi.GetEnvelope(AccountId, envelopeId);
我尝试了其他各种API调用并查看了文档,但它们似乎都没有提供获取发件人姓名和电子邮件的方法


可以检索此信息吗?

DocuSign不以这种方式工作,因为信封链接到用户及其用户的文档,因此在用户与任何人共享信封之前,任何人都无法访问文档。因此,没有API可以通过查询信封ID上的DS来通知发件人电子邮件/姓名。您有两种方法来实现此要求:

  • 使用DS Connect(推荐方式),在DS中配置Connect Account and DocuSign将推送与发件人连接的邮件 发生订阅的触发器事件时该XML消息中的详细信息

  • 另一种方法是,您需要获取所有用户和用户的OAUTH访问令牌 然后调用DS API以了解每个用户的信封

连接消息如下所示:

<UserName>Sender Name</UserName>
<Email>SenderEmail@email.com</Email>
发送者名称
SenderEmail@email.com

DocuSign不以这种方式工作,因为信封链接到用户及其用户的文档,因此在用户与任何人共享信封之前,任何人都无法访问文档。因此,没有API可以通过查询信封ID上的DS来通知发件人电子邮件/姓名。您有两种方法来实现此要求:

  • 使用DS Connect(推荐方式),在DS中配置Connect Account and DocuSign将推送与发件人连接的邮件 发生订阅的触发器事件时该XML消息中的详细信息

  • 另一种方法是,您需要获取所有用户和用户的OAUTH访问令牌 然后调用DS API以了解每个用户的信封

连接消息如下所示:

<UserName>Sender Name</UserName>
<Email>SenderEmail@email.com</Email>
发送者名称
SenderEmail@email.com

实际上,有一种方法可以通过API获取信封的发件人姓名和电子邮件。首先,发出“获取信封审核事件”请求,以标识发送者的用户ID。然后,使用该
UserId
发出Get User请求以获取发件人的姓名和电子邮件地址。以下是步骤,包括示例请求/响应(为简洁起见,省略了无关信息):

1)获取信封审核事件

请求:

GET /accounts/{accountId}/envelopes/{envelopeId}/audit_events
 GET /accounts/{accountId}/users/af465e97-83a6-472c-a25b-ebad10e4cc6a
答复:

{
    "auditEvents": [
        {
            "eventFields": [
                ...
                {
                    "name": "UserName",
                    "value": "John Doe"
                },
                {
                    "name": "UserId",
                    "value": "af465e97-83a6-472c-a25b-ebad10e4cc6a"
                },
                {
                    "name": "Action",
                    "value": "Registered"
                },
                {
                    "name": "Message",
                    "value": "The envelope was created by John Doe"
                },
                {
                    "name": "EnvelopeStatus",
                    "value": "created"
                },
                ...
            ]
        },
        ...
    ]
}
2)获取用户(指定上一个响应中的
UserId

请求:

GET /accounts/{accountId}/envelopes/{envelopeId}/audit_events
 GET /accounts/{accountId}/users/af465e97-83a6-472c-a25b-ebad10e4cc6a
答复:

{
    "userName": "John Doe",
    "userId": "af465e97-83a6-472c-a25b-ebad10e4cc6a",
    "email": "john.doe@test.com",
    "firstName": "John",
    "lastName": "Doe",
    ...
}
另一个选项(如果您首先使用API创建信封)是在创建时始终为每个信封指定包含发件人姓名和电子邮件地址的“自定义信封字段”。通过这种方式,您可以使用已发出的用于检索信封信息的相同请求检索此信息(前提是您包含额外的querystring参数(
include=custom\u fields
):


实际上,有一种方法可以通过API获取信封的发件人姓名和电子邮件。首先,发出获取信封审核事件请求以识别发件人的
用户ID
。然后,使用该
用户ID
发出获取用户请求以获取发件人的姓名和电子邮件地址。下面是他的步骤包括示例请求/响应(为了简洁起见,省略了不相关的信息):

1)获取信封审核事件

请求:

GET /accounts/{accountId}/envelopes/{envelopeId}/audit_events
 GET /accounts/{accountId}/users/af465e97-83a6-472c-a25b-ebad10e4cc6a
答复:

{
    "auditEvents": [
        {
            "eventFields": [
                ...
                {
                    "name": "UserName",
                    "value": "John Doe"
                },
                {
                    "name": "UserId",
                    "value": "af465e97-83a6-472c-a25b-ebad10e4cc6a"
                },
                {
                    "name": "Action",
                    "value": "Registered"
                },
                {
                    "name": "Message",
                    "value": "The envelope was created by John Doe"
                },
                {
                    "name": "EnvelopeStatus",
                    "value": "created"
                },
                ...
            ]
        },
        ...
    ]
}
2)获取用户(指定上一个响应中的
UserId

请求:

GET /accounts/{accountId}/envelopes/{envelopeId}/audit_events
 GET /accounts/{accountId}/users/af465e97-83a6-472c-a25b-ebad10e4cc6a
答复:

{
    "userName": "John Doe",
    "userId": "af465e97-83a6-472c-a25b-ebad10e4cc6a",
    "email": "john.doe@test.com",
    "firstName": "John",
    "lastName": "Doe",
    ...
}
另一个选项(如果您首先使用API创建信封)是在创建时始终为每个信封指定包含发件人姓名和电子邮件地址的“自定义信封字段”。通过这种方式,您可以使用已发出的用于检索信封信息的相同请求检索此信息(前提是您包含额外的querystring参数(
include=custom\u fields
):


谢谢,这正是我要找的!谢谢,这正是我要找的!