externalcontact

type AddContactWayRequest struct {
	Type          int                `json:"type"`
	Scene         int                `json:"scene"`
	Style         int                `json:"style"`
	Remark        string             `json:"remark"`
	SkipVerify    bool               `json:"skip_verify"`
	State         string             `json:"state"`
	User          []string           `json:"user"`
	Party         []int              `json:"party"`
	IsTemp        bool               `json:"is_temp"`
	ExpiresIn     int                `json:"expires_in"`
	ChatExpiresIn int                `json:"chat_expires_in"`
	UnionID       string             `json:"unionid"`
	Conclusions   ConclusionsRequest `json:"conclusions"`
}

type AddContactWayResponse struct {
	util.CommonError
	ConfigID string `json:"config_id"`
	QrCode   string `json:"qr_code"`
}

type AddCropTagItem struct {
	Name  string `json:"name"`
	Order int    `json:"order"`
}

type AddCropTagRequest struct {
	GroupID   string           `json:"group_id,omitempty"`
	GroupName string           `json:"group_name"`
	Order     int              `json:"order"`
	Tag       []AddCropTagItem `json:"tag"`
	AgentID   int              `json:"agentid"`
}

type AddCropTagResponse struct {
	util.CommonError
	TagGroup TagGroup `json:"tag_group"`
}

type AddGroupWelcomeTemplateRequest struct {
	Text        MsgText               `json:"text"`
	Image       AttachmentImg         `json:"image"`
	Link        AttachmentLink        `json:"link"`
	MiniProgram AttachmentMiniProgram `json:"miniprogram"`
	File        AttachmentFile        `json:"file"`
	Video       AttachmentVideo       `json:"video"`
	AgentID     int                   `json:"agentid"`
	Notify      int                   `json:"notify"`
}

type AddGroupWelcomeTemplateResponse struct {
	util.CommonError
	TemplateID string `json:"template_id"`
}

type AddJoinWayRequest struct {
	Scene          int      `json:"scene"`            // 必填 1 - 群的小程序插件,2 - 群的二维码插件
	Remark         string   `json:"remark"`           //非必填	联系方式的备注信息，用于助记，超过30个字符将被截断
	AutoCreateRoom int      `json:"auto_create_room"` //非必填	当群满了后，是否自动新建群。0-否；1-是。 默认为1
	RoomBaseName   string   `json:"room_base_name"`   //非必填	自动建群的群名前缀，当auto_create_room为1时有效。最长40个utf8字符
	RoomBaseID     int      `json:"room_base_id"`     //非必填	自动建群的群起始序号，当auto_create_room为1时有效
	ChatIDList     []string `json:"chat_id_list"`     //必填	使用该配置的客户群ID列表，支持5个。见客户群ID获取方法
	State          string   `json:"state"`            //非必填	企业自定义的state参数，用于区分不同的入群渠道。不超过30个UTF-8字符
}

type AddJoinWayResponse struct {
	util.CommonError
	ConfigID string `json:"config_id"`
}

type AddMsgTemplateRequest struct {
	ChatType       string        `json:"chat_type"`
	ExternalUserID []string      `json:"external_userid"`
	Sender         string        `json:"sender,omitempty"`
	Text           MsgText       `json:"text"`
	Attachments    []*Attachment `json:"attachments"`
}

type AddMsgTemplateResponse struct {
	util.CommonError
	FailList []string `json:"fail_list"`
	MsgID    string   `json:"msgid"`
}

type Attachment struct {
	MsgType     string                `json:"msgtype"`
	Image       AttachmentImg         `json:"image,omitempty"`
	Link        AttachmentLink        `json:"link,omitempty"`
	MiniProgram AttachmentMiniProgram `json:"miniprogram,omitempty"`
	Video       AttachmentVideo       `json:"video,omitempty"`
	File        AttachmentFile        `json:"file,omitempty"`
}

type AttachmentFile struct {
	MediaID string `json:"media_id"`
}

type AttachmentImg struct {
	MediaID string `json:"media_id"`
	PicURL  string `json:"pic_url"`
}

type AttachmentLink struct {
	Title  string `json:"title"`
	PicURL string `json:"picurl"`
	Desc   string `json:"desc"`
	URL    string `json:"url"`
}

type AttachmentMiniProgram struct {
	Title      string `json:"title"`
	PicMediaID string `json:"pic_media_id"`
	AppID      string `json:"appid"`
	Page       string `json:"page"`
}

type AttachmentVideo struct {
	MediaID string `json:"media_id"`
}

type BatchGetExternalUserDetailsRequest struct {
	UserIDList []string `json:"userid_list"`
	Cursor     string   `json:"cursor"`
}

type BehaviorData struct {
	StatTime            int     `json:"stat_time"`
	ChatCnt             int     `json:"chat_cnt"`
	MessageCnt          int     `json:"message_cnt"`
	ReplyPercentage     float64 `json:"reply_percentage"`
	AvgReplyTime        int     `json:"avg_reply_time"`
	NegativeFeedbackCnt int     `json:"negative_feedback_cnt"`
	NewApplyCnt         int     `json:"new_apply_cnt"`
	NewContactCnt       int     `json:"new_contact_cnt"`
}

type Client struct {
	*context.Context
}

type ConclusionsImageRequest struct {
	MediaID string `json:"media_id"`
}

type ConclusionsImageResponse struct {
	PicURL string `json:"pic_url"`
}

type ConclusionsLink struct {
	Title  string `json:"title"`
	PicURL string `json:"picurl"`
	Desc   string `json:"desc"`
	URL    string `json:"url"`
}

type ConclusionsMiniProgram struct {
	Title      string `json:"title"`
	PicMediaID string `json:"pic_media_id"`
	AppID      string `json:"appid"`
	Page       string `json:"page"`
}

type ConclusionsRequest struct {
	Text        ConclusionsText         `json:"text"`
	Image       ConclusionsImageRequest `json:"image"`
	Link        ConclusionsLink         `json:"link"`
	MiniProgram ConclusionsMiniProgram  `json:"miniprogram"`
}

type ConclusionsResponse struct {
	Text        ConclusionsText          `json:"text"`
	Image       ConclusionsImageResponse `json:"image"`
	Link        ConclusionsLink          `json:"link"`
	MiniProgram ConclusionsMiniProgram   `json:"miniprogram"`
}

type ConclusionsText struct {
	Content string `json:"content"`
}

type ContactWay struct {
	ConfigID      string              `json:"config_id"`
	Type          int                 `json:"type"`
	Scene         int                 `json:"scene"`
	Style         int                 `json:"style"`
	Remark        string              `json:"remark"`
	SkipVerify    bool                `json:"skip_verify"`
	State         string              `json:"state"`
	QrCode        string              `json:"qr_code"`
	User          []string            `json:"user"`
	Party         []int               `json:"party"`
	IsTemp        bool                `json:"is_temp"`
	ExpiresIn     int                 `json:"expires_in"`
	ChatExpiresIn int                 `json:"chat_expires_in"`
	UnionID       string              `json:"unionid"`
	Conclusions   ConclusionsResponse `json:"conclusions"`
}

type ContactWayForList struct {
	ConfigID string `json:"config_id"`
}

type DelContactWayRequest struct {
	ConfigID string `json:"config_id"`
}

type DelContactWayResponse struct {
	util.CommonError
}

type DelGroupWelcomeTemplateRequest struct {
	TemplateID string `json:"template_id"`
	AgentID    int    `json:"agentid"`
}

type DelGroupWelcomeTemplateResponse struct {
	util.CommonError
}

type DeleteCropTagRequest struct {
	TagID   []string `json:"tag_id"`
	GroupID []string `json:"group_id"`
	AgentID string   `json:"agent_id"`
}

type EditCropTagRequest struct {
	ID      string `json:"id"`
	Name    string `json:"name"`
	Order   int    `json:"order"`
	AgentID string `json:"agent_id"`
}

type EditGroupWelcomeTemplateRequest struct {
	TemplateID  string                `json:"template_id"`
	Text        MsgText               `json:"text"`
	Image       AttachmentImg         `json:"image"`
	Link        AttachmentLink        `json:"link"`
	MiniProgram AttachmentMiniProgram `json:"miniprogram"`
	File        AttachmentFile        `json:"file"`
	Video       AttachmentVideo       `json:"video"`
	AgentID     int                   `json:"agentid"`
}

type EditGroupWelcomeTemplateResponse struct {
	util.CommonError
}

type EventCallbackMessage struct {
	ToUserName     string `json:"to_user_name"`
	FromUserName   string `json:"from_user_name"`
	CreateTime     int64  `json:"create_time"`
	MsgType        string `json:"msg_type"`
	Event          string `json:"event"`
	ChangeType     string `json:"change_type"`
	UserID         string `json:"user_id"`
	ExternalUserID string `json:"external_user_id"`
	State          string `json:"state"`
	WelcomeCode    string `json:"welcome_code"`
}

type ExternalContact struct {
	ExternalUserID  string `json:"external_userid"`
	Name            string `json:"name"`
	Position        string `json:"position"`
	Avatar          string `json:"avatar"`
	CorpName        string `json:"corp_name"`
	CorpFullName    string `json:"corp_full_name"`
	Type            int64  `json:"type"`
	Gender          int64  `json:"gender"`
	UnionID         string `json:"unionid"`
	ExternalProfile string `json:"external_profile"`
}

type ExternalUser struct {
	ExternalUserID  string `json:"external_userid"`
	Name            string `json:"name"`
	Avatar          string `json:"avatar"`
	Type            int64  `json:"type"`
	Gender          int64  `json:"gender"`
	UnionID         string `json:"unionid"`
	Position        string `json:"position"`
	CorpName        string `json:"corp_name"`
	CorpFullName    string `json:"corp_full_name"`
	ExternalProfile string `json:"external_profile"`
}

type ExternalUserDetailListResponse struct {
	util.CommonError
	ExternalContactList []ExternalUserForBatch `json:"external_contact_list"`
}

type ExternalUserDetailResponse struct {
	util.CommonError
	ExternalContact ExternalUser `json:"external_contact"`
	FollowUser      []FollowUser `json:"follow_user"`
	NextCursor      string       `json:"next_cursor"`
}

type ExternalUserForBatch struct {
	ExternalContact ExternalContact `json:"external_contact"`
	FollowInfo      FollowInfo      `json:"follow_info"`
}

type ExternalUserListResponse struct {
	util.CommonError
	ExternalUserID []string `json:"external_userid"`
}

type FollowInfo struct {
	UserID         string        `json:"userid"`
	Remark         string        `json:"remark"`
	Description    string        `json:"description"`
	CreateTime     int           `json:"create_time"`
	TagID          []string      `json:"tag_id"`
	RemarkCorpName string        `json:"remark_corp_name"`
	RemarkMobiles  []string      `json:"remark_mobiles"`
	OperUserID     string        `json:"oper_userid"`
	AddWay         int64         `json:"add_way"`
	WeChatChannels WechatChannel `json:"wechat_channels"`
}

type FollowUser struct {
	UserID         string        `json:"userid"`
	Remark         string        `json:"remark"`
	Description    string        `json:"description"`
	CreateTime     string        `json:"create_time"`
	Tags           []Tag         `json:"tags"`
	RemarkCorpName string        `json:"remark_corp_name"`
	RemarkMobiles  []string      `json:"remark_mobiles"`
	OperUserID     string        `json:"oper_userid"`
	AddWay         int64         `json:"add_way"`
	WeChatChannels WechatChannel `json:"wechat_channels"`
	State          string        `json:"state"`
}

type GetContactWayRequest struct {
	ConfigID string `json:"config_id"`
}

type GetContactWayResponse struct {
	util.CommonError
	ContactWay ContactWay `json:"contact_way"`
}

type GetCropTagListResponse struct {
	util.CommonError
	TagGroup []TagGroup `json:"tag_group"`
}

type GetCropTagRequest struct {
	TagID   []string `json:"tag_id"`
	GroupID []string `json:"group_id"`
}

type GetGroupChatStatByDayItem struct {
	StatTime int                   `json:"stat_time"`
	Data     GroupChatStatItemData `json:"data"`
}

type GetGroupChatStatByDayRequest struct {
	DayBeginTime int         `json:"day_begin_time"`
	DayEndTime   int         `json:"day_end_time"`
	OwnerFilter  OwnerFilter `json:"owner_filter"`
}

type GetGroupChatStatByDayResponse struct {
	util.CommonError
	Items []GetGroupChatStatByDayItem `json:"items"`
}

type GetGroupChatStatRequest struct {
	DayBeginTime int         `json:"day_begin_time"`
	DayEndTime   int         `json:"day_end_time"`
	OwnerFilter  OwnerFilter `json:"owner_filter"`
	OrderBy      int         `json:"order_by"`
	OrderAsc     int         `json:"order_asc"`
	Offset       int         `json:"offset"`
	Limit        int         `json:"limit"`
}

type GetGroupChatStatResponse struct {
	util.CommonError
	Total      int                 `json:"total"`
	NextOffset int                 `json:"next_offset"`
	Items      []GroupChatStatItem `json:"items"`
}

type GetGroupMsgListV2Request struct {
	ChatType   string `json:"chat_type"`
	StartTime  int    `json:"start_time"`
	EndTime    int    `json:"end_time"`
	Creator    string `json:"creator,omitempty"`
	FilterType int    `json:"filter_type"`
	Limit      int    `json:"limit"`
	Cursor     string `json:"cursor"`
}

type GetGroupMsgListV2Response struct {
	util.CommonError
	NextCursor   string      `json:"next_cursor"`
	GroupMsgList []*GroupMsg `json:"group_msg_list"`
}

type GetGroupMsgSendResultRequest struct {
	MsgID  string `json:"msgid"`
	UserID string `json:"userid"`
	Limit  int    `json:"limit"`
	Cursor string `json:"cursor"`
}

type GetGroupMsgSendResultResponse struct {
	util.CommonError
	NextCursor string  `json:"next_cursor"`
	SendList   []*Send `json:"send_list"`
}

type GetGroupMsgTaskRequest struct {
	MsgID  string `json:"msgid"`
	Limit  int    `json:"limit"`
	Cursor string `json:"cursor"`
}

type GetGroupMsgTaskResponse struct {
	util.CommonError
	NextCursor string  `json:"next_cursor"`
	TaskList   []*Task `json:"task_list"`
}

type GetGroupWelcomeTemplateRequest struct {
	TemplateID string `json:"template_id"`
}

type GetGroupWelcomeTemplateResponse struct {
	util.CommonError
	Text        MsgText               `json:"text"`
	Image       AttachmentImg         `json:"image"`
	Link        AttachmentLink        `json:"link"`
	MiniProgram AttachmentMiniProgram `json:"miniprogram"`
	File        AttachmentFile        `json:"file"`
	Video       AttachmentVideo       `json:"video"`
}

type GetJoinWayResponse struct {
	util.CommonError
	JoinWay JoinWay `json:"join_way"`
}

type GetUserBehaviorRequest struct {
	UserID    []string `json:"userid"`
	PartyID   []int    `json:"partyid"`
	StartTime int      `json:"start_time"`
	EndTime   int      `json:"end_time"`
}

type GetUserBehaviorResponse struct {
	util.CommonError
	BehaviorData []BehaviorData `json:"behavior_data"`
}

type GroupChat struct {
	ChatID     string            `json:"chat_id"`     //客户群ID
	Name       string            `json:"name"`        //群名
	Owner      string            `json:"owner"`       //群主ID
	CreateTime int               `json:"create_time"` //群的创建时间
	Notice     string            `json:"notice"`      //群公告
	MemberList []GroupChatMember `json:"member_list"` //群成员列表
	AdminList  []GroupChatAdmin  `json:"admin_list"`  //群管理员列表
}

type GroupChatAdmin struct {
	UserID string `json:"userid"` //群管理员userid
}

type GroupChatDetailRequest struct {
	ChatID   string `json:"chat_id"`
	NeedName int    `json:"need_name"`
}

type GroupChatDetailResponse struct {
	util.CommonError
	GroupChat GroupChat `json:"group_chat"` //客户群详情
}

type GroupChatList struct {
	ChatID string `json:"chat_id"`
	Status int    `json:"status"`
}

type GroupChatListRequest struct {
	StatusFilter int         `json:"status_filter"` // 非必填	客户群跟进状态过滤。0 - 所有列表(即不过滤) 1 - 离职待继承 2 - 离职继承中 3 - 离职继承完成
	OwnerFilter  OwnerFilter `json:"owner_filter"`  //非必填	群主过滤。如果不填，表示获取应用可见范围内全部群主的数据（但是不建议这么用，如果可见范围人数超过1000人，为了防止数据包过大，会报错 81017）
	Cursor       string      `json:"cursor"`        //非必填	用于分页查询的游标，字符串类型，由上一次调用返回，首次调用不填
	Limit        int         `json:"limit"`         //必填	分页，预期请求的数据量，取值范围 1 ~ 1000
}

type GroupChatListResponse struct {
	util.CommonError
	GroupChatList []GroupChatList `json:"group_chat_list"`
	NextCursor    string          `json:"next_cursor"` //游标
}

type GroupChatMember struct {
	UserID        string  `json:"userid"`            //群成员id
	Type          int     `json:"type"`              //成员类型。 1 - 企业成员  2 - 外部联系人
	JoinTime      int     `json:"join_time"`         //入群时间
	JoinScene     int     `json:"join_scene"`        //入群方式 1 - 由群成员邀请入群（直接邀请入群） 2 - 由群成员邀请入群（通过邀请链接入群） 3 - 通过扫描群二维码入群
	Invitor       Invitor `json:"invitor,omitempty"` //邀请者。目前仅当是由本企业内部成员邀请入群时会返回该值
	GroupNickname string  `json:"group_nickname"`    //在群里的昵称
	Name          string  `json:"name"`              //名字。仅当 need_name = 1 时返回 如果是微信用户，则返回其在微信中设置的名字 如果是企业微信联系人，则返回其设置对外展示的别名或实名
	UnionID       string  `json:"unionid,omitempty"` //外部联系人在微信开放平台的唯一身份标识（微信unionid），通过此字段企业可将外部联系人与公众号/小程序用户关联起来。仅当群成员类型是微信用户（包括企业成员未添加好友），且企业绑定了微信开发者ID有此字段（查看绑定方法）。第三方不可获取，上游企业不可获取下游企业客户的unionid字段
}

type GroupChatStatItem struct {
	Owner string                `json:"owner"`
	Data  GroupChatStatItemData `json:"data"`
}

type GroupChatStatItemData struct {
	NewChatCnt            int `json:"new_chat_cnt"`
	ChatTotal             int `json:"chat_total"`
	ChatHasMsg            int `json:"chat_has_msg"`
	NewMemberCnt          int `json:"new_member_cnt"`
	MemberTotal           int `json:"member_total"`
	MemberHasMsg          int `json:"member_has_msg"`
	MsgTotal              int `json:"msg_total"`
	MigrateTraineeChatCnt int `json:"migrate_trainee_chat_cnt"`
}

type GroupMsg struct {
	MsgID       string        `json:"msgid"`
	Creator     string        `json:"creator"`
	CreateTime  int           `json:"create_time"`
	CreateType  int           `json:"create_type"`
	Text        MsgText       `json:"text"`
	Attachments []*Attachment `json:"attachments"`
}

type Invitor struct {
	UserID string `json:"userid"` //邀请者的userid
}

type JoinWay struct {
	ConfigID       string   `json:"config_id"`
	Scene          int      `json:"scene"`
	Remark         string   `json:"remark"`
	AutoCreateRoom int      `json:"auto_create_room"`
	RoomBaseName   string   `json:"room_base_name"`
	RoomBaseID     int      `json:"room_base_id"`
	ChatIDList     []string `json:"chat_id_list"`
	QrCode         string   `json:"qr_code"`
	State          string   `json:"state"`
}

type JoinWayConfigRequest struct {
	ConfigID string `json:"config_id"`
}

type ListContactWayRequest struct {
	StartTime int    `json:"start_time"`
	EndTime   int    `json:"end_time"`
	Cursor    string `json:"cursor"`
	Limit     int    `json:"limit"`
}

type ListContactWayResponse struct {
	util.CommonError
	ContactWay []*ContactWayForList `json:"contact_way"`
	NextCursor string               `json:"next_cursor"`
}

type MarkTagRequest struct {
	UserID         string   `json:"userid"`
	ExternalUserID string   `json:"external_userid"`
	AddTag         []string `json:"add_tag"`
	RemoveTag      []string `json:"remove_tag"`
}

type MsgText struct {
	Content string `json:"content"`
}

type OpengIDToChatIDRequest struct {
	OpengID string `json:"opengid"`
}

type OpengIDToChatIDResponse struct {
	util.CommonError
	ChatID string `json:"chat_id"` //客户群ID
}

type OwnerFilter struct {
	UseridList []string `json:"userid_list"`
}

type Send struct {
	ExternalUserID string `json:"external_userid"`
	ChatID         string `json:"chat_id"`
	UserID         string `json:"userid"`
	Status         int    `json:"status"`
	SendTime       int    `json:"send_time"`
}

type SendWelcomeMsgRequest struct {
	WelcomeCode string        `json:"welcome_code"`
	Text        MsgText       `json:"text"`
	Attachments []*Attachment `json:"attachments"`
}

type SendWelcomeMsgResponse struct {
	util.CommonError
}

type Tag struct {
	GroupName string `json:"group_name"`
	TagName   string `json:"tag_name"`
	Type      int64  `json:"type"`
	TagID     string `json:"tag_id"`
}

type TagGroup struct {
	GroupID    string            `json:"group_id"`
	GroupName  string            `json:"group_name"`
	CreateTime int               `json:"create_time"`
	GroupOrder int               `json:"group_order"`
	Deleted    bool              `json:"deleted"`
	Tag        []TagGroupTagItem `json:"tag"`
}

type TagGroupTagItem struct {
	ID         string `json:"id"`
	Name       string `json:"name"`
	CreateTime int    `json:"create_time"`
	Order      int    `json:"order"`
	Deleted    bool   `json:"deleted"`
}

type Task struct {
	UserID   string `json:"userid"`
	Status   int    `json:"status"`
	SendTime int    `json:"send_time"`
}

type UpdateContactWayRequest struct {
	ConfigID      string             `json:"config_id"`
	Remark        string             `json:"remark"`
	SkipVerify    bool               `json:"skip_verify"`
	Style         int                `json:"style"`
	State         string             `json:"state"`
	User          []string           `json:"user"`
	Party         []int              `json:"party"`
	ExpiresIn     int                `json:"expires_in"`
	ChatExpiresIn int                `json:"chat_expires_in"`
	UnionID       string             `json:"unionid"`
	Conclusions   ConclusionsRequest `json:"conclusions"`
}

type UpdateContactWayResponse struct {
	util.CommonError
}

type UpdateJoinWayRequest struct {
	ConfigID       string   `json:"config_id"`
	Scene          int      `json:"scene"`            // 必填 1 - 群的小程序插件,2 - 群的二维码插件
	Remark         string   `json:"remark"`           //非必填	联系方式的备注信息，用于助记，超过30个字符将被截断
	AutoCreateRoom int      `json:"auto_create_room"` //非必填	当群满了后，是否自动新建群。0-否；1-是。 默认为1
	RoomBaseName   string   `json:"room_base_name"`   //非必填	自动建群的群名前缀，当auto_create_room为1时有效。最长40个utf8字符
	RoomBaseID     int      `json:"room_base_id"`     //非必填	自动建群的群起始序号，当auto_create_room为1时有效
	ChatIDList     []string `json:"chat_id_list"`     //必填	使用该配置的客户群ID列表，支持5个。见客户群ID获取方法
	State          string   `json:"state"`            //非必填	企业自定义的state参数，用于区分不同的入群渠道。不超过30个UTF-8字符
}

type UpdateUserRemarkRequest struct {
	UserID           string   `json:"userid"`
	ExternalUserID   string   `json:"external_userid"`
	Remark           string   `json:"remark"`
	Description      string   `json:"description"`
	RemarkCompany    string   `json:"remark_company"`
	RemarkMobiles    []string `json:"remark_mobiles"`
	RemarkPicMediaID string   `json:"remark_pic_mediaid"`
}

type WechatChannel struct {
	NickName string `json:"nickname"`
	Source   string `json:"source"`
}