网易首页 > 网易号 > 正文 申请入驻

语音Agent写CRM,为什么中间要加一个小端点?

0
分享至

唯一可信的信号,是CRM自己说这通电话进去了。Salesforce回一个成功,记录才算存在;回别的,就是没写进去,得有东西重试。


这条规则决定了整套Salesforce对接的形态。既然Salesforce的回复就是回执,中间就得有个东西能读懂这份回执并据此行动,同时还得攥着Salesforce认的那套凭证。落到实践里,就是一个你自己拥有的小型HTTPS端点,Agent发出的每个请求都从它过。

Agent自己续不了token

两套认证模型对不上。Salesforce的服务端到服务端方案,也就是客户端凭证流程,发的是短期访问令牌,不给刷新令牌。令牌失效了,就拿客户端ID和密钥再要一个。语音平台那边习惯把凭证存成一个固定值。在开源AI语音Agent平台Dograh里,凭证就是API Key、Bearer Token、Basic Auth或自定义请求头,设一次就不动的固定值。

于是分工变成:端点保管Salesforce密钥、处理令牌,Agent只给它发一个你自己的固定密钥,比如放在X-Bridge-Key请求头里。端点做任何事之前先校验这个头。

续期逻辑很短:取令牌、复用,Salesforce回401就重新取一个再试一次。令牌函数会缓存访问令牌,只有在没有缓存或被强制刷新时,才带着grant_type=client_credentials去请求令牌接口。之后下游谁都不用再操心过期。

Salesforce那侧的配置

新集成从External Client App起步。自Spring '26起新建connected app已被限制,Salesforce推荐改用External Client App,不过已有的connected app继续可用。在应用的OAuth策略里启用OAuth并打开客户端凭证流程,然后选定run-as用户。

这个run-as用户比看上去重要。走这条流程的每个动作都以该用户身份执行,所以要给它一个专用的集成用户,别混进员工自己的登录账号。Enterprise、Unlimited和Performance版本包含五个Salesforce Integration用户许可,集成用户采用"Minimum Access - API Only Integrations"配置文件。再加一个能读Contact和Lead、能建Task的权限集,到此为止。消费者密钥和密钥放进端点的环境变量,只有你的服务器读得到。

在打招呼之前认出打电话的人

来电场景下,端点可以在Agent开口前先查人。Start Call节点底部的Pre-Call Data Fetch会把来电号码放在call_inbound.from_number里POST出去,最多等10秒,把你返回在initial_context下的内容变成提示词可用的变量,比如{{first_name}}。

Salesforce存电话号码的方式五花八门,按精确字符串匹配会漏掉一大片。用parameterizedSearch带上in=PHONE跨Contact和Lead查,取美国号码的后10位,一次请求就能绕开格式混乱。返回第一个匹配的ID和名字,没匹配上就返回known_caller: no。

这里有两个提醒。查询跑的时候来电者正听着回铃音,所以得快。号码匹配只换来一条记录,Agent在提及任何从Salesforce拿到的信息之前,应该先用出生日期这类经过批准的核验方式确认身份。

外呼可以完全跳过搜索,把Salesforce ID直接带在活动CSV或API Trigger的initial_context里。

拿着回执把通话写回去

开头那条规则在这里兑现。通话结束时,Webhook节点把结果POST给端点,端点在匹配到的Contact或Lead上建一条Task。有个字段容易踩坑:创建请求里TaskSubtype必须是Call,因为Salesforce之后不允许你改。漏了它,这通电话就永远以普通任务的样子躺在记录里。

WhoId填打招呼之前找到的Contact或Lead ID,通话时长按原样写进CallDurationInSeconds。然后把Salesforce的答复原样交回去:Salesforce报错,端点也报错,Webhook节点对临时性失败最多重试5次;Salesforce回成功,Task就存在了,收工。重试自带风险,同一通电话可能被记两次,所以把每个已建Task的run_id存下来,见过的就跳过。

自托管平台能把客户端密钥和每一次Salesforce请求都留在你自己的网络里,通话数据只在你的服务器和Salesforce之间流动。

在信任这套东西之前,用真手机打一通测试电话,打开它的View Trace,看预调用请求和Webhook各自发了什么、你的端点回了什么。再用一个陌生号码打一次,确认没有匹配时Agent照样能好好打招呼。

特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。

Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.

相关推荐
热点推荐
女主任被火箭提拔,调查一出,三名男官员同时翻车

女主任被火箭提拔,调查一出,三名男官员同时翻车

丞丞故事汇
2025-07-17 15:39:30
《新聊斋》正式定档!宋祖儿演树妖姥姥,林允一人分饰两角

《新聊斋》正式定档!宋祖儿演树妖姥姥,林允一人分饰两角

天玑影视说
2026-11-16 15:10:23
《多喜一家人》口碑爆棚,本是冲着蒋欣来的,却被46岁男配吸引

《多喜一家人》口碑爆棚,本是冲着蒋欣来的,却被46岁男配吸引

天玑影视说
2026-11-17 09:32:41
WTI原油突破87美元/桶,日内涨1.50%

WTI原油突破87美元/桶,日内涨1.50%

每日经济新闻
2026-11-17 21:50:06
网传不少中产已经放弃托举下一代了,阶层要更加固化了!

网传不少中产已经放弃托举下一代了,阶层要更加固化了!

黯泉
2026-11-16 17:37:25
刚洗白,与未成年交往事件,金秀贤又迎“噩耗”,这回麻烦大了

刚洗白,与未成年交往事件,金秀贤又迎“噩耗”,这回麻烦大了

乡野小珥
2026-11-16 05:52:48
森保一将卸任日本队主帅,8年执教日本取得77胜17平19负

森保一将卸任日本队主帅,8年执教日本取得77胜17平19负

懂球帝
2026-11-17 23:43:09
二战时,日军给女性强行注射“606药剂”,注射完,士兵就露出了邪恶的笑容,“606药剂”究竟是啥?

二战时,日军给女性强行注射“606药剂”,注射完,士兵就露出了邪恶的笑容,“606药剂”究竟是啥?

回京历史梦
2026-11-10 17:49:16
国务院关于出境入境管理的规定(全文)

国务院关于出境入境管理的规定(全文)

澎湃新闻
2026-07-31 17:31:07
李宗伟现状:瘦到快脱相,吃饭都很痛苦,已是马来西亚羽总主席

李宗伟现状:瘦到快脱相,吃饭都很痛苦,已是马来西亚羽总主席

青梅侃史啊
2026-09-26 16:37:23
特朗普:不介意黄仁勋重掌英伟达

特朗普:不介意黄仁勋重掌英伟达

界面新闻
2026-11-16 23:00:15
eSIM落地一年后体验好了吗?我们和几位初代用户聊了聊

eSIM落地一年后体验好了吗?我们和几位初代用户聊了聊

雷科技
2026-11-17 13:21:36
DeepSeek开始限制使用,网友涌入官方评论区

DeepSeek开始限制使用,网友涌入官方评论区

政知新媒体
2026-11-16 23:11:43
1979年,翁美玲与男友罗柏前往威尼斯出游,1米58的她穿吊带裙与罗柏牵手漫步,镜头下甜蜜画面却藏着不为人知的结局

1979年,翁美玲与男友罗柏前往威尼斯出游,1米58的她穿吊带裙与罗柏牵手漫步,镜头下甜蜜画面却藏着不为人知的结局

磊子讲史
2026-11-04 15:53:33
90后河南女孩的“裸女图”:没有情色,只有美

90后河南女孩的“裸女图”:没有情色,只有美

一条
2026-11-02 10:59:16
突发!俄军一架安-12BK空中起火坠毁,17人恐全部遇难

突发!俄军一架安-12BK空中起火坠毁,17人恐全部遇难

老马拉车莫少装
2026-11-18 00:01:20
赵本山分红拿大头被骂多年,赵四直播道出真相:只看到他吃肉,没看见他挨打

赵本山分红拿大头被骂多年,赵四直播道出真相:只看到他吃肉,没看见他挨打

财叔
2026-09-30 16:30:20
【2026.11.16】爆姐的饭后爆料:生命不止,爆料不息!

【2026.11.16】爆姐的饭后爆料:生命不止,爆料不息!

娱乐真爆姐
2026-11-17 00:52:03
《GTA6》地图太大了 新海报实拍展示超多元素

《GTA6》地图太大了 新海报实拍展示超多元素

游民星空
2026-11-15 19:19:31
乔布斯剧本要重演?黄仁勋手握1300亿,华尔街先慌了!

乔布斯剧本要重演?黄仁勋手握1300亿,华尔街先慌了!

可乐爱微笑
2026-11-17 06:52:02
2026-11-18 01:47:00
Ping值焦虑
Ping值焦虑
有态度网友ytd
182文章数 112关注度
往期回顾 全部

科技要闻

老黄想回来?英伟达董事会:没门

头条要闻

"结婚22年两儿子均非亲生"事件女方发声:我没出轨

头条要闻

"结婚22年两儿子均非亲生"事件女方发声:我没出轨

体育要闻

东契奇心仪之人 三年后拿着底薪站到他身旁

娱乐要闻

刘欢有6位生死之交,个个可托付后事

财经要闻

全民抛售AI,市场转折点或已悄然临近

汽车要闻

奕境X9纯电版信息曝光 将于11月27日广州车展上市

态度原创

家居
健康
房产
教育
手机

家居要闻

2026建博会(广州) 公装联探展交流活动

医生眼里"很伤腰"的椅子,很多人天天坐

房产要闻

5381亩之后,三亚绿谷,等一个500强!

教育要闻

海淀北部新锐校周末体验营!全海淀六年级可报,师资正式亮相

手机要闻

小米18 Pro系列手机国际版正式发布:把背屏带向海外,1399欧元起

无障碍浏览 进入关怀版