时间戳

首页 > 解决方案 > Nimble API 中社交关系数据的格式

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

问题描述

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

新联系人的创建工作正常。我唯一遇到的问题是在个人资料中添加“社交关系”。我提交给 API（见下文）的 JSON 是有效的。我在 jsonlint.com 上对其进行了测试（当然没有评论）。在 Nimble 中创建联系人时，“社交关系”（linkedin、twitter 等）根本不会显示在新创建的 Nimble 个人资料中。

https://nimble.readthedocs.io/en/latest/contacts/fields/ 上的文档看起来很简单——为linkedin 提交的值是完整的linkedin URL。我已经直接从浏览器复制/粘贴了适当的链接 URL，所以我相信它是正确的。

我想知道的是向 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”数组的“修饰符”、“组”和“标签”属性。纳达，什么都没有。

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

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

标签： jsoncrm

解决方案

我终于收到了 Nimble API 支持的回复（8 天后）。文档似乎不是最新的。“社交联系”字段已停用，例如添加链接 URL 的正确方法如下：

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

创建新联系人时，linkedin 块将作为“字段”数组的一部分添加，如下所示：

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

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

希望这对其他人有帮助。如果有人发现它的代表点数 >1500，请创建一个 Nimble 标签。不幸的是，我不能。

推荐阅读