第三方应用开发 服务端API 客户联系 变更回调 事件格式
事件格式

目录

  • 添加企业客户事件
  • 编辑企业客户事件
  • 外部联系人免验证添加成员事件
  • 删除企业客户事件
  • 删除跟进成员事件
  • 客户接替失败事件
  • 客户群创建事件
  • 客户群变更事件
  • 客户群解散事件
  • 企业客户标签创建事件
  • 企业客户标签变更事件
  • 企业客户标签删除事件
  • 企业客户标签重排事件
  • 添加企业客户事件

    授权企业中配置了客户联系功能的成员添加外部联系人时,企业微信服务器会向应用的“指令回调URL”推送该事件

    请求示例:

    <xml>
    	<SuiteId><![CDATA[ww4asffe99e54c0f4c]]></SuiteId>
    	<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
    	<InfoType><![CDATA[change_external_contact]]></InfoType>
    	<TimeStamp>1403610513</TimeStamp>
    	<ChangeType><![CDATA[add_external_contact]]></ChangeType>
    	<UserID><![CDATA[zhangsan]]></UserID>
    	<ExternalUserID><![CDATA[woAJ2GCAAAXtWyujaWJHDDGi0mACH71w]]></ExternalUserID>
    	<State><![CDATA[teststate]]></State>
    	<WelcomeCode><![CDATA[WELCOMECODE]]></WelcomeCode>
    </xml>

    参数说明:

    参数说明
    SuiteId第三方应用ID
    AuthCorpId授权企业的CorpID
    InfoType固定为change_external_contact
    TimeStamp时间戳
    ChangeType此时固定为add_external_contact
    UserID企业服务人员的UserID
    ExternalUserID外部联系人的userid,注意不是企业成员的帐号
    State添加此用户的「联系我」方式配置的state参数,可用于识别添加此用户的渠道
    WelcomeCode欢迎语code,可用于发送欢迎语
    第三方应用可以根据ExternalUserID调用“获取客户详情”读取详情。
    注意:如果外部联系人和成员已经开始聊天或已通过「外部联系人免验证添加成员事件」得到的welcomecode发送欢迎语,则不会继续返回welcomecode。

    编辑企业客户事件

    授权企业中配置了客户联系功能的成员编辑外部联系人的备注信息(不包括备注手机号码)或企业标签时,企业微信服务器会向应用的“指令回调URL”推送该事件,但仅修改外部联系人备注手机号时不会触发回调。

    请求示例:

    <xml>
    	<SuiteId><![CDATA[ww4asffe99e54c0f4c]]></SuiteId>
    	<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
    	<InfoType><![CDATA[change_external_contact]]></InfoType>
    	<TimeStamp>1403610513</TimeStamp>
    	<ChangeType><![CDATA[edit_external_contact]]></ChangeType>
    	<UserID><![CDATA[zhangsan]]></UserID>
    	<ExternalUserID><![CDATA[woAJ2GCAAAXtWyujaWJHDDGi0mACH71w]]></ExternalUserID>
    </xml>

    参数说明:

    参数说明
    SuiteId第三方应用ID
    AuthCorpId授权企业的CorpID
    InfoType固定为change_external_contact
    TimeStamp时间戳
    ChangeType此时固定为edit_external_contact
    UserID企业服务人员的UserID
    ExternalUserID外部联系人的userid,注意不是企业成员的帐号

     

    外部联系人免验证添加成员事件

    外部联系人添加了配置了客户联系功能且开启了免验证的成员时(此时成员尚未确认添加对方为好友),企业微信服务器会向应用的“指令回调URL”推送该事件

    请求示例:

    <xml>
    	<SuiteId><![CDATA[ww4asffe99e54c0f4c]]></SuiteId>
    	<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
    	<InfoType><![CDATA[change_external_contact]]></InfoType>
    	<TimeStamp>1403610513</TimeStamp>
    	<ChangeType><![CDATA[add_half_external_contact]]></ChangeType>
    	<UserID><![CDATA[zhangsan]]></UserID>
    	<ExternalUserID><![CDATA[woAJ2GCAAAXtWyujaWJHDDGi0mACH71w]]></ExternalUserID>
    	<State><![CDATA[teststate]]></State>
    	<WelcomeCode><![CDATA[WELCOMECODE]]></WelcomeCode>
    </xml>

    参数说明:

    参数说明
    SuiteId第三方应用ID
    AuthCorpId授权企业的CorpID
    InfoType固定为change_external_contact
    TimeStamp时间戳
    ChangeType此时固定为add_half_external_contact
    UserID企业服务人员的UserID
    ExternalUserID外部联系人的userid,注意不是企业成员的帐号
    State添加此用户的「联系我」方式配置的state参数,可用于识别添加此用户的渠道
    WelcomeCode欢迎语code,可用于发送欢迎语
    第三方应用可以根据ExternalUserID调用“获取客户详情”读取详情。
    注意:如果外部联系人和成员已经开始聊天或已通过「外部联系人免验证添加成员事件」得到的welcomecode发送欢迎语,则不会继续返回welcomecode。

    删除企业客户事件

    授权企业中配置了客户联系功能的成员删除外部联系人时,企业微信服务器会向应用的“指令回调URL”推送该事件

    请求示例:

    <xml>
    	<SuiteId><![CDATA[ww4asffe99e54c0f4c]]></SuiteId>
    	<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
    	<InfoType><![CDATA[change_external_contact]]></InfoType>
    	<TimeStamp>1403610513</TimeStamp>
    	<ChangeType><![CDATA[del_external_contact]]></ChangeType>
    	<UserID><![CDATA[zhangsan]]></UserID>
    	<ExternalUserID><![CDATA[woAJ2GCAAAXtWyujaWJHDDGi0mACH71w]]></ExternalUserID>
    	<Source><![CDATA[DELETE_BY_TRANSFER]]></Source>
    </xml>

    参数说明:

    参数说明
    SuiteId第三方应用ID
    AuthCorpId授权企业的CorpID
    InfoType固定为change_external_contact
    TimeStamp时间戳
    ChangeType此时固定为del_external_contact
    UserID企业服务人员的UserID
    ExternalUserID外部联系人的userid,注意不是企业成员的帐号
    Source删除客户的操作来源,DELETE_BY_TRANSFER表示此客户是因在职继承自动被转接成员删除

     

    删除跟进成员事件

    授权企业中配置了客户联系功能的成员被外部联系人删除时,企业微信服务器会向应用的“指令回调URL”推送该事件

    请求示例:

    <xml>
    	<SuiteId><![CDATA[ww4asffe99e54c0f4c]]></SuiteId>
    	<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
    	<InfoType><![CDATA[change_external_contact]]></InfoType>
    	<TimeStamp>1403610513</TimeStamp>
    	<ChangeType><![CDATA[del_follow_user]]></ChangeType>
    	<UserID><![CDATA[zhangsan]]></UserID>
    	<ExternalUserID><![CDATA[woAJ2GCAAAXtWyujaWJHDDGi0mACH71w]]></ExternalUserID>
    </xml>

    参数说明:

    参数说明
    SuiteId第三方应用ID
    AuthCorpId授权企业的CorpID
    InfoType固定为change_external_contact
    TimeStamp时间戳
    ChangeType此时固定为del_follow_user
    UserID企业服务人员的UserID
    ExternalUserID外部联系人的userid,注意不是企业成员的帐号

     

    客户接替失败事件

    企业将客户分配给新的成员接替后,当客户添加失败时,企业微信服务器会向应用的“指令回调URL”推送该事件

    请求示例:

    <xml>
    	<SuiteId><![CDATA[ww4asffe99e54c0f4c]]></SuiteId>
    	<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
    	<InfoType><![CDATA[change_external_contact]]></InfoType>
    	<TimeStamp>1403610513</TimeStamp>
    	<ChangeType><![CDATA[transfer_fail]]></ChangeType>
    	<FailReason><![CDATA[customer_refused]]></FailReason>
    	<UserID><![CDATA[zhangsan]]></UserID>
    	<ExternalUserID><![CDATA[woAJ2GCAAAXtWyujaWJHDDGi0mACH71w]]></ExternalUserID>
    </xml>

    参数说明:

    参数说明
    SuiteId第三方应用ID
    AuthCorpId授权企业的CorpID
    InfoType固定为change_external_contact
    TimeStamp时间戳
    ChangeType此时固定为transfer_fail
    FailReason接替失败的原因, customer_refused-客户拒绝, customer_limit_exceed-接替成员的客户数达到上限
    UserID企业服务人员的UserID
    ExternalUserID外部联系人的userid,注意不是企业成员的帐号

     

    客户群创建事件

    有新增客户群时,回调该事件。收到该事件后,企业可以调用获取客户群详情接口获取客户群详情。

    请求示例:

    <xml>
    	<SuiteId><![CDATA[ww4asffe99e54c0f4c]]></SuiteId>
    	<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
    	<InfoType><![CDATA[change_external_chat]]></InfoType>
    	<TimeStamp>1403610513</TimeStamp>
    	<ChatId><![CDATA[CHAT_ID]]></ChatId>
    	<ChangeType><![CDATA[create]]></ChangeType>
    </xml>

     

    参数说明:

    参数说明
    SuiteId第三方应用ID
    AuthCorpId授权企业的CorpID
    InfoType固定为change_external_chat
    TimeStamp时间戳
    ChatId群ID
    ChangeType此时固定为create

    客户群变更事件

    客户群被修改后(群名变更,群成员增加或移除,群公告变更),回调该事件。收到该事件后,企业需要再调用获取客户群详情接口,以获取最新的群详情。

    请求示例:

    <xml>
    	<SuiteId><![CDATA[ww4asffe99e54c0f4c]]></SuiteId>
    	<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
    	<InfoType><![CDATA[change_external_chat]]></InfoType>
    	<TimeStamp>1403610513</TimeStamp>
    	<ChatId><![CDATA[CHAT_ID]]></ChatId>
    	<ChangeType><![CDATA[update]]></ChangeType>
    	<UpdateDetail><![CDATA[add_member]]></UpdateDetail>
        <JoinScene>1</JoinScene>
        <QuitScene>0</QuitScene>
        <MemChangeCnt>10</MemChangeCnt>
    </xml>

     

    参数说明:

    参数说明
    SuiteId第三方应用ID
    AuthCorpId授权企业的CorpID
    InfoType固定为change_external_chat
    TimeStamp时间戳
    ChatId群ID
    ChangeType此时固定为update
    UpdateDetail变更详情。目前有以下几种:
    add_member : 成员入群
    del_member : 成员退群
    change_owner : 群主变更
    change_name : 群名变更
    change_notice : 群公告变更
    JoinScene当是成员入群时有值。表示成员的入群方式
    0 - 由成员邀请入群(包括直接邀请入群和通过邀请链接入群)
    3 - 通过扫描群二维码入群
    QuitScene当是成员退群时有值。表示成员的退群方式
    0 - 自己退群
    1 - 群主/群管理员移出
    MemChangeCnt当是成员入群或退群时有值。表示成员变更数量

     

    客户群解散事件

    当客户群被群主解散后,回调该事件。

    请求示例:

    <xml>
    	<SuiteId><![CDATA[ww4asffe99e54c0f4c]]></SuiteId>
    	<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
    	<InfoType><![CDATA[change_external_chat]]></InfoType>
    	<TimeStamp>1403610513</TimeStamp>
    	<ChatId><![CDATA[CHAT_ID]]></ChatId>
    	<ChangeType><![CDATA[dismiss]]></ChangeType>
    </xml>

     

    参数说明:

    参数说明
    SuiteId第三方应用ID
    AuthCorpId授权企业的CorpID
    InfoType固定为change_external_chat
    TimeStamp时间戳
    ChatId群ID
    ChangeType此时固定为dismiss

    企业客户标签创建事件

    企业/管理员创建客户标签/标签组时,企业微信服务器将向具有企业客户权限的第三方应用指令回调URL回调此事件。收到该事件后,第三方服务商需要调用获取企业标签库来获取标签/标签组的详细信息。

    请求示例:

    <xml>
    	<SuiteId><![CDATA[ww4asffe99e54c0f4c]]></SuiteId>
    	<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
    	<InfoType><![CDATA[change_external_tag]]></InfoType>
    	<TimeStamp>1403610513</TimeStamp>
    	<Id><![CDATA[TAG_ID]]></Id>
    	<TagType><![CDATA[tag]]></TagType>
    	<ChangeType><![CDATA[create]]></ChangeType>
    </xml>

    参数说明:

    参数说明
    SuiteId第三方应用ID
    AuthCorpId授权企业的CorpID
    InfoType固定为change_external_tag
    TimeStampunix时间戳
    Id标签或标签组的ID
    TagType创建标签时,此项为tag,创建标签组时,此项为tag_group
    ChangeType此时固定为create

    企业客户标签变更事件

    当企业客户标签/标签组被修改时,企业微信服务器将向具有企业客户权限的第三方应用指令回调URL回调此事件。收到该事件后,第三方服务商需要调用获取企业标签库来获取标签/标签组的详细信息。

    请求示例:

    <xml>
    	<SuiteId><![CDATA[ww4asffe99e54c0f4c]]></SuiteId>
    	<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
    	<InfoType><![CDATA[change_external_tag]]></InfoType>
    	<TimeStamp>1403610513</TimeStamp>
    	<Id><![CDATA[TAG_ID]]></Id>
    	<TagType><![CDATA[tag]]></TagType>
    	<ChangeType><![CDATA[update]]></ChangeType>
    </xml>

    参数说明:

    参数说明
    SuiteId第三方应用ID
    AuthCorpId授权企业的CorpID
    InfoType固定为change_external_tag
    TimeStampunix时间戳
    Id标签或标签组的ID
    TagType变更标签时,此项为tag,变更标签组时,此项为tag_group
    ChangeType此时固定为update

    企业客户标签删除事件

    当企业客户标签/标签组被删除改时,企业微信服务器将向具有企业客户权限的第三方应用指令回调URL回调此事件。删除标签组时,该标签组下的所有标签将被同时删除,但不会进行回调。

    请求示例:

    <xml>
    	<SuiteId><![CDATA[ww4asffe99e54c0f4c]]></SuiteId>
    	<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
    	<InfoType><![CDATA[change_external_tag]]></InfoType>
    	<TimeStamp>1403610513</TimeStamp>
    	<Id><![CDATA[TAG_ID]]></Id>
    	<TagType><![CDATA[tag]]></TagType>
    	<ChangeType><![CDATA[delete]]></ChangeType>
    </xml>

    参数说明:

    参数说明
    SuiteId第三方应用ID
    AuthCorpId授权企业的CorpID
    InfoType固定为change_external_tag
    TimeStampunix时间戳
    Id标签或标签组的ID
    TagType删除标签时,此项为tag,删除标签组时,此项为tag_group
    ChangeType此时固定为delete

     

    企业客户标签重排事件

    当企业管理员在终端/管理端调整标签顺序时,可能导致标签顺序整体调整重排,引起大部分标签的order值发生变化,此时会回调此事件,收到此事件后企业应尽快全量同步标签的order值,防止后续调用接口排序出现非预期结果。

    请求示例:

    <xml>
    	<SuiteId><![CDATA[ww4asffe99e54c0f4c]]></SuiteId>
    	<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
    	<InfoType><![CDATA[change_external_tag]]></InfoType>
    	<TimeStamp>1403610513</TimeStamp>
    	<Id><![CDATA[TAG_ID]]></Id>
    	<ChangeType><![CDATA[shuffle]]></ChangeType>
    </xml>

    参数说明:

    参数说明
    SuiteId第三方应用ID
    AuthCorpId授权企业的CorpID
    InfoType固定为change_external_tag
    TimeStampunix时间戳
    Id标签组id,表示只有此标签组内的标签发生了重排,如果为空,则表示全部标签组顺序都发生了变化
    ChangeType此时固定为shuffle
    上一篇
    获取「群聊数据统计」数据
    下一篇
    管理商品图册