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