公司侧边栏
公司侧边栏
该应用程序显示在右侧的公司卡位置,以及本地小部件。
示例清单
“位置”:{
“卖出”:{
“company_card”:“资产/ iframe.html”
}
},
以下对象在此位置可用:
事件
除了核心事件,以下事件可用于公司侧栏位置的应用程序:
还可以通过添加后缀侦听Contact对象的任何对象或属性上的更改.changed
它的路径。类绑定的任何事件处理程序.changed
事件接收一个对象,该对象具有已更改的属性的名称、它的前一个值和它的新值。例子:
客户端.在(“contact.creator.changed”,(数据)=>{
控制台.日志(数据);// {propertyName, oldValue, newValue}
});
看到使用框架事件.
contact.notes.added
在向联系人添加备注时触发。绑定的任何事件处理程序contact.notes.added
接收note对象。
例子:
客户端.在(“contact.notes.added”,(请注意)=>{
控制台.日志(请注意);//注意对象
/ /例如:
/ / {
// id: 32661;
// "creator_id": 42616,
// resource_type: "sales_account";
// "resource_id": 29732437,
// "content": "呼叫他们,但没有回应",
// "created_at": "2019-10-01T09:00:21Z",
// "updated_at": "2019-10-01T09:00:21Z"
/ /}
});
contact.tasks.added
当任务添加到当前选项卡中的联系人时触发。绑定的任何事件处理程序contact.tasks.added
接收任务对象。
例子:
客户端.在(“contact.tasks.added”,(任务)=>{
控制台.日志(任务);//任务对象
/ /例如:
/ / {
// id: 32661;
// "creator_id": 42616,
// "owner_id": 42616,
// resource_type: "sales_account";
// "completed": false;
// "completed_at": null,
// "due_date": "2020-01-14T00:00:00Z",
// " expired ": false;
// "remind_at": null,
// "resource_id": 29732437,
// "content": "安排会议";
// "created_at": "2019-10-01T09:00:21Z",
// "updated_at": "2019-10-01T09:00:21Z"
/ /}
});
contact.tasks.completed
当当前联系人的任务在当前选项卡中被标记为已完成时触发。绑定的任何事件处理程序contact.tasks.completed
接收任务对象。
例子:
客户端.在(“contact.tasks.completed”,(任务)=>{
控制台.日志(任务);//任务对象
/ /例如:
/ / {
// id: 32661;
// "creator_id": 42616,
// "owner_id": 42616,
// resource_type: "sales_account";
// "completed": true;
// "completed_at": "2019-12-14T09:00:11Z",
// "due_date": "2020-01-14T00:00:00Z",
// " expired ": false;
// "remind_at": null,
// "resource_id": 29732437,
// "content": "安排会议";
// "created_at": "2019-10-01T09:00:21Z",
// "updated_at": "2019-10-01T09:00:21Z"
/ /}
});
联系对象
联系人代表个人(如Mark Johnson)或组织(如Google)。每个联系人有两个状态字段:customerStatus
和prospectStatus
.他们描述了联系人与你的业务的关系。
联系人类型:
- 定期联系人——你认识的人或组织,但你还没有与他们建立业务关系
- 当前潜在客户——你正在积极销售的个人或组织
- 失败的前景-一个人或一个组织,你曾经试图出售给过去,但无法完成交易。失去的潜在客户以前从来都不是客户
- 当前客户—当前从您的企业购买商品或服务的个人或组织
- 过去的客户——以前从你的公司购买商品或服务,但现在不再购买的个人或组织
您可以为联系人分配任意数量的标签和自定义字段。标签不需要已经存在就可以分配;必要时将创建它们。
联系
检索联系
对象及其一些属性。
得到
客户端.得到(“接触”)
//也:client.get('contact.contact')
//也:client.get('contact.parentOrganization')
返回
{
“接触”:{
“id”:4,
“isOrganization”:假,
“名称”:“设计服务公司”,
“firstName”:“马克”,
“姓”:“约翰逊”,
“customerStatus”:“当前”,
“prospectStatus”:“没有”,
“标题”:“首席执行官”,
“描述”:“我是通过汤姆认识他的。”,
“行业”:“设计服务”,
“网站”:“www.designservices.com”,
“电子邮件”:”(电子邮件保护)”,
“电话”:“508-778-6516”,
“移动”:“508-778-6516”,
“传真”:“+ 44-208-1234567”,
“推特”:“mjohnson”,
“facebook”:“mjohnson”,
“linkedin”:“mjohnson”,
“skype”:“mjohnson”,
“地址”:零,
“billingAddress”:零,
“shippingAddress”:零,
“标签”:[“重要”],
“createdAt”:“2014 - 09 - 27 t16:32:56z”,
“updatedAt”:“2014 - 09 - 28 - t16:32:56z”
}
}
属性
- contact.address(object)
- contact.address.city(财产)
- contact.address.country(财产)
- contact.address.line1(property)
- contact.address.postalCode(财产)
- contact.address.state(财产)
- contact.billingAddress(object)
- contact.contact(object)
- contact.createdAt(property)
- contact.creator(object)
- contact.creator.id(财产)
- contact.customFields(property)
- contact.customerStatus(property)
- contact.description(财产)
- contact.email(property)
- contact.facebook(property)
- contact.fax(property)
- contact.firstName(property)
- contact.id(property)
- contact.industry(property)
- contact.isOrganization(property)
- contact.lastName(property)
- contact.linkedin(property)
- contact.mobile(property)
- contact.name(财产)
- contact.notes(object)
- contact.owner(object)
- contact.parentOrganization(object)
- contact.phone(property)
- contact.prospectStatus(property)
- contact.shippingAddress(object)
- contact.skype(property)
- contact.tags(property)
- contact.tasks(object)
- contact.title(property)
- contact.twitter(property)
- contact.updatedAt(property)
- contact.website(property)
行动
contact.id
联系人的唯一标识。
得到
客户端.得到(“contact.id”)
返回
{
“contact.id”:4
}
contact.creator
创建联系人的用户。
得到
客户端.得到(“contact.creator”)
返回
{
“contact.creator”:{
“id”:8
}
}
contact.creator.id
用户的唯一标识符。
得到
客户端.得到(“contact.creator.id”)
返回
{
“contact.creator.id”:8
}
contact.owner
联系人当前被分配的用户。
得到
客户端.得到(“contact.owner”)
看到用户对象对于返回的属性(contact.owner。*
).
contact.isOrganization
无论这个联系人是指组织还是个人。该值只能在创建时设置,后续不可修改。默认值为假
.
得到
客户端.得到(“contact.isOrganization”)
返回
{
“contact.isOrganization”:假
}
contact.contact
联系人所属的组织。只有联系人是个人时才设置该字段。
得到
客户端.得到(“contact.contact”)
看到联系对象对于返回的属性(contact.contact。*
).
contact.parentOrganization
作为该组织的上级的组织联系人。只有当联系人是组织并且有父级时,才设置该字段。
得到
客户端.得到(“contact.parentOrganization”)
看到联系对象对于返回的属性(contact.parentOrganization。*
).
contact.name
联系人姓名。仅当联系人是组织时才需要。
得到
客户端.得到(“contact.name”)
返回
{
“contact.name”:“设计服务公司”
}
contact.firstName
联系人的名字。
得到
客户端.得到(“contact.firstName”)
返回
{
“contact.firstName”:“马克”
}
contact.lastName
联系人的姓。只有当联系人是个人时才需要。
得到
客户端.得到(“contact.lastName”)
返回
{
“contact.lastName”:“约翰逊”
}
contact.customerStatus
联系人的客户状态。状态为none, current, past。
得到
客户端.得到(“contact.customerStatus”)
返回
{
“contact.customerStatus”:“当前”
}
contact.prospectStatus
联系人的前景状态。状态为none、current和lost。
得到
客户端.得到(“contact.prospectStatus”)
返回
{
“contact.prospectStatus”:“没有”
}
contact.title
联系人的职位。
得到
客户端.得到(“contact.title”)
返回
{
“contact.title”:“首席执行官”
}
contact.description
联系人的描述。
得到
客户端.得到(“contact.description”)
返回
{
“contact.description”:“我是通过汤姆认识他的。”
}
contact.industry
联系人的行业。
得到
客户端.得到(“contact.industry”)
返回
{
“contact.industry”:“设计服务”
}
contact.website
联系人的网站地址。
得到
客户端.得到(“contact.website”)
返回
{
“contact.website”:“www.designservices.com”
}
contact.email
联系人的电子邮件地址。
得到
客户端.得到(“contact.email”)
返回
{
“contact.email”:”(电子邮件保护)”
}
contact.phone
联系人的电话号码。
得到
客户端.得到(“contact.phone”)
返回
{
“contact.phone”:“508-778-6516”
}
contact.mobile
联系人的手机号码。
得到
客户端.得到(“contact.mobile”)
返回
{
“contact.mobile”:“508-778-6516”
}
contact.fax
联系人的传真号码。
得到
客户端.得到(“contact.fax”)
返回
{
“contact.fax”:“+ 44-208-1234567”
}
contact.twitter
联系人的Twitter帐号。
得到
客户端.得到(“contact.twitter”)
返回
{
“contact.twitter”:“mjohnson”
}
contact.facebook
联系人的Facebook昵称。
得到
客户端.得到(“contact.facebook”)
返回
{
“contact.facebook”:“mjohnson”
}
contact.linkedin
联系人的LinkedIn昵称。
得到
客户端.得到(“contact.linkedin”)
返回
{
“contact.linkedin”:“mjohnson”
}
contact.skype
联系人的Skype昵称。
得到
客户端.得到(“contact.skype”)
返回
{
“contact.skype”:“mjohnson”
}
contact.address
联系人的地址。
得到
客户端.得到(“contact.address”)
返回
{
“contact.address”:{
“line1”:“史密斯街2726号”,
“城市”:“海恩尼斯”,
“邮政编码”:“02601”,
“状态”:“马”,
“国家”:“我们”
}
}
contact.address.line1
地址的第一行。例如:号码和街道名称。
得到
客户端.得到(“contact.address.line1”)
返回
{
“contact.address.line1”:“史密斯街2726号”
}
contact.address.city
城市的名字。
得到
客户端.得到(“contact.address.city”)
返回
{
“contact.address.city”:“海恩尼斯”
}
contact.address.postalCode
邮政编码或同等学历。
得到
客户端.得到(“contact.address.postalCode”)
返回
{
“contact.address.postalCode”:“02601”
}
contact.address.state
国家的名字。
得到
客户端.得到(“contact.address.state”)
返回
{
“contact.address.state”:“马”
}
contact.address.country
国家的名字。
得到
客户端.得到(“contact.address.country”)
返回
{
“contact.address.country”:“我们”
}
contact.billingAddress
客户的账单地址。仅适用于customerStatus
或prospectStatus
不是没有一个
.
得到
客户端.得到(“contact.billingAddress”)
看到Address对象对于返回的属性(contact.billingAddress。*
).
contact.shippingAddress
客户的账单地址。仅适用于customerStatus
或prospectStatus
不是没有一个
.
得到
客户端.得到(“contact.shippingAddress”)
看到Address对象对于返回的属性(contact.shippingAddress。*
).
contact.tags
联系人的标签数组。
得到
客户端.得到(“contact.tags”)
返回
{
“contact.tags”:[“重要”]
}
contact.customFields
自定义字段是附加到联系人的键值对。
得到
客户端.得到(“contact.customFields”)
返回
{
“contact.customFields”:[的最后一个位置,“目前的供应商”,'我的自定义字段名']
}
contact.customFields:字段名
检索自定义字段的值。将自定义字段名添加到请求路径的冒号后面。
得到
客户端.得到(的接触。customFields:我的自定义字段名)
retuns
{
”接触。customFields:我的自定义字段名”:“我的价值”
}
看到自定义字段在Sell REST API文档中查找可能的返回类型。
contact.createdAt
联系人的创建日期和时间(UTC, ISO8601格式)。
得到
客户端.得到(“contact.createdAt”)
返回
{
“contact.createdAt”:“2014 - 09 - 27 t16:32:56z”
}
contact.updatedAt
联系人的最后更新日期和时间(UTC, ISO8601格式)。
得到
客户端.得到(“contact.updatedAt”)
返回
{
“contact.updatedAt”:“2014 - 09 - 28 - t16:32:56z”
}
contact.notes
contact.notes.create
为联系人创建备注。
调用
客户端.调用(“contact.notes.create”,“叫他们,但没有回答。”);
论点
- 备注内容(字符串)
返回
{
“contact.notes.create”:{
“id”:32661,
“creator_id”:42616,
“resource_type”:“sales_account”,
“resource_id”:29732437,
“内容”:"呼唤他们,却没有回应",
“created_at”:“2019 - 10 - 01 - t09:00:21z”,
“updated_at”:“2019 - 10 - 01 - t09:00:21z”
}
}
contact.tasks
contact.tasks.create
为联系人创建任务。
调用
客户端.调用(“contact.tasks.create”,“安排会议”,“2020-01-14”);
参数
- 任务的内容(字符串)
- 任务的截止日期(字符串)
返回
{
“contact.tasks.create”:{
“id”:32661,
“creator_id”:42616,
“owner_id”:42616,
“resource_type”:“sales_account”,
“完成”:假,
“completed_at”:零,
“due_date”:“2020 - 01 - 14 t00:00:00z”,
“过期”:假,
“remind_at”:零,
“resource_id”:29732437,
“内容”:“安排会议”,
“created_at”:“2019 - 10 - 01 - t09:00:21z”,
“updated_at”:“2019 - 10 - 01 - t09:00:21z”
}
}