sent-contacts

已发送联系人

使用 contacts.list、contacts.get、contacts.create_many、contacts.delete 和 contacts.message_summary 操作联系人。

建立连接并确定范围

使用由客户端管理的 OAuth 2.1/PKCE。切勿请求或暴露令牌、API 密钥、授权标头、客户端 ID 或密钥。执行变更前，显示连接上下文中的当前组织和 Sender Profile；如果其中任一项不可用，请使用 sent-account-readiness 检查已授权范围。

在可行时屏蔽电话号码。仅返回任务所需的联系人字段，并且在查看联系人数据后不要再次重复这些数据。号码存在或有消息记录，并不能证明已获得同意。

组织授权可以通过工具架构中的可选 profileId 选择一个自有 Sender Profile；省略该参数则以已认证账户执行操作。使用 sender_profiles.list 或 sender_profiles.get 验证所有权，并在预检读取、变更和后续读取中使用相同的选择器。配置文件授权不能使用此选择器。若要切换到其他组织或授权范围之外的配置文件，请重新授权。切勿虚构范围字段或索取凭据。

读取联系人

• 使用 contacts.list 搜索联系人或分页浏览联系人。应用可用的最精确筛选条件，避免不必要地导出整个联系人簿。
• 已知确切联系人标识符时，或删除前，使用 contacts.get。
• 使用 contacts.message_summary 获取联系人的消息摘要。区分摘要数据与同意证明或当前可联系状态。

只读调用无需确认变更。

批量创建联系人

1. 在本地验证并去重拟创建的记录。仅保留用户实际提供的字段。
2. 构建准确的 contacts.create_many 参数，但不要调用工具。
3. 显示负载预览，其中包含所选组织、Sender Profile、记录数量、重复项处理方式以及每个确切目标。屏蔽电话号码，但须确保操作员仍可核验；仅在确切核验需要时，才完整显示一次号码。
4. 针对此确切批次请求明确确认。先前的批准或一般性批准均不够。
5. 确认后立即调用 contacts.create_many。记录或范围的任何变更都会使确认失效。

未经预览且未在调用前立即获得明确确认，切勿调用 contacts.create_many。每次重试都视为新的变更，必须重新提供预览并获得新的明确确认。

删除联系人

1. 将请求的联系人解析为唯一明确的标识符。
2. 先使用 contacts.get 获取确切目标。切勿依据猜测的标识符、宽泛筛选条件或过时的列表结果进行删除。
3. 显示删除预览，其中包含所选组织、Sender Profile、确切联系人标识符、显示名称和经过屏蔽的地址。说明删除具有破坏性。
4. 请求明确确认删除该确切目标。
5. 确认后立即调用 contacts.delete。如果目标、范围或记录发生变化，请重新获取并重复预览。

未经获取目标并在调用前立即获得明确确认，切勿调用 contacts.delete。每次重试都必须重新获取目标、提供新的预览并获得新的明确确认。

报告结果

报告数量和稳定标识符，不要返回完整联系人记录。如果创建或删除结果不明确，不要假定操作成功，也不要自动重试。条件允许时重新读取确切目标，说明不确定之处，并要求获得新的确认后才能进行任何后续变更。