飞鱼CRM接入第三方系统 飞鱼API对接详细教程

场景描述

在白码低代码开发平台中，是支持外部crm系统的线索通过接口流入到白码系统里面，换而言之，只要外部的系统有线索api接口，白码系统可以接收线索并在白码系统上进行后续操作。本文以飞鱼crm系统为例，讲解如何接收飞鱼crm系统传过来的线索

前期准备

准备两个数据表，一个是客户表(基础字段)，一个是日志(记录每次回调的事件和返回时间)

实现步骤

1.新建webhook

新增一个webhook，写入以下代码

代码如下:         复制代码

async function hook($req = request, $resp = response, $modules = modules) {
    let req = $req.body;//回调回来的数据
    let now = await $modules.moment().format("YYYY-MM-DD HH:mm:ss");//当前时间
    let logForm = {
        "63ff01a2f725340df45e8f22": "线索回调",//回调类型  string
        "63ff01a2f725340df45e8f23": JSON.stringify(req),//回调事件  string
        "63ff01a2f725340df45e8f24": now,//回调时间  string
    }
    await $modules.data.saveData("63ff004a0ef3f00df536edfd", logForm)

    $resp.body = {
        "code": "0",
        "message": "success"
    }//返回success


     //对回调回来的数据进行处理

}

点击修改icon，将路径后缀改为callback

点击展开基本信息，在路径后面点击复制

2.在飞鱼系统设置api规则

打开飞鱼crm系统，在左侧设置里，找到api设置-线索推送规则（飞鱼帮助文档：帮助中心）

填写规则名字，选择需要回传的字段，点击下一步

填入第二步复制的回调url，点击下一步

此步骤直接点击下一步

此步骤直接点击下一步

点击发送测试数据，默认发送飞鱼自带的demo数据，如果返回结果就是第二步代码中"$resp.body"内写的一样，即代表返回成功，返回成功可以点击保存

若是在飞鱼crm中已有数据，推荐使用线上数据，更好的匹配白码数据表

保存后，把是否启用打开，即可完成设置api规则

3.查看回调数据

在数据集，找到回调日志数据表，点击该条数据，复制，到json美化工具打开，观察数据结构及我们所需的字段

4.把以下代码添加至第一步中webhook里"对回调回来的数据进行处理"注释下面

代码如下:         复制代码

   //对回调回来的数据进行处理
    let map = {
        0: "字节-橙子建站",
        1: "字节-橙子建站",
        2: "其他渠道- 外部导入",
        5: "字节 - 抖音企业号",
        7: "字节 - 巨量线索",
        8: "字节 - 云店",
        9: "字节 - 星图",
        10: "字节 - 获客宝",
        11: "字节 - 住小帮",
    }//渠道map

    let unix = Number(req.create_time)//创建时间
    //数据 客户 63feff350ef3f00df536eac5
    let cusForm = {
        "63ff0191f725340df45e8ebb": req.name || "",//客户名称  string
        "63ff0191f725340df45e8ebd": req.telphone || "",//电话  string
        "63ff0191f725340df45e8ebc": map[req.clue_source],//渠道  string
        "63ff0191f725340df45e8ec0": req.id,//线索id  string
        "63ff0191f725340df45e8ec1": $plugin.moment(unix * 1000).format("YYYY-MM-DD"),//创建日期  date
        "63ff0191f725340df45e8ec2": $plugin.moment(unix * 1000).format("HH:mm:ss"),
        "63ff0191f725340df45e8ebe": req.ad_id,
        "63ff0191f725340df45e8ebf": req.adv_id
    }
    await $modules.data.saveData("63feff350ef3f00df536eac5", cusForm)

效果