搜索客户通讯录,用于根据客户名、手机号、微信号、客服、负责人、明确标签、渠道、性别、联系人类型或时间范围完整召回符合条件的客户 UID。用户只要求查询当天或某个时间范围内咨询过的客户时,默认查询当前授权账号关联的所有渠道范围,不代表当前调用客服本人接待或回复过;除非用户明确说“我处理过、我接待过、我回复过、归属于我”或指定某客服/渠道,否则不要自动传 kfid、pic_kfids 或 channel_id。用户要求查询某天或某段时间内的全部用户、包括会话已经结束/关闭的用户时,应使用本工具分页查询,不能用 zhini_list_active_sessions 代替。重要边界:自然语言中的“XXX 用户/客户”默认是业务语义或筛选条件,不应自动转换为 tag_id。可由名称、时间、渠道、客服等结构化字段表达的条件直接使用本工具;必须根据聊天内容判断的条件,应结合 zhini_search_sessions 和 zhini_fetch_messages 识别。只有用户明确要求某标签或上下文已有 tag_id 时才按标签筛选,且 tag_id 只覆盖已标注客户。用户给客户姓名/手机号/微信号时先用本工具召回候选客户;如果匹配多个客户,应让用户确认。用户明确给出标签名、渠道名、客服名时,应先分别调用 zhini_search_tags、zhini_list_channels、zhini_list_kefu 解析 ID。禁止空条件拉全量;page 从 0 开始;page_size 最大 20。后续:拿到 uid 后通常调用 zhini_get_customer_profile 或 zhini_fetch_messages。
ConnectorNo auth