# 接口调用图元
当需要调用第三方系统接口实现某功能时使用该图元，如果不选择接口，直接添加参数并赋值，也可实现赋值图元相应的功能。
#### 图元展示
![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000002526230382.png)
#### 参数介绍
- 节点名称：标识节点名称。
- 节点名称：标识节点名称。
- 描述：节点的详细说明信息。
- 接口类型：请选择需要调用的接口类型。取值范围：内置接口，自定义接口。内置接口如下：
  - 记录问答：用于记录问卷标识、问题标题、用户回答意图、用户原始答等信息；
  
  - 获取APIFabric token：用于获取APIFabric token的接口，机器人调用接口成功后token会记入缓存，有效期内会直接从缓存中获取。修改aksk后，原有的缓存不会被清理，在缓存有效期内调用APIFabric token接口会失败。如果调用APIFabric token接口需要立即生效，可以将本流程绑定到新的机器人。
  
  - 情绪识别: 用于识别用户或座席情绪以及该情绪置信度的接口。
  
  - createCallbackTask：用于记录用户的回呼请求，记录后在预约外呼菜单可以查询到预约记录，座席可根据预约信息发起呼叫。具体可参考[如何通过IVR创建预约外呼](https://support.huaweicloud.com/usermanual-cec/cec_04_0704.html#ZH-CN_TOPIC_0000002686553987)。
   
- 调用接口：选择您在"资源管理 \> 业务接口"中添加的接口。租户级参数"租户是否开启组织间的数据强制隔离机制"开启时，只能选择与画布同组织机构以及无组织机构的数据。
- 变量赋值：即变量名和变量值。由于接口返回的出参只能在当前节点有效，如果您需要在后续流程中应用该值，可在此处定义变量，将接口出参的值赋给它。
  ![](https://support.huaweicloud.com/usermanual-cec/public_sys-resources/caution_3.0-zh-cn.png)
  在安全子流程场景下：
  1. 当变量值为IVRREQUEST.input时，变量名必须为加密保存的变量。
  
  2. 当变量值包含加密保存的变量，且变量名不为加密保存的变量时，系统会给出"表达式中包含加密变量，请注意数据安全"的提示，但不会影响用户保存流程。
    
- 条件分支：即条件名和条件表达式。定义当前图元的出口有哪些分支，例如可以根据某个出参的取值来设置分支，每个分支可以指定不同的后续流程。
- 方法调用：如果业务需要对数据处理，比如截取、获取长度、转换、判断等，可以使用[内置函数](https://support.huaweicloud.com/usermanual-cec/cec_04_0203.html#ZH-CN_TOPIC_0000002510096093)。
  ![](https://support.huaweicloud.com/usermanual-cec/public_sys-resources/caution_3.0-zh-cn.png)
  在安全子流程场景下：
  1. 当方法参数包含加密保存的变量，且返回值不为加密保存的变量时，系统会给出"表达式中包含加密变量，请注意数据安全"的提示，但不会影响用户保存流程。
    
 
#### 分支条件介绍
表1分支条件 
| 名称                 | 含义       | 使用方法                                |
|:---|:---|:---|
| SYSERROR_INNER     | odfs内部错误 | ODFS内部发生其他未知错误时会触发该分支条件，不选择则进入异常流程。 |
| SYSERROR_INTERFACE | 接口调用失败   | 接口调用异常时会触发该分支条件，不选择则进入异常流程。         |
   
#### 如何使用图元
单击图元，或使用鼠标将图元拖拽到画布上，然后选择需要调用的接口，被调用的接口需要事先在"资源管理 \> 业务接口"中维护,或在弹窗的选择接口弹窗中点击添加。如果使用该图元赋值，可无需选择接口，直接添加缓存变量名，将其赋值。此时需要事先维护全局变量。
#### 典型使用场景
![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000002526390348.png)
![](https://support.huaweicloud.com/usermanual-cec/public_sys-resources/note_3.0-zh-cn.png)
被调用的接口返回字段包含returnCode时，如果returnCode值为"0"时表示成功，其余值为失败。