FreeScout API中如何正确添加客户社交媒体链接

在FreeScout帮助台系统中，通过API创建客户记录时添加社交媒体链接是一个常见需求。本文将详细介绍如何正确配置JSON请求，特别是针对LinkedIn等社交媒体链接的添加方法。

问题背景

开发者在通过FreeScout API创建客户记录时发现，当尝试添加LinkedIn个人资料链接时，系统总是将其保存为"其他"类型而非"LinkedIn"类型。即使尝试了多种类型值（如"linkedin"、"LinkedIn"等）或直接使用数据库中的类型ID（3），系统仍然会将其保存为类型12（即"其他"）。

解决方案

最新版本的API & Webhooks模块（v1.0.78）已修复此问题。现在可以通过以下JSON格式正确添加LinkedIn社交媒体链接：

{
    "type": "email",
    "mailboxId": 4,
    "subject": "示例主题",
    "customer": {
        "email": "[e-mail]",
        "firstName": "名",
        "lastName": "姓",
        "socialProfiles": [
            {
                "value": "https://www.linkedin.com/in/example-profile/",
                "type": "linkedin"
            }
        ]
    }
}

关键点说明

1. 类型值：必须使用小写的"linkedin"作为类型值，这是系统识别的标准格式。

2. JSON结构：社交媒体链接应放在customer对象的socialProfiles数组中，每个社交媒体链接都是一个包含value和type属性的对象。

3. URL格式：确保提供的链接是完整的URL格式，包含https://前缀。

4. 多平台支持：同样的方法适用于其他社交媒体平台，只需更改type值为对应的平台名称（如"twitter"、"facebook"等）。

最佳实践建议

1. 测试环境验证：在正式环境使用前，建议先在测试环境中验证API调用结果。

2. 错误处理：实现适当的错误处理机制，捕获API可能返回的验证错误。

3. 版本控制：确保使用的API模块版本不低于v1.0.78，以获得最佳兼容性。

4. 批量操作：如需添加多个社交媒体链接，可以在socialProfiles数组中添加多个对象。

通过遵循以上指南，开发者可以确保在FreeScout系统中正确记录客户的社交媒体信息，为后续的客户服务和沟通提供更全面的背景信息。