wecom

type AddCalendar struct {
	// Organizer 指定的组织者userid。注意该字段指定后不可更新
	Organizer string `json:"organizer"  validate:"required"`
	// Readonly 日历组织者对日历是否只读权限（即不可编辑日历，不可在日历上添加日程，仅可作为组织者删除日历）。0-否；1-是。默认为1，即只读
	Readonly int `json:"readonly"  `
	// SetAsDefault 是否将该日历设置为组织者的默认日历。0-否；1-是。默认为0，即不设为默认日历第三方应用不支持使用该参数
	SetAsDefault int `json:"set_as_default"  `
	// Summary 日历标题。1 ~ 128 字符
	Summary string `json:"summary"  validate:"required"`
	// Color 日历在终端上显示的颜色，RGB颜色编码16进制表示，例如：”#0000FF” 表示纯蓝色
	Color string `json:"color"  validate:"required"`
	// Description 日历描述。0 ~ 512 字符
	Description string `json:"description"  `
	// Shares 日历共享成员列表。最多2000人
	Shares []AddCalendarRequestShares `json:"shares"  `
}

type AddCalendarRequest struct {
	// Calendar 日历信息
	Calendar AddCalendar `json:"calendar"  validate:"required"`
	// AgentID 授权方安装的应用agentid。仅旧的第三方多应用套件需要填此参数
	AgentID int `json:"agentid"  `
}

type AddCalendarRequestShares struct {
	// UserID 日历共享成员的id
	UserID string `json:"userid"  validate:"required"`
	// Readonly 共享成员对日历是否只读权限（即不可编辑日历，不可在日历上添加日程，仅可以退出日历）。0-否；1-是。默认为1，即只读
	Readonly int `json:"readonly"  `
}

type AddCalendarResponse struct {
	// CalenderID 日历ID
	CalenderID string `json:"cal_id"  `
}

type AddContactWayRequest struct {
	// Type 联系方式类型,1-单人, 2-多人
	Type int `json:"type"  validate:"required"`
	// Scene 场景，1-在小程序中联系，2-通过二维码联系
	Scene int `json:"scene"  validate:"required"`
	// Style 在小程序中联系时使用的控件样式，详见附表
	Style int `json:"style"  `
	// Remark 联系方式的备注信息，用于助记，不超过30个字符
	Remark string `json:"remark"  `
	// SkipVerify 外部客户添加时是否无需验证，默认为true
	SkipVerify bool `json:"skip_verify"  `
	// State 企业自定义的state参数，用于区分不同的添加渠道，在调用“获取外部联系人详情”时会返回该参数值，不超过30个字符
	State string `json:"state"  `
	// User 使用该联系方式的用户userID列表，在type为1时为必填，且只能有一个
	User []string `json:"user"  `
	// Party 使用该联系方式的部门id列表，只在type为2时有效
	Party []int `json:"party"  `
	// IsTemp 是否临时会话模式，true表示使用临时会话模式，默认为false
	IsTemp bool `json:"is_temp"  `
	// ExpiresIn 临时会话二维码有效期，以秒为单位。该参数仅在is_temp为true时有效，默认7天
	ExpiresIn int `json:"expires_in"  `
	// ChatExpiresIn 临时会话有效期，以秒为单位。该参数仅在is_temp为true时有效，默认为添加好友后24小时
	ChatExpiresIn int `json:"chat_expires_in"  `
	// UnionID 可进行临时会话的客户unionid，该参数仅在is_temp为true时有效，如不指定则不进行限制
	UnionID string `json:"unionid"  `
	// Conclusions 结束语，会话结束时自动发送给客户，可参考“结束语定义”，仅在is_temp为true时有效
	Conclusions *Conclusions `json:"conclusions"  `
}

type AddContactWayResponse struct {
	// ConfigID 新增联系方式的配置id
	ConfigID string `json:"config_id"  `
	// QrCode 联系我二维码链接，仅在scene为2时返回
	QrCode string `json:"qr_code"  `
}

type AddCorpTagRequest struct {
	// GroupID 标签组id
	GroupID string `json:"group_id"  `
	// GroupName 标签组名称，最长为30个字符
	GroupName string `json:"group_name"  `
	// Order 标签组次序值。order值大的排序靠前。有效的值范围是[0, 2^32)
	Order int `json:"order"  `
	// AgentID 授权方安装的应用agentid。仅旧的第三方多应用套件需要填此参数
	AgentID int `json:"agentid"  `

	Tag []AddCorpTagRequestTag `json:"tag"  `
}

type AddCorpTagRequestTag struct {
	// Name 添加的标签名称，最长为30个字符
	Name string `json:"name"  validate:"required"`
	// Order 标签次序值。order值大的排序靠前。有效的值范围是[0, 2^32)
	Order int `json:"order"  `
}

type AddCorpTagResponse struct {
	TagGroup AddCorpTagResponseTagGroup `json:"tag_group"  `
}

type AddCorpTagResponseTagGroup struct {
	// GroupID 标签组id
	GroupID string `json:"group_id"  `
	// GroupName 标签组名称
	GroupName string `json:"group_name"  `
	// CreateTime 标签组创建时间
	CreateTime int `json:"create_time"  `
	// Order 标签组次序值。order值大的排序靠前。有效的值范围是[0, 2^32)
	Order int `json:"order"  `
	// Tag 标签组内的标签列表
	Tag []AddCorpTagResponseTagGroupTag `json:"tag"  `
}

type AddCorpTagResponseTagGroupTag struct {
	// ID 新建标签id
	ID string `json:"id"  `
	// Name 新建标签名称
	Name string `json:"name"  `
	// CreateTime 标签创建时间
	CreateTime int `json:"create_time"  `
	// Order 标签次序值。order值大的排序靠前。有效的值范围是[0, 2^32)
	Order int `json:"order"  `
}

type AddGroupWelcomeTemplateRequest struct {
	// AgentID 授权方安装的应用agentid。仅旧的第三方多应用套件需要填此参数
	AgentID int `json:"agentid"  `
	// Notify 是否通知成员将这条入群欢迎语应用到客户群中，0-不通知，1-通知， 不填则通知
	Notify int `json:"notify"  `

	Text AddGroupWelcomeTemplateRequestText `json:"text"  `

	Image AddGroupWelcomeTemplateRequestImage `json:"image"  `

	Link AddGroupWelcomeTemplateRequestLink `json:"link"  `

	MiniProgram AddGroupWelcomeTemplateRequestMiniProgram `json:"miniprogram"  `

	File AddGroupWelcomeTemplateRequestFile `json:"file"  `

	Video AddGroupWelcomeTemplateRequestVideo `json:"video"  `
}

type AddGroupWelcomeTemplateRequestFile struct {
	// MediaID 文件id，可以通过素材管理接口获得
	MediaID string `json:"media_id"  validate:"required"`
}

type AddGroupWelcomeTemplateRequestImage struct {
	// MediaID 图片的media_id，可以通过素材管理接口获得
	MediaID string `json:"media_id"  `
	// PicURL 图片的链接，仅可使用上传图片接口得到的链接
	PicURL string `json:"pic_url"  `
}

type AddGroupWelcomeTemplateRequestLink struct {
	// Title 图文消息标题，最长为128字节
	Title string `json:"title"  validate:"required"`
	// PicURL 图文消息封面的url
	PicURL string `json:"picurl"  `
	// Desc 图文消息的描述，最长为512字节
	Desc string `json:"desc"  `
	// URL 图文消息的链接
	URL string `json:"url"  validate:"required"`
}

type AddGroupWelcomeTemplateRequestMiniProgram struct {
	// Title 小程序消息标题，最长为64字节
	Title string `json:"title"  validate:"required"`
	// PicMediaID 小程序消息封面的mediaid，封面图建议尺寸为520*416
	PicMediaID string `json:"pic_media_id"  validate:"required"`
	// AppID 小程序appid，必须是关联到企业的小程序应用
	AppID string `json:"appid"  validate:"required"`
	// Page 小程序page路径
	Page string `json:"page"  validate:"required"`
}

type AddGroupWelcomeTemplateRequestText struct {
	// Content 消息文本内容,最长为3000字节
	Content string `json:"content"  `
}

type AddGroupWelcomeTemplateRequestVideo struct {
	// MediaID 视频媒体文件id，可以通过素材管理接口获得
	MediaID string `json:"media_id"  validate:"required"`
}

type AddGroupWelcomeTemplateResponse struct {
	// TemplateID 欢迎语素材id
	TemplateID string `json:"template_id"  `
}

type AddMessageTemplateRequest struct {
	// ChatType 群发任务的类型，默认为single，表示发送给客户，group表示发送给客户群
	ChatType string `json:"chat_type"  `
	// ExternalUserID 客户的外部联系人id列表，仅在chat_type为single时有效，不可与sender同时为空，最多可传入1万个客户
	ExternalUserID []string `json:"external_userid"  `
	// Sender 发送企业群发消息的成员userid，当类型为发送给客户群时必填
	Sender string `json:"sender"  `
	// Attachments 附件，最多支持添加9个附件
	Attachments []AddMessageTemplateRequestAttachments `json:"attachments"  `

	Text AddMessageTemplateRequestText `json:"text"  `

	Image AddMessageTemplateRequestImage `json:"image"  `

	Link AddMessageTemplateRequestLink `json:"link"  `

	MiniProgram AddMessageTemplateRequestMiniProgram `json:"miniprogram"  `

	Video AddMessageTemplateRequestVideo `json:"video"  `

	File AddMessageTemplateRequestFile `json:"file"  `
}

type AddMessageTemplateRequestAttachments struct {
	// MessageType 附件类型，可选image、link、miniprogram或者video
	MessageType string `json:"msgtype"  validate:"required"`
}

type AddMessageTemplateRequestFile struct {
	// MediaID 文件的media_id，可以通过素材管理接口获得
	MediaID string `json:"media_id"  validate:"required"`
}

type AddMessageTemplateRequestImage struct {
	// MediaID 图片的media_id，可以通过素材管理接口获得
	MediaID string `json:"media_id"  `
	// PicURL 图片的链接，仅可使用上传图片接口得到的链接
	PicURL string `json:"pic_url"  `
}

type AddMessageTemplateRequestLink struct {
	// Title 图文消息标题，最长128个字节
	Title string `json:"title"  validate:"required"`
	// PicURL 图文消息封面的url，最长2048个字节
	PicURL string `json:"picurl"  `
	// Desc 图文消息的描述，最多512个字节
	Desc string `json:"desc"  `
	// URL 图文消息的链接，最长2048个字节
	URL string `json:"url"  validate:"required"`
}

type AddMessageTemplateRequestMiniProgram struct {
	// Title 小程序消息标题，最多64个字节
	Title string `json:"title"  validate:"required"`
	// PicMediaID 小程序消息封面的mediaid，封面图建议尺寸为520*416
	PicMediaID string `json:"pic_media_id"  validate:"required"`
	// AppID 小程序appid（可以在微信公众平台上查询），必须是关联到企业的小程序应用
	AppID string `json:"appid"  validate:"required"`
	// Page 小程序page路径
	Page string `json:"page"  validate:"required"`
}

type AddMessageTemplateRequestText struct {
	// Content 消息文本内容，最多4000个字节
	Content string `json:"content"  `
}

type AddMessageTemplateRequestVideo struct {
	// MediaID 视频的media_id，可以通过素材管理接口获得
	MediaID string `json:"media_id"  validate:"required"`
}

type AddMessageTemplateResponse struct {
	// FailList 无效或无法发送的external_userid列表
	FailList []string `json:"fail_list"  `
	// MessageID 企业群发消息的id，可用于获取群发消息发送结果
	MessageID string `json:"msgid"  `
}

type AddSchedulePushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// CalID 日历ID
	CalID string `xml:"CalId" json:"CalId"`
	// CreateTime 消息创建时间，unix时间戳
	CreateTime int64 `xml:"CreateTime" json:"CreateTime"`
	// Event 事件类型，此时固定为：add_schedule
	Event string `xml:"Event" json:"Event"`
	// FromUsername 成员UserID
	FromUsername string `xml:"FromUserName" json:"FromUserName"`
	// MsgType 消息类型，此时固定为：event
	MsgType string `xml:"MsgType" json:"MsgType"`
	// ScheduleID 日程ID
	ScheduleID string `xml:"ScheduleId" json:"ScheduleId"`
	// ToUsername 企业微信CorpID
	ToUsername string `xml:"ToUserName" json:"ToUserName"`
}

type AddScheduleRequest struct {
	// Schedule obj
	Schedule AddScheduleRequestSchedule `json:"schedule"  validate:"required"`
	// AgentID uint32
	AgentID int `json:"agentid"  `
}

type AddScheduleRequestSchedule struct {
	// Attendees obj[]
	Attendees []AddScheduleRequestScheduleAttendees `json:"attendees"  `
	// Summary string
	Summary string `json:"summary"  `
	// Description string
	Description string `json:"description"  `
	// Reminders obj
	Reminders AddScheduleRequestScheduleReminders `json:"reminders"  `
	// Location string
	Location string `json:"location"  `
	// Organizer string
	Organizer string `json:"organizer"  validate:"required"`
	// StartTime uint32
	StartTime int `json:"start_time"  `
	// EndTime uint32
	EndTime int `json:"end_time"  `
	// CalenderID string
	CalenderID string `json:"cal_id"  `
}

type AddScheduleRequestScheduleAttendees struct {
	// UserID string
	UserID string `json:"userid"  validate:"required"`
}

type AddScheduleRequestScheduleReminders struct {
	// IsRemind int32
	IsRemind int `json:"is_remind"  `
	// IsRepeat int32
	IsRepeat int `json:"is_repeat"  `
	// RemindBeforeEventSecs uint32
	RemindBeforeEventSecs int `json:"remind_before_event_secs"  `
	// RepeatType uint32
	RepeatType int `json:"repeat_type"  `
	// RepeatUntil uint32
	RepeatUntil int `json:"repeat_until"  `
	// IsCustomRepeat uint32
	IsCustomRepeat int `json:"is_custom_repeat"  `
	// RepeatInterval uint32
	RepeatInterval int `json:"repeat_interval"  `
	// RepeatDayOfWeek uint32[]
	RepeatDayOfWeek []int `json:"repeat_day_of_week"  `
	// RepeatDayOfMonth uint32[]
	RepeatDayOfMonth []int `json:"repeat_day_of_month"  `
	// Timezone uint32
	Timezone int `json:"timezone"  `
}

type AddScheduleResponse struct {
	// ScheduleID string
	ScheduleID string `json:"schedule_id"  `
}

type AddTagUsersRequest struct {
	// TagID 标签ID
	TagID int `json:"tagid"  validate:"required"`
	// UserList 企业成员ID列表，注意：userlist、partylist不能同时为空，单次请求个数不超过1000
	UserList []string `json:"userlist"  `
	// PartyList 企业部门ID列表，注意：userlist、partylist不能同时为空，单次请求个数不超过100
	PartyList []int `json:"partylist"  `
}

type AddTagUsersResponse struct {
	// InvalidList 非法的成员帐号列表
	InvalidList string `json:"invalidlist"  `
	// InvalidParty 非法的部门id列表
	InvalidParty string `json:"invalidparty"  `
}

type AgentAuthType int

type AuthSuccessRequest struct {
	// UserID 成员UserID。对应管理端的帐号
	UserID string `json:"userid"  validate:"required"`
}

type BatchDeleteUserRequest struct {
	// UserIDList 成员UserID列表。对应管理端的帐号。最多支持200个。若存在无效UserID，直接返回错误
	UserIDList []string `json:"useridlist"  validate:"required"`
}

type BatchGetByUserRequest struct {
	// UserIDList 企业成员的userid列表，字符串类型，最多支持100个
	UserIDList []string `json:"userid_list"  validate:"required"`
	// Cursor 用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填
	Cursor string `json:"cursor"  `
	// Limit 返回的最大记录数，整型，最大值100，默认值50，超过最大值时取最大值
	Limit int `json:"limit"  `
}

type BatchGetByUserResponse struct {
	// NextCursor 分页游标，再下次请求时填写以获取之后分页的记录，如果已经没有更多的数据则返回空
	NextCursor string `json:"next_cursor"  `

	ExternalContactList []BatchGetByUserResponseExternalContactList `json:"external_contact_list"  `
}

type BatchGetByUserResponseExternalContactList struct {
	// ExternalContact 客户的基本信息，可以参考获取客户详情
	ExternalContact ExternalContactResponse `json:"external_contact"  `
	// FollowInfo 企业成员客户跟进信息，可以参考获取客户详情，但标签信息只会返回企业标签和规则组标签的tag_id，个人标签将不再返回
	FollowInfo GetExternalContactResponseFollowUser `json:"follow_info"  `
}

type BatchGetResult struct {
	UserID       string `json:"userid"`
	ErrorCode    int    `json:"errcode"`
	ErrorMessage string `json:"errmsg"`
}

type BatchGetResultRequest struct {
	// JobID 异步任务id，最大长度为64字节
	JobID string `json:"jobid"  validate:"required"`
}

type BatchGetResultResponse struct {
	// Status 任务状态，整型，1表示任务开始，2表示任务进行中，3表示任务已完成
	Status int `json:"status"  `
	// Type 操作类型，字节串，目前分别有：1. sync_user(增量更新成员)  2. replace_user(全量覆盖成员)3. replace_party(全量覆盖部门)
	Type string `json:"type"  `
	// Total 任务运行总条数
	Total int `json:"total"  `
	// Percentage 目前运行百分比，当任务完成时为100
	Percentage int `json:"percentage"  `
	// Result 详细的处理结果，具体格式参考下面说明。当任务完成后此字段有效
	Result []BatchGetResult `json:"result"  `
}

type BatchInviteRequest struct {
	// User 成员ID列表, 最多支持1000个。
	User string `json:"user"  `
	// Party 部门ID列表，最多支持100个。
	Party string `json:"party"  `
	// Tag 标签ID列表，最多支持100个。
	Tag string `json:"tag"  `
}

type BatchInviteResponse struct {
	// InvalidUser 非法成员列表
	InvalidUser string `json:"invaliduser"  `
	// InvalidParty 非法部门列表
	InvalidParty string `json:"invalidparty"  `
	// InvalidTag 非法标签列表
	InvalidTag string `json:"invalidtag"  `
}

type BatchJobResultPushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// CreateTime 消息创建时间（整型）
	CreateTime int64 `xml:"CreateTime" json:"CreateTime"`
	// ErrCode 返回码
	ErrCode string `xml:"ErrCode" json:"ErrCode"`
	// ErrMsg 对返回码的文本描述内容
	ErrMsg string `xml:"ErrMsg" json:"ErrMsg"`
	// Event 事件类型：batch_job_result
	Event string `xml:"Event" json:"Event"`
	// FromUsername 成员UserID
	FromUsername string `xml:"FromUserName" json:"FromUserName"`
	// JobID 异步任务id，最大长度为64字符
	JobID string `xml:"JobId" json:"JobId"`
	// JobType 操作类型，字符串，目前分别有：sync_user(增量更新成员)、 replace_user(全量覆盖成员）、invite_user(邀请成员关注）、replace_party(全量覆盖部门)
	JobType string `xml:"JobType" json:"JobType"`
	// MsgType 消息类型，此时固定为：event
	MsgType string `xml:"MsgType" json:"MsgType"`
	// ToUsername 企业微信CorpID
	ToUsername string `xml:"ToUserName" json:"ToUserName"`
}

type BatchReplacePartyRequest struct {
	// MediaID 上传的csv文件的media_id
	MediaID string `json:"media_id"  validate:"required"`
	// Callback 回调信息。如填写该项则任务完成后，通过callback推送事件给企业。具体请参考应用回调模式中的相应选项
	Callback BatchSyncCallback `json:"callback"  `
}

type BatchReplacePartyResponse struct {
	// JobID 异步任务id，最大长度为64字节
	JobID string `json:"jobid"  `
}

type BatchReplaceUserRequest struct {
	// MediaID 上传的csv文件的media_id
	MediaID string `json:"media_id"  validate:"required"`
	// ToInvite 是否邀请新建的成员使用企业微信（将通过微信服务通知或短信或邮件下发邀请，每天自动下发一次，最多持续3个工作日），默认值为true。
	ToInvite bool `json:"to_invite"  `
	// Callback 回调信息。如填写该项则任务完成后，通过callback推送事件给企业。具体请参考应用回调模式中的相应选项
	Callback BatchSyncCallback `json:"callback"  `
}

type BatchReplaceUserResponse struct {
	// JobID 异步任务id，最大长度为64字节
	JobID string `json:"jobid"  `
}

type BatchSyncCallback struct {
	// URL 企业应用接收企业微信推送请求的访问协议和地址，支持http或https协议
	URL string `json:"url"`
	// Token 用于生成签名
	Token string `json:"token"`
	// EncodingAesKey 用于消息体的加密，是AES密钥的Base64编码
	EncodingAesKey string `json:"encodingaeskey"`
}

type BatchSyncUserRequest struct {
	// MediaID 上传的csv文件的media_id
	MediaID string `json:"media_id"  validate:"required"`
	// ToInvite 是否邀请新建的成员使用企业微信（将通过微信服务通知或短信或邮件下发邀请，每天自动下发一次，最多持续3个工作日），默认值为true。
	ToInvite bool `json:"to_invite"  `
	// Callback 回调信息。如填写该项则任务完成后，通过callback推送事件给企业。具体请参考应用回调模式中的相应选项
	Callback BatchSyncCallback `json:"callback"  `
}

type BatchSyncUserResponse struct {
	// JobID 异步任务id，最大长度为64字节
	JobID string `json:"jobid"  `
}

type CancelAuthPushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// AuthCorpID 授权方企业的corpid
	AuthCorpID string `xml:"AuthCorpId" json:"AuthCorpId"`
	// InfoType cancel_auth
	InfoType string `xml:"InfoType" json:"InfoType"`
	// SuiteID 第三方应用的SuiteId
	SuiteID string `xml:"SuiteId" json:"SuiteId"`
	// Timestamp 时间戳
	Timestamp int64 `xml:"TimeStamp" json:"TimeStamp"`
}

type ChangeAuthPushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// AuthCorpID 授权方的corpid
	AuthCorpID string `xml:"AuthCorpId" json:"AuthCorpId"`
	// InfoType change_auth
	InfoType string `xml:"InfoType" json:"InfoType"`
	// SuiteID 第三方应用的SuiteId
	SuiteID string `xml:"SuiteId" json:"SuiteId"`
	// Timestamp 时间戳
	Timestamp int64 `xml:"TimeStamp" json:"TimeStamp"`
}

type ChangeContactCreatePartyPushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// ChangeType 此时固定为create_party
	ChangeType string `xml:"ChangeType" json:"ChangeType"`
	// CreateTime 消息创建时间 （整型）
	CreateTime int64 `xml:"CreateTime" json:"CreateTime"`
	// Event 事件的类型，此时固定为change_contact
	Event string `xml:"Event" json:"Event"`
	// FromUsername 此事件该值固定为sys，表示该消息由系统生成
	FromUsername string `xml:"FromUserName" json:"FromUserName"`
	// ID 部门Id
	ID string `xml:"Id" json:"Id"`
	// MsgType 消息的类型，此时固定为event
	MsgType string `xml:"MsgType" json:"MsgType"`
	// Name 部门名称
	Name string `xml:"Name" json:"Name"`
	// Order 部门排序
	Order string `xml:"Order" json:"Order"`
	// ParentID 父部门id
	ParentID string `xml:"ParentId" json:"ParentId"`
	// ToUsername 企业微信CorpID
	ToUsername string `xml:"ToUserName" json:"ToUserName"`
}

type ChangeContactCreateUserPushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// AuthCorpID 授权企业的CorpID
	AuthCorpID string `xml:"AuthCorpId" json:"AuthCorpId"`
	// Avatar 头像url。注：如果要获取小图将url最后的”/0”改成”/100”即可，仅通讯录管理应用可获取
	Avatar string `xml:"Avatar" json:"Avatar"`
	// ChangeType 固定为create_user
	ChangeType string `xml:"ChangeType" json:"ChangeType"`
	// Department 更新后成员所在部门列表
	Department string `xml:"Department" json:"Department"`
	// Email 邮箱，仅通讯录管理应用可获取
	Email string `xml:"Email" json:"Email"`
	// EnglishName 英文名
	EnglishName string `xml:"EnglishName" json:"EnglishName"`
	// ExtAttr 扩展属性，仅通讯录管理应用可获取
	ExtAttr string `xml:"ExtAttr" json:"ExtAttr"`
	// Gender 性别。1表示男性，2表示女性
	Gender string `xml:"Gender" json:"Gender"`
	// InfoType 固定为change_contact
	InfoType string `xml:"InfoType" json:"InfoType"`
	// IsLeader 上级字段，标识是否为上级。0表示普通成员，1表示上级。仅通讯录管理应用可获取
	IsLeader string `xml:"IsLeader" json:"IsLeader"`
	// Mobile 手机号码，仅通讯录管理应用可获取
	Mobile string `xml:"Mobile" json:"Mobile"`
	// Name 成员名称
	Name string `xml:"Name" json:"Name"`
	// Position 职位信息。长度为0~64个字节，仅通讯录管理应用可获取
	Position string `xml:"Position" json:"Position"`
	// Status 激活状态：1=激活或关注， 2=禁用， 4=未激活 已激活代表已激活企业微信或已关注微工作台（原企业号）。未激活代表既未激活企业微信又未关注微工作台（原企业号）
	Status string `xml:"Status" json:"Status"`
	// SuiteID 第三方应用ID
	SuiteID string `xml:"SuiteId" json:"SuiteId"`
	// Telephone 座机，仅通讯录管理应用可获取
	Telephone string `xml:"Telephone" json:"Telephone"`
	// Timestamp 时间戳
	Timestamp int64 `xml:"TimeStamp" json:"TimeStamp"`
	// UserID 成员UserID
	UserID string `xml:"UserID" json:"UserID"`
}

type ChangeContactDeletePartyPushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// AuthCorpID 授权企业的CorpID
	AuthCorpID string `xml:"AuthCorpId" json:"AuthCorpId"`
	// ChangeType 固定为delete_party
	ChangeType string `xml:"ChangeType" json:"ChangeType"`
	// ID 部门Id
	ID string `xml:"Id" json:"Id"`
	// InfoType 固定为change_contact
	InfoType string `xml:"InfoType" json:"InfoType"`
	// SuiteID 第三方应用ID
	SuiteID string `xml:"SuiteId" json:"SuiteId"`
	// Timestamp 时间戳
	Timestamp int64 `xml:"TimeStamp" json:"TimeStamp"`
}

type ChangeContactDeleteUserPushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// AuthCorpID 授权企业的CorpID
	AuthCorpID string `xml:"AuthCorpId" json:"AuthCorpId"`
	// ChangeType 固定为delete_user
	ChangeType string `xml:"ChangeType" json:"ChangeType"`
	// InfoType 固定为change_contact
	InfoType string `xml:"InfoType" json:"InfoType"`
	// SuiteID 第三方应用ID
	SuiteID string `xml:"SuiteId" json:"SuiteId"`
	// Timestamp 时间戳
	Timestamp int64 `xml:"TimeStamp" json:"TimeStamp"`
	// UserID 变更信息的成员UserID
	UserID string `xml:"UserID" json:"UserID"`
}

type ChangeContactExtAttr struct {
	Item []ChangeContactExtAttrItem `xml:"Item"`
}

type ChangeContactExtAttrItem struct {
	Name  string `xml:"Name"`
	Value string `xml:"Value"`
}

type ChangeContactUpdatePartyPushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// AuthCorpID 授权企业的CorpID
	AuthCorpID string `xml:"AuthCorpId" json:"AuthCorpId"`
	// ChangeType 固定为update_party
	ChangeType string `xml:"ChangeType" json:"ChangeType"`
	// ID 部门Id
	ID string `xml:"Id" json:"Id"`
	// InfoType 固定为change_contact
	InfoType string `xml:"InfoType" json:"InfoType"`
	// Name 部门名称，仅当该字段发生变更时传递
	Name string `xml:"Name" json:"Name"`
	// ParentID 父部门id，仅当该字段发生变更时传递
	ParentID string `xml:"ParentId" json:"ParentId"`
	// SuiteID 第三方应用ID
	SuiteID string `xml:"SuiteId" json:"SuiteId"`
	// Timestamp 时间戳
	Timestamp int64 `xml:"TimeStamp" json:"TimeStamp"`
}

type ChangeContactUpdateTagPushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// AddPartyItems 标签中新增的部门id列表，用逗号分隔
	AddPartyItems string `xml:"AddPartyItems" json:"AddPartyItems"`
	// AddUserItems 标签中新增的成员userid列表，用逗号分隔
	AddUserItems string `xml:"AddUserItems" json:"AddUserItems"`
	// AuthCorpID 授权企业的CorpID
	AuthCorpID string `xml:"AuthCorpId" json:"AuthCorpId"`
	// ChangeType 固定为update_tag
	ChangeType string `xml:"ChangeType" json:"ChangeType"`
	// DelPartyItems 标签中删除的部门id列表，用逗号分隔
	DelPartyItems string `xml:"DelPartyItems" json:"DelPartyItems"`
	// DelUserItems 标签中删除的成员userid列表，用逗号分隔
	DelUserItems string `xml:"DelUserItems" json:"DelUserItems"`
	// InfoType 固定为change_contact
	InfoType string `xml:"InfoType" json:"InfoType"`
	// SuiteID 第三方应用ID
	SuiteID string `xml:"SuiteId" json:"SuiteId"`
	// TagID 标签Id
	TagID string `xml:"TagId" json:"TagId"`
	// Timestamp 时间戳
	Timestamp int64 `xml:"TimeStamp" json:"TimeStamp"`
}

type ChangeContactUpdateUserPushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// AuthCorpID 授权企业的CorpID
	AuthCorpID string `xml:"AuthCorpId" json:"AuthCorpId"`
	// Avatar 头像url。注：如果要获取小图将url最后的”/0”改成”/100”即可。变更时推送，仅通讯录管理应用可获取
	Avatar string `xml:"Avatar" json:"Avatar"`
	// ChangeType 固定为update_user
	ChangeType string `xml:"ChangeType" json:"ChangeType"`
	// Department 更新后成员所在部门列表
	Department string `xml:"Department" json:"Department"`
	// Email 邮箱，变更时推送 ，仅通讯录应用可获取
	Email string `xml:"Email" json:"Email"`
	// EnglishName 英文名
	EnglishName string `xml:"EnglishName" json:"EnglishName"`
	// ExtAttr 扩展属性，变更时推送，仅通讯录应用可获取
	ExtAttr string `xml:"ExtAttr" json:"ExtAttr"`
	// Gender 性别，变更时推送。1表示男性，2表示女性
	Gender string `xml:"Gender" json:"Gender"`
	// InfoType 固定为change_contact
	InfoType string `xml:"InfoType" json:"InfoType"`
	// IsLeader 上级字段，标识是否为上级。0表示普通成员，1表示上级。仅通讯录管理应用可获取
	IsLeader string `xml:"IsLeader" json:"IsLeader"`
	// Mobile 手机号码，变更时推送，仅通讯录应用可获取
	Mobile string `xml:"Mobile" json:"Mobile"`
	// Name 成员名称，变更时推送
	Name string `xml:"Name" json:"Name"`
	// NewUserID 新的UserID，变更时推送（userid由系统生成时可更改一次）
	NewUserID string `xml:"NewUserID" json:"NewUserID"`
	// Position 职位信息。长度为0~64个字节，仅通讯录管理应用可获取
	Position string `xml:"Position" json:"Position"`
	// Status 激活状态：1=激活或关注， 2=禁用， 4=未激活（重新启用未激活用户或者退出企业并且取消关注时触发）
	Status string `xml:"Status" json:"Status"`
	// SuiteID 第三方应用ID
	SuiteID string `xml:"SuiteId" json:"SuiteId"`
	// Telephone 座机，仅通讯录应用可获取
	Telephone string `xml:"Telephone" json:"Telephone"`
	// Timestamp 时间戳
	Timestamp int64 `xml:"TimeStamp" json:"TimeStamp"`
	// UserID 变更信息的成员UserID
	UserID string `xml:"UserID" json:"UserID"`
}

type ChangeExternalChatCreatePushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// AuthCorpID 授权企业的CorpID
	AuthCorpID string `xml:"AuthCorpId" json:"AuthCorpId"`
	// ChangeType 此时固定为create
	ChangeType string `xml:"ChangeType" json:"ChangeType"`
	// ChatID 群ID
	ChatID string `xml:"ChatId" json:"ChatId"`
	// InfoType 固定为change_external_chat
	InfoType string `xml:"InfoType" json:"InfoType"`
	// SuiteID 第三方应用ID
	SuiteID string `xml:"SuiteId" json:"SuiteId"`
	// Timestamp 时间戳
	Timestamp int64 `xml:"TimeStamp" json:"TimeStamp"`
}

type ChangeExternalChatDismissPushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// AuthCorpID 授权企业的CorpID
	AuthCorpID string `xml:"AuthCorpId" json:"AuthCorpId"`
	// ChangeType 此时固定为dismiss
	ChangeType string `xml:"ChangeType" json:"ChangeType"`
	// ChatID 群ID
	ChatID string `xml:"ChatId" json:"ChatId"`
	// InfoType 固定为change_external_chat
	InfoType string `xml:"InfoType" json:"InfoType"`
	// SuiteID 第三方应用ID
	SuiteID string `xml:"SuiteId" json:"SuiteId"`
	// Timestamp 时间戳
	Timestamp int64 `xml:"TimeStamp" json:"TimeStamp"`
}

type ChangeExternalChatUpdatePushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// AuthCorpID 授权企业的CorpID
	AuthCorpID string `xml:"AuthCorpId" json:"AuthCorpId"`
	// ChangeType 此时固定为update
	ChangeType string `xml:"ChangeType" json:"ChangeType"`
	// ChatID 群ID
	ChatID string `xml:"ChatId" json:"ChatId"`
	// InfoType 固定为change_external_chat
	InfoType string `xml:"InfoType" json:"InfoType"`
	// JoinScene 当是成员入群时有值。表示成员的入群方式0 - 由成员邀请入群（包括直接邀请入群和通过邀请链接入群）3 - 通过扫描群二维码入群
	JoinScene string `xml:"JoinScene" json:"JoinScene"`
	// MemChangeCnt 当是成员入群或退群时有值。表示成员变更数量
	MemChangeCnt string `xml:"MemChangeCnt" json:"MemChangeCnt"`
	// QuitScene 当是成员退群时有值。表示成员的退群方式0 - 自己退群1 - 群主/群管理员移出
	QuitScene string `xml:"QuitScene" json:"QuitScene"`
	// SuiteID 第三方应用ID
	SuiteID string `xml:"SuiteId" json:"SuiteId"`
	// Timestamp 时间戳
	Timestamp int64 `xml:"TimeStamp" json:"TimeStamp"`
	// UpdateDetail 变更详情。目前有以下几种：add_member : 成员入群del_member : 成员退群 change_owner : 群主变更change_name : 群名变更change_notice : 群公告变更
	UpdateDetail string `xml:"UpdateDetail" json:"UpdateDetail"`
}

type ChangeExternalContactAddExternalContactPushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// AuthCorpID 授权企业的CorpID
	AuthCorpID string `xml:"AuthCorpId" json:"AuthCorpId"`
	// ChangeType 此时固定为add_external_contact
	ChangeType string `xml:"ChangeType" json:"ChangeType"`
	// ExternalUserID 外部联系人的userid，注意不是企业成员的帐号
	ExternalUserID string `xml:"ExternalUserID" json:"ExternalUserID"`
	// InfoType 固定为change_external_contact
	InfoType string `xml:"InfoType" json:"InfoType"`
	// State 添加此用户的「联系我」方式配置的state参数，可用于识别添加此用户的渠道
	State string `xml:"State" json:"State"`
	// SuiteID 第三方应用ID
	SuiteID string `xml:"SuiteId" json:"SuiteId"`
	// Timestamp 时间戳
	Timestamp int64 `xml:"TimeStamp" json:"TimeStamp"`
	// UserID 企业服务人员的UserID
	UserID string `xml:"UserID" json:"UserID"`
	// WelcomeCode 欢迎语code，可用于发送欢迎语
	WelcomeCode string `xml:"WelcomeCode" json:"WelcomeCode"`
}

type ChangeExternalContactAddHalfExternalContactPushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// AuthCorpID 授权企业的CorpID
	AuthCorpID string `xml:"AuthCorpId" json:"AuthCorpId"`
	// ChangeType 此时固定为add_half_external_contact
	ChangeType string `xml:"ChangeType" json:"ChangeType"`
	// ExternalUserID 外部联系人的userid，注意不是企业成员的帐号
	ExternalUserID string `xml:"ExternalUserID" json:"ExternalUserID"`
	// InfoType 固定为change_external_contact
	InfoType string `xml:"InfoType" json:"InfoType"`
	// State 添加此用户的「联系我」方式配置的state参数，可用于识别添加此用户的渠道
	State string `xml:"State" json:"State"`
	// SuiteID 第三方应用ID
	SuiteID string `xml:"SuiteId" json:"SuiteId"`
	// Timestamp 时间戳
	Timestamp int64 `xml:"TimeStamp" json:"TimeStamp"`
	// UserID 企业服务人员的UserID
	UserID string `xml:"UserID" json:"UserID"`
	// WelcomeCode 欢迎语code，可用于发送欢迎语
	WelcomeCode string `xml:"WelcomeCode" json:"WelcomeCode"`
}

type ChangeExternalContactDelExternalContactPushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// AuthCorpID 授权企业的CorpID
	AuthCorpID string `xml:"AuthCorpId" json:"AuthCorpId"`
	// ChangeType 此时固定为del_external_contact
	ChangeType string `xml:"ChangeType" json:"ChangeType"`
	// ExternalUserID 外部联系人的userid，注意不是企业成员的帐号
	ExternalUserID string `xml:"ExternalUserID" json:"ExternalUserID"`
	// InfoType 固定为change_external_contact
	InfoType string `xml:"InfoType" json:"InfoType"`
	// SuiteID 第三方应用ID
	SuiteID string `xml:"SuiteId" json:"SuiteId"`
	// Timestamp 时间戳
	Timestamp int64 `xml:"TimeStamp" json:"TimeStamp"`
	// UserID 企业服务人员的UserID
	UserID string `xml:"UserID" json:"UserID"`
}

type ChangeExternalContactDelFollowUserPushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// AuthCorpID 授权企业的CorpID
	AuthCorpID string `xml:"AuthCorpId" json:"AuthCorpId"`
	// ChangeType 此时固定为del_follow_user
	ChangeType string `xml:"ChangeType" json:"ChangeType"`
	// ExternalUserID 外部联系人的userid，注意不是企业成员的帐号
	ExternalUserID string `xml:"ExternalUserID" json:"ExternalUserID"`
	// InfoType 固定为change_external_contact
	InfoType string `xml:"InfoType" json:"InfoType"`
	// SuiteID 第三方应用ID
	SuiteID string `xml:"SuiteId" json:"SuiteId"`
	// Timestamp 时间戳
	Timestamp int64 `xml:"TimeStamp" json:"TimeStamp"`
	// UserID 企业服务人员的UserID
	UserID string `xml:"UserID" json:"UserID"`
}

type ChangeExternalContactEditExternalContactPushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// AuthCorpID 授权企业的CorpID
	AuthCorpID string `xml:"AuthCorpId" json:"AuthCorpId"`
	// ChangeType 此时固定为edit_external_contact
	ChangeType string `xml:"ChangeType" json:"ChangeType"`
	// ExternalUserID 外部联系人的userid，注意不是企业成员的帐号
	ExternalUserID string `xml:"ExternalUserID" json:"ExternalUserID"`
	// InfoType 固定为change_external_contact
	InfoType string `xml:"InfoType" json:"InfoType"`
	// SuiteID 第三方应用ID
	SuiteID string `xml:"SuiteId" json:"SuiteId"`
	// Timestamp 时间戳
	Timestamp int64 `xml:"TimeStamp" json:"TimeStamp"`
	// UserID 企业服务人员的UserID
	UserID string `xml:"UserID" json:"UserID"`
}

type ChangeExternalContactMessageAuditApproved struct {
	XMLName        xml.Name `xml:"xml"`
	ToUserName     string   `xml:"ToUserName"`
	FromUserName   string   `xml:"FromUserName"`
	CreateTime     int64    `xml:"CreateTime"`
	MsgType        string   `xml:"MsgType"` // 固定为event
	Event          string   `xml:"Event"`
	ChangeType     string   `xml:"ChangeType"`
	UserID         string   `xml:"UserID"`         // 企业服务人员的UserID
	ExternalUserID string   `xml:"ExternalUserID"` // 外部联系人的userid，注意不是企业成员的帐号
	WelcomeCode    string   `xml:"WelcomeCode"`    // 欢迎语code，可用于发送欢迎语
}

type ChangeExternalContactTransferFailPushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// AuthCorpID 授权企业的CorpID
	AuthCorpID string `xml:"AuthCorpId" json:"AuthCorpId"`
	// ChangeType 此时固定为transfer_fail
	ChangeType string `xml:"ChangeType" json:"ChangeType"`
	// ExternalUserID 外部联系人的userid，注意不是企业成员的帐号
	ExternalUserID string `xml:"ExternalUserID" json:"ExternalUserID"`
	// FailReason 接替失败的原因, customer_refused-客户拒绝， customer_limit_exceed-接替成员的客户数达到上限
	FailReason string `xml:"FailReason" json:"FailReason"`
	// InfoType 固定为change_external_contact
	InfoType string `xml:"InfoType" json:"InfoType"`
	// SuiteID 第三方应用ID
	SuiteID string `xml:"SuiteId" json:"SuiteId"`
	// Timestamp 时间戳
	Timestamp int64 `xml:"TimeStamp" json:"TimeStamp"`
	// UserID 企业服务人员的UserID
	UserID string `xml:"UserID" json:"UserID"`
}

type ChangeExternalTagCreatePushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// AuthCorpID 授权企业的CorpID
	AuthCorpID string `xml:"AuthCorpId" json:"AuthCorpId"`
	// ChangeType 此时固定为create
	ChangeType string `xml:"ChangeType" json:"ChangeType"`
	// ID 标签或标签组的ID
	ID string `xml:"Id" json:"Id"`
	// InfoType 固定为change_external_tag
	InfoType string `xml:"InfoType" json:"InfoType"`
	// SuiteID 第三方应用ID
	SuiteID string `xml:"SuiteId" json:"SuiteId"`
	// TagType 创建标签时，此项为tag，创建标签组时，此项为tag_group
	TagType string `xml:"TagType" json:"TagType"`
	// Timestamp unix时间戳
	Timestamp int64 `xml:"TimeStamp" json:"TimeStamp"`
}

type ChangeExternalTagDeletePushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// AuthCorpID 授权企业的CorpID
	AuthCorpID string `xml:"AuthCorpId" json:"AuthCorpId"`
	// ChangeType 此时固定为delete
	ChangeType string `xml:"ChangeType" json:"ChangeType"`
	// ID 标签或标签组的ID
	ID string `xml:"Id" json:"Id"`
	// InfoType 固定为change_external_tag
	InfoType string `xml:"InfoType" json:"InfoType"`
	// SuiteID 第三方应用ID
	SuiteID string `xml:"SuiteId" json:"SuiteId"`
	// TagType 删除标签时，此项为tag，删除标签组时，此项为tag_group
	TagType string `xml:"TagType" json:"TagType"`
	// Timestamp unix时间戳
	Timestamp int64 `xml:"TimeStamp" json:"TimeStamp"`
}

type ChangeExternalTagUpdatePushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// AuthCorpID 授权企业的CorpID
	AuthCorpID string `xml:"AuthCorpId" json:"AuthCorpId"`
	// ChangeType 此时固定为update
	ChangeType string `xml:"ChangeType" json:"ChangeType"`
	// ID 标签或标签组的ID
	ID string `xml:"Id" json:"Id"`
	// InfoType 固定为change_external_tag
	InfoType string `xml:"InfoType" json:"InfoType"`
	// SuiteID 第三方应用ID
	SuiteID string `xml:"SuiteId" json:"SuiteId"`
	// TagType 变更标签时，此项为tag，变更标签组时，此项为tag_group
	TagType string `xml:"TagType" json:"TagType"`
	// Timestamp unix时间戳
	Timestamp int64 `xml:"TimeStamp" json:"TimeStamp"`
}

type ClickPushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// AgentID 企业应用的id，整型。可在应用的设置页面查看
	AgentID string `xml:"AgentID" json:"AgentID"`
	// CreateTime 消息创建时间（整型）
	CreateTime int64 `xml:"CreateTime" json:"CreateTime"`
	// Event 事件类型：click
	Event string `xml:"Event" json:"Event"`
	// EventKey 事件KEY值，与自定义菜单接口中KEY值对应
	EventKey string `xml:"EventKey" json:"EventKey"`
	// FromUsername 成员UserID
	FromUsername string `xml:"FromUserName" json:"FromUserName"`
	// MsgType 消息类型，此时固定为：event
	MsgType string `xml:"MsgType" json:"MsgType"`
	// ToUsername 企业微信CorpID
	ToUsername string `xml:"ToUserName" json:"ToUserName"`
}

type Client struct {
	Conf          Conf
	Request       req.Request
	TokenProvider TokenProvider
}

type CloseTempChatRequest struct {
	// UserID 企业成员的userid
	UserID string `json:"userid"  validate:"required"`
	// ExternalUserID 客户的外部联系人userid
	ExternalUserID string `json:"external_userid"  validate:"required"`
}

type CommonPushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`

	ToUsername   string `xml:"ToUserName,omitempty"`   // 企业微信CorpID
	FromUsername string `xml:"FromUserName,omitempty"` // sys 系统生成
	CreateTime   int64  `xml:"CreateTime,omitempty"`   // same as Timestamp
	MsgType      string `xml:"MsgType,omitempty"`      // event,text,image
	MsgID        int64  `xml:"MsgId,omitempty"`
	AgentID      int    `xml:"AgentID,omitempty"`
	Event        string `xml:"Event,omitempty"` // same as InfoType

	SuiteID       string `xml:"SuiteId,omitempty"`       // 第三方应用ID
	AuthCorpID    string `xml:"AuthCorpId,omitempty"`    // 授权企业的 CorpID
	ServiceCorpID string `xml:"ServiceCorpId,omitempty"` // 服务商 CorpID
	InfoType      string `xml:"InfoType,omitempty"`
	Timestamp     int64  `xml:"TimeStamp,omitempty"`

	ChangeType string `xml:"ChangeType,omitempty"`
}

type Conclusions struct {
	Text struct {
		Content string `json:"content"`
	} `json:"text"`
	Image struct {
		MediaID string `json:"media_id"`
		PicURL  string `json:"pic_url"`
	} `json:"image"`
	Link struct {
		Title  string `json:"title"`
		PicURL string `json:"picurl"`
		Desc   string `json:"desc"`
		URL    string `json:"url"`
	} `json:"link"`
	MiniProgram struct {
		Title      string `json:"title"`
		PicMediaID string `json:"pic_media_id"`
		AppID      string `json:"appid"`
		Page       string `json:"page"`
	} `json:"miniprogram"`
}

type Conf struct {
	CorpID                string // 企业 ID
	AgentID               int    // 应用 ID
	CorpSecret            string // 企业自建应用 secret
	ProviderSecret        string // 第三方 secret
	SuiteID               string // 第三方应用 ID
	SuiteSecret           string // 第三方应用 secret
	SuiteTicket           string // 第三方应用 ticket - 无法主动获取 - 会尝试从 Provider 获取
	AuthCorpID            string // 企业 ID
	AuthCorpPermanentCode string // 第三方企业永久授权码 - 会尝试从 Provider 获取

	TokenProvider TokenProvider `json:"-"`
}

type ConvertToOpenIDRequest struct {
	// UserID 企业内的成员id
	UserID string `json:"userid"  validate:"required"`
}

type ConvertToOpenIDResponse struct {
	// OpenID 企业微信成员userid对应的openid
	OpenID string `json:"openid"  `
}

type CreateAuthPushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// AuthCode 授权的auth_code,最长为512字节。用于获取企业的永久授权码。5分钟内有效
	AuthCode string `xml:"AuthCode" json:"AuthCode"`
	// InfoType create_auth
	InfoType string `xml:"InfoType" json:"InfoType"`
	// SuiteID 第三方应用的SuiteId
	SuiteID string `xml:"SuiteId" json:"SuiteId"`
	// Timestamp 时间戳
	Timestamp int64 `xml:"TimeStamp" json:"TimeStamp"`
}

type CreateDepartmentRequest struct {
	// Name 部门名称。同一个层级的部门名称不能重复。长度限制为1~32个字符，字符不能包括\:*?”<>｜
	Name string `json:"name"  validate:"required"`
	// NameEn 英文名称。同一个层级的部门名称不能重复。需要在管理后台开启多语言支持才能生效。长度限制为1~32个字符，字符不能包括\:*?”<>｜
	NameEn string `json:"name_en"  `
	// ParentID 父部门id，32位整型
	ParentID int `json:"parentid"  validate:"required"`
	// Order 在父部门中的次序值。order值大的排序靠前。有效的值范围是[0, 2^32)
	Order int `json:"order"  `
	// ID 部门id，32位整型，指定时必须大于1。若不填该参数，将自动生成id
	ID int `json:"id"  `
}

type CreateDepartmentResponse struct {
	// ID 创建的部门id
	ID int `json:"id"  `
}

type CreateTagRequest struct {
	// TagName 标签名称，长度限制为32个字以内（汉字或英文字母），标签名不可与其他标签重名。
	TagName string `json:"tagname"  validate:"required"`
	// TagID 标签id，非负整型，指定此参数时新增的标签会生成对应的标签id，不指定时则以目前最大的id自增。
	TagID int `json:"tagid"  `
}

type CreateTagResponse struct {
	// TagID 标签id
	TagID string `json:"tagid"  `
}

type CreateUserRequest struct {
	// UserID 成员UserID。对应管理端的帐号，企业内必须唯一。不区分大小写，长度为1~64个字节。只能由数字、字母和“_-@.”四种字符组成，且第一个字符必须是数字或字母。
	UserID string `json:"userid"  validate:"required"`
	// Name 成员名称。长度为1~64个utf8字符
	Name string `json:"name"  validate:"required"`
	// Alias 成员别名。长度1~32个utf8字符
	Alias string `json:"alias"  `
	// Mobile 手机号码。企业内必须唯一，mobile/email二者不能同时为空
	Mobile string `json:"mobile"  `
	// Department 成员所属部门id列表,不超过100个
	Department []int `json:"department"  validate:"required"`
	// Order 部门内的排序值，默认为0，成员次序以创建时间从小到大排列。个数必须和参数department的个数一致，数值越大排序越前面。有效的值范围是[0, 2^32)
	Order []int `json:"order"  `
	// Position 职务信息。长度为0~128个字符
	Position string `json:"position"  `
	// Gender 性别。1表示男性，2表示女性
	Gender string `json:"gender"  `
	// Email 邮箱。长度6~64个字节，且为有效的email格式。企业内必须唯一，mobile/email二者不能同时为空
	Email string `json:"email"  `
	// Telephone 座机。32字节以内，由纯数字、“-”、“+”或“,”组成。
	Telephone string `json:"telephone"  `
	// IsLeaderInDept 个数必须和参数department的个数一致，表示在所在的部门内是否为上级。1表示为上级，0表示非上级。在审批等应用里可以用来标识上级审批人
	IsLeaderInDept []int `json:"is_leader_in_dept"  `
	// AvatarMediaID 成员头像的mediaid，通过素材管理接口上传图片获得的mediaid
	AvatarMediaID string `json:"avatar_mediaid"  `
	// Enable 启用/禁用成员。1表示启用成员，0表示禁用成员
	Enable int `json:"enable"  `
	// ExtAttr 自定义字段。自定义字段需要先在WEB管理端添加，见扩展属性添加方法，否则忽略未知属性的赋值。与对外属性一致，不过只支持type=0的文本和type=1的网页类型，详细描述查看对外属性
	ExtAttr ExtAttrs `json:"extattr"  `
	// ToInvite 是否邀请该成员使用企业微信（将通过微信服务通知或短信或邮件下发邀请，每天自动下发一次，最多持续3个工作日），默认值为true。
	ToInvite bool `json:"to_invite"  `
	// ExternalProfile 成员对外属性，字段详情见对外属性
	ExternalProfile ExternalProfile `json:"external_profile"  `
	// ExternalPosition 对外职务，如果设置了该值，则以此作为对外展示的职务，否则以position来展示。长度12个汉字内
	ExternalPosition string `json:"external_position"  `
	// Nickname 视频号名字（设置后，成员将对外展示该视频号）。须从企业绑定到企业微信的视频号中选择，可在“我的企业”页中查看绑定的视频号
	Nickname string `json:"nickname"  `
	// Address 地址。长度最大128个字符
	Address string `json:"address"  `
	// MainDepartment 主部门
	MainDepartment int `json:"main_department"  `
}

type DeleteCalendarPushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// CalID 日历ID
	CalID string `xml:"CalId" json:"CalId"`
	// CreateTime 消息创建时间，unix时间戳
	CreateTime int64 `xml:"CreateTime" json:"CreateTime"`
	// Event 事件类型，此时固定为：delete_calendar
	Event string `xml:"Event" json:"Event"`
	// FromUsername 成员UserID
	FromUsername string `xml:"FromUserName" json:"FromUserName"`
	// MsgType 消息类型，此时固定为：event
	MsgType string `xml:"MsgType" json:"MsgType"`
	// ToUsername 企业微信CorpID
	ToUsername string `xml:"ToUserName" json:"ToUserName"`
}

type DeleteCalendarRequest struct {
	// CalenderID 日历ID
	CalenderID string `json:"cal_id"  validate:"required"`
}

type DeleteContactWayRequest struct {
	// ConfigID 企业联系方式的配置id
	ConfigID string `json:"config_id"  validate:"required"`
}

type DeleteCorpTagRequest struct {
	// TagID 标签的id列表
	TagID []string `json:"tag_id"  `
	// GroupID 标签组的id列表
	GroupID []string `json:"group_id"  `
	// AgentID 授权方安装的应用agentid。仅旧的第三方多应用套件需要填此参数
	AgentID int `json:"agentid"  `
}

type DeleteDepartmentRequest struct {
	// ID 部门id。（注：不能删除根部门；不能删除含有子部门、成员的部门）
	ID string `json:"id"  validate:"required"`
}

type DeleteGroupWelcomeTemplateRequest struct {
	// TemplateID 群欢迎语的素材id
	TemplateID string `json:"template_id"  validate:"required"`
	// AgentID 授权方安装的应用agentid。仅旧的第三方多应用套件需要填此参数
	AgentID int `json:"agentid"  `
}

type DeleteSchedulePushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// CalID 日历ID
	CalID string `xml:"CalId" json:"CalId"`
	// CreateTime 消息创建时间，unix时间戳
	CreateTime int64 `xml:"CreateTime" json:"CreateTime"`
	// Event 事件类型，此时固定为：delete_schedule
	Event string `xml:"Event" json:"Event"`
	// FromUsername 成员UserID
	FromUsername string `xml:"FromUserName" json:"FromUserName"`
	// MsgType 消息类型，此时固定为：event
	MsgType string `xml:"MsgType" json:"MsgType"`
	// ScheduleID 日程ID
	ScheduleID string `xml:"ScheduleId" json:"ScheduleId"`
	// ToUsername 企业微信CorpID
	ToUsername string `xml:"ToUserName" json:"ToUserName"`
}

type DeleteScheduleRequest struct {
	// ScheduleID 日程ID
	ScheduleID string `json:"schedule_id"  validate:"required"`
}

type DeleteTagRequest struct {
	// TagID 标签ID
	TagID string `json:"tagid"  validate:"required"`
}

type DeleteTagUsersRequest struct {
	// TagID 标签ID
	TagID int `json:"tagid"  validate:"required"`
	// UserList 企业成员ID列表，注意：userlist、partylist不能同时为空，单次请求长度不超过1000
	UserList []string `json:"userlist"  `
	// PartyList 企业部门ID列表，注意：userlist、partylist不能同时为空，单次请求长度不超过100
	PartyList []int `json:"partylist"  `
}

type DeleteTagUsersResponse struct {
	// InvalidList 非法的成员帐号列表
	InvalidList string `json:"invalidlist"  `
	// InvalidParty 非法的部门id列表
	InvalidParty string `json:"invalidparty"  `
}

type DeleteUserRequest struct {
	// UserID 成员UserID。对应管理端的帐号
	UserID string `json:"userid"  validate:"required"`
}

type EditCorpTagRequest struct {
	// ID 标签或标签组的id
	ID string `json:"id"  validate:"required"`
	// Name 新的标签或标签组名称，最长为30个字符
	Name string `json:"name"  `
	// Order 标签/标签组的次序值。order值大的排序靠前。有效的值范围是[0, 2^32)
	Order int `json:"order"  `
	// AgentID 授权方安装的应用agentid。仅旧的第三方多应用套件需要填此参数
	AgentID int `json:"agentid"  `
}

type EditGroupWelcomeTemplateRequest struct {
	// TemplateID 欢迎语素材id
	TemplateID string `json:"template_id"  validate:"required"`
	// AgentID 授权方安装的应用agentid。仅旧的第三方多应用套件需要填此参数
	AgentID int `json:"agentid"  `

	Text EditGroupWelcomeTemplateRequestText `json:"text"  `

	Image EditGroupWelcomeTemplateRequestImage `json:"image"  `

	Link EditGroupWelcomeTemplateRequestLink `json:"link"  `

	MiniProgram EditGroupWelcomeTemplateRequestMiniProgram `json:"miniprogram"  `

	File EditGroupWelcomeTemplateRequestFile `json:"file"  `

	Video EditGroupWelcomeTemplateRequestVideo `json:"video"  `
}

type EditGroupWelcomeTemplateRequestFile struct {
	// MediaID 文件id，可以通过素材管理接口获得
	MediaID string `json:"media_id"  validate:"required"`
}

type EditGroupWelcomeTemplateRequestImage struct {
	// MediaID 图片的media_id，可以通过素材管理接口获得
	MediaID string `json:"media_id"  `
	// PicURL 图片的链接，仅可使用上传图片接口得到的链接
	PicURL string `json:"pic_url"  `
}

type EditGroupWelcomeTemplateRequestLink struct {
	// Title 图文消息标题，最长为128字节
	Title string `json:"title"  validate:"required"`
	// PicURL 图文消息封面的url
	PicURL string `json:"picurl"  `
	// Desc 图文消息的描述，最长为512字节
	Desc string `json:"desc"  `
	// URL 图文消息的链接
	URL string `json:"url"  validate:"required"`
}

type EditGroupWelcomeTemplateRequestMiniProgram struct {
	// Title 小程序消息标题，最长为64字节
	Title string `json:"title"  validate:"required"`
	// PicMediaID 小程序消息封面的mediaid，封面图建议尺寸为520*416
	PicMediaID string `json:"pic_media_id"  validate:"required"`
	// AppID 小程序appid，必须是关联到企业的小程序应用
	AppID string `json:"appid"  validate:"required"`
	// Page 小程序page路径
	Page string `json:"page"  validate:"required"`
}

type EditGroupWelcomeTemplateRequestText struct {
	// Content 消息文本内容,最长为4000字节
	Content string `json:"content"  `
}

type EditGroupWelcomeTemplateRequestVideo struct {
	// MediaID 视频媒体文件id，可以通过素材管理接口获得
	MediaID string `json:"media_id"  validate:"required"`
}

type EncryptPushEvent struct {
	XMLName    xml.Name `xml:"xml"`
	ToUserName string   `xml:"ToUserName,omitempty"`
	Encrypt    string   `xml:"Encrypt,omitempty"`
	AgentID    string   `xml:"AgentID,omitempty"`
}

type EnterAgentPushEvent struct {
	XMLName xml.Name `xml:"xml" json:"-"`
	// AgentID 企业应用的id，整型。可在应用的设置页面查看
	AgentID string `xml:"AgentID" json:"AgentID"`
	// CreateTime 消息创建时间（整型）
	CreateTime int64 `xml:"CreateTime" json:"CreateTime"`
	// Event 事件类型：enter_agent
	Event string `xml:"Event" json:"Event"`
	// EventKey 事件KEY值，此事件该值为空
	EventKey string `xml:"EventKey" json:"EventKey"`
	// FromUsername 成员UserID
	FromUsername string `xml:"FromUserName" json:"FromUserName"`
	// MsgType 消息类型，此时固定为：event
	MsgType string `xml:"MsgType" json:"MsgType"`
	// ToUsername 企业微信CorpID
	ToUsername string `xml:"ToUserName" json:"ToUserName"`
}

type EventChangeModel interface {
	EventModel
	EventChangeType() string
}

type EventModel interface {
	EventType() string
}

type ExportDepartmentRequest struct {
	// EncodingAesKey base64encode的加密密钥，长度固定为43，加密方式采用aes-256-cbc方式
	EncodingAesKey string `json:"encoding_aeskey"  validate:"required"`
	// BlockSize 每块数据的部门数，支持范围[10^4,10^6]，默认值为10^6
	BlockSize int `json:"block_size"  `
}

type ExportDepartmentResponse struct {
	// JobID 任务ID，可通过获取导出结果接口查询任务结果
	JobID string `json:"jobid"  `
}

type ExportGetResultRequest struct {
	// JobID 导出任务接口成功后返回
	JobID string `json:"jobid"  validate:"required"`
}

type ExportGetResultResponse struct {
	// Status 任务状态:0-未处理，1-处理中，2-完成，3-异常失败
	Status string `json:"status"  `
	// DataList 数据文件列表
	DataList ExportGetResultResponseDataList `json:"data_list"  `
}

type ExportGetResultResponseDataList struct {
	// URL 数据下载链接,支持指定Range头部分段下载。有效期2个小时
	URL string `json:"url"  `
	// Size 密文数据大小
	Size int `json:"size"  `
	// Md5 密文数据md5
	Md5 string `json:"md5"  `
}

type ExportSimpleUserRequest struct {
	// EncodingAesKey base64encode的加密密钥，长度固定为43，加密方式采用aes-256-cbc方式
	EncodingAesKey string `json:"encoding_aeskey"  validate:"required"`
	// BlockSize 每块数据的人员数，支持范围[10^4,10^6]，默认值为10^6
	BlockSize int `json:"block_size"  `
}

type ExportSimpleUserResponse struct {
	// JobID 任务ID，可通过获取导出结果接口查询任务结果
	JobID string `json:"jobid"  `
}

type ExportTagUserRequest struct {
	// TagID 需要导出的标签
	TagID int `json:"tagid"  validate:"required"`
	// EncodingAesKey base64encode的加密密钥，长度固定为43，加密方式采用aes-256-cbc方式
	EncodingAesKey string `json:"encoding_aeskey"  validate:"required"`
	// BlockSize 每块数据的人员数和部门数之和，支持范围[10^4,10^6]，默认值为10^6
	BlockSize int `json:"block_size"  `
}

type ExportTagUserResponse struct {
	// JobID 任务ID，可通过获取导出结果接口查询任务结果
	JobID string `json:"jobid"  `
}

type ExportUserRequest struct {
	// EncodingAesKey base64encode的加密密钥，长度固定为43，加密方式采用aes-256-cbc方式
	EncodingAesKey string `json:"encoding_aeskey"  validate:"required"`
	// BlockSize 每块数据的人员数，支持范围[10^4,10^6]，默认值为10^6
	BlockSize int `json:"block_size"  `
}

type ExportUserResponse struct {
	// JobID 任务ID，可通过获取导出结果接口查询任务结果
	JobID string `json:"jobid"  `
}

type ExtAttr struct {
	// Type 0 文本, 1 网页, 2 小程序
	Type int    `json:"type,omitempty"`
	Name string `json:"name,omitempty"`
	Text struct {
		Value string `json:"value,omitempty"`
	} `json:"text,omitempty"`
	Web struct {
		URL   string `json:"url,omitempty"`
		Title string `json:"title,omitempty"`
	} `json:"web,omitempty"`
	MiniProgram struct {
		AppID    string `json:"appid,omitempty"`
		PagePath string `json:"pagepath,omitempty"`
		Title    string `json:"title,omitempty"`
	} `json:"miniprogram,omitempty"`
}

type ExtAttrs struct {
	Attrs []ExtAttr `json:"attrs"`
}

type ExternalContactAddWay int

type ExternalContactGroupChatStatusType int

type ExternalContactProfileResponse struct {
	ExternalAttr []ExtAttr `json:"external_attr"`
}

type ExternalContactResponse struct {
	// ExternalUserID 外部联系人的userid
	ExternalUserID string `json:"external_userid"`
	// Name 外部联系人的名称[注1]
	Name string `json:"name"`
	// Avatar 外部联系人头像，代开发自建应用需要管理员授权才可以获取，第三方不可获取
	Avatar string `json:"avatar"`
	// Type 外部联系人的类型，1表示该外部联系人是微信用户，2表示该外部联系人是企业微信用户
	Type int `json:"type"`
	// Gender 外部联系人性别 0-未知 1-男性 2-女性
	Gender int `json:"gender"`
	// UnionID 外部联系人在微信开放平台的唯一身份标识（微信unionid），通过此字段企业可将外部联系人与公众号/小程序用户关联起来。仅当联系人类型是微信用户，且企业或第三方服务商绑定了微信开发者ID有此字段。查看绑定方法
	UnionID string `json:"unionid"`
	// Position 外部联系人的职位，如果外部企业或用户选择隐藏职位，则不返回，仅当联系人类型是企业微信用户时有此字段
	Position string `json:"position"`
	// CorpName 外部联系人所在企业的简称，仅当联系人类型是企业微信用户时有此字段
	CorpName string `json:"corp_name"`
	// CorpFullName 外部联系人所在企业的主体名称，仅当联系人类型是企业微信用户时有此字段
	CorpFullName string `json:"corp_full_name"`
	// ExternalProfile 外部联系人的自定义展示信息，可以有多个字段和多种类型，包括文本，网页和小程序，仅当联系人类型是企业微信用户时有此字段，字段详情见对外属性；
	ExternalProfile ExternalProfile `json:"external_profile"`
}

type ExternalContactSourceType int

type ExternalContactType int

type ExternalProfile struct {
	// ExternalCorpName 企业对外简称，需从已认证的企业简称中选填。可在“我的企业”页中查看企业简称认证状态。
	ExternalCorpName string `json:"external_corp_name,omitempty"`
	// WechatChannels 视频号属性
	WechatChannels struct {
		// Nickname 视频号名字（设置后，成员将对外展示该视频号）
		Nickname string `json:"nickname,omitempty"`
		// Status 对外展示视频号状态。0表示企业视频号已被确认，可正常使用，1表示企业视频号待确认
		Status int `json:"status,omitempty"`
	} `json:"wechat_channels,omitempty"`
	ExternalAttr []ExtAttr `json:"external_attr,omitempty"`
}

type GenericResponse struct {
	ErrorCode    int    `json:"errcode"`
	ErrorMessage string `json:"errmsg"`
}

type GenericToken struct {
	Type      string `json:",omitempty"` //
	OwnerID   string `json:",omitempty"` // if owner change, this token become invalid
	Depends   string `json:",omitempty"` // extra depends
	Secret    string `json:",omitempty"` // secret content
	ExpiresIn int    `json:",omitempty"` // valid in seconds - 0 means no expire
	ExpiresAt int64  `json:",omitempty"` // expires unix timestamp
}

type GetActiveStatRequest struct {
	// Date 具体某天的活跃人数，最长支持获取30天前数据
	Date string `json:"date"  validate:"required"`
}

type GetActiveStatResponse struct {
	// ActiveCount 活跃成员数
	ActiveCount int `json:"active_cnt"  `
}

type GetAdminListItem struct {
	// UserID 管理员的userid
	UserID string `json:"userid"`
	// OpenUserID 管理员的open_userid
	OpenUserID string `json:"open_userid"`
	// AuthType 该管理员对应用的权限：0=发消息权限，1=管理权限
	AuthType int `json:"auth_type"`
}

type GetAgentAllowParties struct {
	PartyIDs []int `json:"partyid"`
}

type GetAgentAllowTags struct {
	TagIDs []int `json:"tagid"`
}

type GetAgentAllowUserInfos struct {
	Users []struct {
		UserID string `json:"userid"`
	} `json:"user"`
}

type GetAgentRequest struct {
	// AgentID 应用id
	AgentID int `json:"agentid"  validate:"required"`
}

type GetAgentResponse struct {
	// AgentID 企业应用id
	AgentID int `json:"agentid"  `
	// Name 企业应用名称
	Name string `json:"name"  `
	// SquareLogoURL 企业应用方形头像
	SquareLogoURL string `json:"square_logo_url"  `
	// Description 企业应用详情
	Description string `json:"description"  `
	// AllowUserInfos 企业应用可见范围（人员），其中包括userid
	AllowUserInfos GetAgentAllowUserInfos `json:"allow_userinfos"  `
	// AllowParties 企业应用可见范围（部门）
	AllowParties GetAgentAllowParties `json:"allow_partys"  `
	// AllowTags 企业应用可见范围（标签）
	AllowTags GetAgentAllowTags `json:"allow_tags"  `
	// Close 企业应用是否被停用
	Close int `json:"close"  `
	// RedirectDomain 企业应用可信域名
	RedirectDomain string `json:"redirect_domain"  `
	// ReportLocationFlag 企业应用是否打开地理位置上报 0：不上报；1：进入会话上报；
	ReportLocationFlag int `json:"report_location_flag"  `
	// IsReportEnter 是否上报用户进入应用事件。0：不接收；1：接收
	IsReportEnter int `json:"isreportenter"  `
	// HomeURL 应用主页url
	HomeURL string `json:"home_url"  `
}

type GetCalendarRequest struct {
	// CalenderIDList 日历ID列表，调用创建日历接口后获得。一次最多可获取1000条
	CalenderIDList []string `json:"cal_id_list"  validate:"required"`
}

type GetCalendarResponse struct {
	// CalendarList 日历列表
	CalendarList []GetCalendarResponseItem `json:"calendar_list"  `
}

type GetCalendarResponseItem struct {
	// CalID 日历ID
	CalID string `json:"cal_id"  `
	// Organizer 指定的组织者userid
	Organizer string `json:"organizer"  `
	// Readonly 日历组织者对日历是否只读权限。0-否；1-是；
	Readonly int `json:"readonly"  `
	// Summary 日历标题。1 ~ 128 字符
	Summary string `json:"summary"  `
	// Color 日历颜色，RGB颜色编码16进制表示，例如：”#0000FF” 表示纯蓝色
	Color string `json:"color"  `
	// Description 日历描述。0 ~ 512 字符
	Description string `json:"description"  `
	// Shares 日历共享成员列表。最多2000人
	Shares []GetCalendarResponseShares `json:"shares"  `
}

type GetCalendarResponseShares struct {
	// UserID 日历共享成员的id
	UserID string `json:"userid"  `
	// Readonly 共享成员对日历是否只读权限。0-否；1-是；
	Readonly int `json:"readonly"  `
}

type GetContactWayRequest struct {
	// ConfigID 联系方式的配置id
	ConfigID string `json:"config_id"  validate:"required"`
}

type GetContactWayResponse struct {
	// ConfigID 新增联系方式的配置id
	ConfigID string `json:"config_id"  `
	// Type 联系方式类型，1-单人，2-多人
	Type string `json:"type"  `
	// Scene 场景，1-在小程序中联系，2-通过二维码联系
	Scene string `json:"scene"  `
	// IsTemp 是否临时会话模式，默认为false，true表示使用临时会话模式
	IsTemp string `json:"is_temp"  `
	// Remark 联系方式的备注信息，用于助记
	Remark string `json:"remark"  `
	// SkipVerify 外部客户添加时是否无需验证
	SkipVerify string `json:"skip_verify"  `
	// State 企业自定义的state参数，用于区分不同的添加渠道，在调用“获取外部联系人详情”时会返回该参数值
	State string `json:"state"  `
	// Style 小程序中联系按钮的样式，仅在scene为1时返回，详见附录
	Style string `json:"style"  `
	// QrCode 联系二维码的URL，仅在scene为2时返回
	QrCode string `json:"qr_code"  `
	// User 使用该联系方式的用户userID列表
	User string `json:"user"  `
	// Party 使用该联系方式的部门id列表
	Party string `json:"party"  `
	// ExpiresIn 临时会话二维码有效期，以秒为单位
	ExpiresIn string `json:"expires_in"  `
	// ChatExpiresIn 临时会话有效期，以秒为单位
	ChatExpiresIn string `json:"chat_expires_in"  `
	// UnionID 可进行临时会话的客户unionid
	UnionID string `json:"unionid"  `
	// Conclusions 结束语，可参考“结束语定义”
	Conclusions string `json:"conclusions"  `
}

type GetCorpTagListRequest struct {
	// TagID 要查询的标签id
	TagID []string `json:"tag_id"  `
	// GroupID 要查询的标签组id，返回该标签组以及其下的所有标签信息
	GroupID []string `json:"group_id"  `
}

type GetCorpTagListResponse struct {
	// TagGroup 标签组列表
	TagGroup []GetCorpTagListResponseTagGroup `json:"tag_group"  `
}

type GetCorpTagListResponseTagGroup struct {
	// GroupID 标签组id
	GroupID string `json:"group_id"  `
	// GroupName 标签组名称
	GroupName string `json:"group_name"  `
	// CreateTime 标签组创建时间
	CreateTime int `json:"create_time"  `
	// Order 标签组排序的次序值，order值大的排序靠前。有效的值范围是[0, 2^32)
	Order int `json:"order"  `
	// Deleted 标签组是否已经被删除，只在指定tag_id进行查询时返回
	Deleted bool `json:"deleted"  `
	// Tag 标签组内的标签列表
	Tag []GetCorpTagListResponseTagGroupTag `json:"tag"  `
}

type GetCorpTagListResponseTagGroupTag struct {
	// ID 标签id
	ID string `json:"id"  `
	// Name 标签名称
	Name string `json:"name"  `
	// CreateTime 标签创建时间
	CreateTime int `json:"create_time"  `
	// Order 标签排序的次序值，order值大的排序靠前。有效的值范围是[0, 2^32)
	Order int `json:"order"  `
	// Deleted 标签是否已经被删除，只在指定tag_id/group_id进行查询时返回
	Deleted bool `json:"deleted"  `
}

type GetExternalContactRequest struct {
	// ExternalUserID 外部联系人的userid，注意不是企业成员的帐号
	ExternalUserID string `json:"external_userid"  validate:"required"`
	// Cursor 上次请求返回的next_cursor
	Cursor string `json:"cursor"  `
}

type GetExternalContactResponse struct {
	// NextCursor 分页的cursor，当跟进人多于500人时返回
	NextCursor string `json:"next_cursor"  `

	FollowUser []GetExternalContactResponseFollowUser `json:"follow_user"  `

	ExternalContact ExternalContactResponse `json:"external_contact"  `
}

type GetExternalContactResponseFollowUser struct {
	// UserID 添加了此外部联系人的企业成员userid
	UserID string `json:"userid"  `
	// Remark 该成员对此外部联系人的备注
	Remark string `json:"remark"  `
	// Description 该成员对此外部联系人的描述
	Description string `json:"description"  `
	// CreateTime 该成员添加此外部联系人的时间
	CreateTime int `json:"createtime"  `
	// RemarkCorpName 该成员对此客户备注的企业名称
	RemarkCorpName string `json:"remark_corp_name"  `
	// RemarkMobiles 该成员对此客户备注的手机号码，代开发自建应用需要管理员授权才可以获取，第三方不可获取
	RemarkMobiles []string `json:"remark_mobiles"  `
	// AddWay 该成员添加此客户的来源，具体含义详见来源定义
	AddWay int `json:"add_way"  `
	// OperUserID 发起添加的userid，如果成员主动添加，为成员的userid；如果是客户主动添加，则为客户的外部联系人userid；如果是内部成员共享/管理员分配，则为对应的成员/管理员userid
	OperUserID string `json:"oper_userid"  `
	// State 企业自定义的state参数，用于区分客户具体是通过哪个「联系我」添加，由企业通过创建「联系我」方式指定
	State string `json:"state"  `

	Tags []GetExternalContactResponseFollowUserTags `json:"tags"  `
}

type GetExternalContactResponseFollowUserTags struct {
	// GroupName 该成员添加此外部联系人所打标签的分组名称（标签功能需要企业微信升级到2.7.5及以上版本）
	GroupName string `json:"group_name"  `
	// TagName 该成员添加此外部联系人所打标签名称
	TagName string `json:"tag_name"  `
	// Type 该成员添加此外部联系人所打标签类型, 1-企业设置，2-用户自定义，3-规则组标签（仅系统应用返回）
	Type int `json:"type"  `
	// TagID 该成员添加此外部联系人所打企业标签的id，用户自定义类型标签（type=2）不返回
	TagID string `json:"tag_id"  `
}