Nimble 中社交关系数据的格式 API

Question

我正在使用他们的 API 与 Nimble CRM 进行集成。我正在从 Web 表单收集数据并在 Nimble 中创建新联系人。

新联系人的创建工作正常。我遇到的唯一麻烦是将 "social connections" 添加到个人资料中。我提交给API的JSON（见下文）是有效的。我在 jsonlint.com 测试了它（当然没有评论）。在 Nimble 中创建联系人时，"social connections"（linkedin、twitter 等）根本不会显示在新创建的 Nimble 个人资料中。

https://nimble.readthedocs.io/en/latest/contacts/fields/ 上的文档似乎足够简单 - 为 linkedin 提交的值是完整的 linkedin URL。我直接从浏览器 copy/pasted 适当的 linkedin URL，所以我相信它是正确的。

我想知道的是将 "social connections" 数据提交到 API 的正确 json 结构。坦率地说，这个 API 的文档很烂，我无法从神秘的参考文献中找到答案。我试过的是这样的：

{
    //this part is working just fine
    "record_type": "person",
    "fields": {
        "first name": [{
            "value": "Fred",
            "modifier": ""
        }],
        "last name": [{
            "value": "Tester",
            "modifier": ""
        }],

        "email": [{
            "value": "fred@testsite.com",
            "modifier": "Work"
        }]

    },
    "tags": "VIP",
    //this is the block that is having no effect
    "social_connections": {
        "linkedin": {
            "value": "https://www.linkedin.com/in/fredtester/",
            "modifier": "",
            "group": "Contact Info",
            "label": "linkedin"
        }
    }
}

我也尝试过不使用 "linkedin" 数组的 "modifier"、"group" 和 "label" 属性。纳达，没什么。

顺便说一句，API 调用在所有情况下都是成功的 - 即没有返回错误代码。

有没有人有成功将社交关系与 Nimble 整合的经验？

Answer 1

我终于收到 Nimble API 支持的回音（8 天后）。文档似乎不是最新的。 "social connections" 字段已停用，添加 linkedin URL 的正确方法如下：

"linkedin" : {
    "value": "'.$linkedin.'",
    "modifier": ""
}

创建新联系人时，linkedin 块添加为 "fields" 数组的一部分，如下所示：

"fields: {
    "first name": [{
        "value": "Fred",
        "modifier": ""
    }],
    "last name": [{
        "value": "Tester",
        "modifier": ""
    }],
    "email": [{
        "value": "fred@testsite.com",
        "modifier": "Work"
    }]
    "linkedin" : {
        "value": "'.$linkedin.'",
        "modifier": ""
    }
}

进行更改后，URL 的 linkedin 已正确创建联系人。

希望这对其他人有帮助。如果有人发现它具有 >1500 的代表点数，请创建一个 Nimble 标签。很遗憾，我做不到。

Nimble 中社交关系数据的格式 API

Format for social connections data in Nimble API

json

crm