如何通过Lambda将Amazon Connect代理从Missed状态改为Available？

问题分析与解决方案 #

现有Lambda代码的核心问题 #

1. 异步逻辑错误：handler是async函数，但使用了回调式的connect.putUserStatus，函数会在回调执行前就返回，导致状态切换操作可能未完成就结束，错误也无法正确捕获。
2. 参数配置错误：
   • AgentStatusId填的是状态名称"Available"，实际需要的是该状态的UUID（可在Connect控制台用户状态页面查看）。
   • InstanceId填的是实例ARN，实际需要的是Connect实例的短ID（控制台实例概览页的「实例ID」字段）。
   • UserId如果传入的是用户ARN，需要提取ARN末尾的用户ID部分，而非直接使用ARN。

修正后的Lambda代码 #

const AWS = require('aws-sdk');
const connect = new AWS.Connect();

exports.handler = async (event) => {
    try {
        // 从代理ARN中提取用户ID（ARN格式示例：arn:aws:connect:区域:账号ID:实例/实例ID/user/用户ID）
        const agentARN = event.Details.Parameters.agent;
        const userId = agentARN.split('/').pop();
        
        const params = {
            AgentStatusId: '替换为Available状态的UUID', // 从Connect控制台用户状态页复制
            InstanceId: '替换为Connect实例短ID', // 从实例概览页复制
            UserId: userId
        };

        const data = await connect.putUserStatus(params).promise();
        return {
            statusCode: 200,
            body: JSON.stringify(data)
        };
    } catch (err) {
        console.error('切换代理状态失败:', err);
        return {
            statusCode: 500,
            body: JSON.stringify({ error: err.stack })
        };
    }
};

完整落地步骤 #

1. 收集配置信息：
   • 登录Connect控制台，进入「用户状态」，找到「Available」状态，复制它的状态ID（UUID格式）。
   • 在实例概览页复制实例ID（非ARN）。
2. 配置Lambda权限与触发：
   • 给Lambda执行角色添加connect:PutUserStatus的IAM权限。
   • 在Connect联系流中，添加「Invoke Lambda function」块，设置在电话挂断前触发（比如放在「Disconnect contact」步骤之前），并传入代理ARN作为参数。
3. 测试验证：
   • 模拟漏接电话场景，检查代理状态是否自动切换为Available。
   • 查看Lambda的CloudWatch日志，排查执行中的错误。

备选方案 #

如果Lambda触发时机不好控制，可尝试：

• 用户状态自动重置：在Connect控制台「用户状态」编辑「Missed」状态，设置自动超时规则，超时后自动切换到「Available」状态。
• 优化自定义CCP：使用Connect Streams API监听missedCall事件，调用setAgentStatus方法直接切换状态，针对性调整之前不符合需求的自定义CCP逻辑。

内容的提问来源于stack exchange，提问作者Codixer