唯一可信的信号,是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照样能好好打招呼。