dealtape-python-sdk

DealTape SDK for Python


License
MIT
Install
pip install dealtape-python-sdk==0.0.1

Documentation

Recurrent.ai DealTape SDK for Python

概述

DealTape数据SDK

安装方式

使用PIP进行安装(以Linux系统为例)

$ pip install -U dealtape

也可以直接安装解压后的安装包

$ sudo python setup.py install

快速使用

# -*- coding: utf-8 -*-
from dealtape import CallLog, DealTapeClient

business = 'YOUR_BUSINESS_KEY' # 企业的唯一标识,即在企业DealTape系统中的二级域名
access_key_id = 'YOUR_ACCESS_KEY_ID' # 企业的AccessKeyId
access_key_secret = 'YOUR_ACCESS_KEY_SECRET' # 企业的AccessKeySecret
endpoint = 'http://data_server.rcrai.com/' # api地址

client = DealTapeClient(business=business, access_key_id=access_key_id, access_key_secret=access_key_secret, endpoint=endpoint)

数据推送

item = CallLog(
    url="CALLLOG_AUDIO_URL", # 电话录音的url
    id="CALLLOG_UNIQUE_IDENTIFIER", # 电话在客户内部系统中的唯一标识
    staff_id="STAFF_ID", # 该电话坐席的唯一标识
    staff_name="STAFF_NAME", # 该电话坐席名称
    staff_roles=["ROLE1", "ROLE2"], # 该坐席的角色
    staff_dept_id="STAFF_DEPTARTMENT_ID" # 该坐席所在团队ID
    staff_dept_name="STAFF_DEPTARTMENT_NAME" # 该坐席所在团队名称
    staff_group_name="STAFF_GROUP_NAME" # 该坐席所在大组名称
    customer_id="CUSTOMER_ID", # 客户的唯一标识
    customer_name="CUSTOMER_NAME", # 客户的名称
    deal_closed=True/False/None, # 该电话是否成单
    timestamp=TIMESTAMP # 电话的拨打时间(datetime.datetime类型, 或是int类型的unix时间戳)
    category="AUDIO_CATEGORY" # 电话录音类型
)
resp = client.push_calllog(item)
if not resp.ok:
    print(resp.text)

语音识别结果获取

resp = client.get_transcript(source_id=CALLLOG_UNIQUE_IDENTIFIER) # 电话在客户内部系统中的唯一标识
if not resp.ok:
    print(resp.text)

语义画像获取

resp = client.get_semantic(source_id=CALLLOG_UNIQUE_IDENTIFIER) # 电话在客户内部系统中的唯一标识
if not resp.ok:
    print(resp.text)
# 成功返回结果
{
    "entities": [
        {
            "id": "5b73e94935842e0b838ad318",
            "bid": "599d1ff844ff53119a13e545",
            "sid": "",
            "cid": "5aefccf02aa1d4001331fdc5",
            "uniqueId": "",
            "name": "身份确认",
            "value": "身份确认", // 语义点
            "evidence": "嗯喂,你好,是是吗?喂你好, 你好,唉,你", // 语义点证据
            "briefEvidence": "",
            "mediumEvidence": "",
            "score": 0
        },
        {
            "id": "5b73e94935842e0b838ad319",
            "bid": "599d1ff844ff53119a13e545",
            "sid": "",
            "cid": "5aefccf02aa1d4001331fdc5",
            "uniqueId": "",
            "name": "身份确认",
            "value": "身份确认",
            "evidence": "话能嗯对,堂哥 您是他堂哥是吗?喂,嗯,那你这",
            "briefEvidence": "",
            "mediumEvidence": "",
            "score": 0
        },
        {
            "id": "5b73e94935842e0b838ad31a",
            "bid": "599d1ff844ff53119a13e545",
            "sid": "",
            "cid": "5aefccf02aa1d4001331fdc5",
            "uniqueId": "",
            "name": "自我介绍",
            "value": "自我介绍",
            "evidence": "?你是怎么弄啊,我这块是捷信法务部的,捷信委托的法",
            "briefEvidence": "",
            "mediumEvidence": "",
            "score": 0
        },
        {
            "id": "5b73e94935842e0b838ad31c",
            "bid": "599d1ff844ff53119a13e545",
            "sid": "",
            "cid": "5aefccf02aa1d4001331fdc5",
            "uniqueId": "",
            "name": "描述借款信息",
            "value": "描述借款信息",
            "evidence": ",你这块是是已经逾期了120天一千的,然后你直",
            "briefEvidence": "",
            "mediumEvidence": "",
            "score": 0
        },
        {
            "id": "5b73e94935842e0b838ad31d",
            "bid": "599d1ff844ff53119a13e545",
            "sid": "",
            "cid": "5aefccf02aa1d4001331fdc5",
            "uniqueId": "",
            "name": "描述借款信息",
            "value": "描述借款信息",
            "evidence": "上的话,你看已经逾期81天了,并不是说一两",
            "briefEvidence": "",
            "mediumEvidence": "",
            "score": 0
        },
        {
            "id": "5b73e94935842e0b838ad31f",
            "bid": "599d1ff844ff53119a13e545",
            "sid": "",
            "cid": "5aefccf02aa1d4001331fdc5",
            "uniqueId": "",
            "name": "协商转告",
            "value": "协商转告",
            "evidence": "我一下吗?我电话联系他本人好吗,我加下你的",
            "briefEvidence": "",
            "mediumEvidence": "",
            "score": 0
        },
        {
            "id": "5b73e94935842e0b838ad320",
            "bid": "599d1ff844ff53119a13e545",
            "sid": "",
            "cid": "5aefccf02aa1d4001331fdc5",
            "uniqueId": "",
            "name": "协商转告",
            "value": "协商转告",
            "evidence": "是我们的,还需要联系上他本人,这一块的话,大",
            "briefEvidence": "",
            "mediumEvidence": "",
            "score": 0
        },
        {
            "id": "5b73e94935842e0b838ad321",
            "bid": "599d1ff844ff53119a13e545",
            "sid": "",
            "cid": "5aefccf02aa1d4001331fdc5",
            "uniqueId": "",
            "name": "协商转告",
            "value": "协商转告",
            "evidence": "嗯,那你这个不能联系到本人把他本人号码给我",
            "briefEvidence": "",
            "mediumEvidence": "",
            "score": 0
        },
        {
            "id": "5b73e94935842e0b838ad32d",
            "bid": "599d1ff844ff53119a13e545",
            "sid": "",
            "cid": "5aefccf02aa1d4001331fdc5",
            "uniqueId": "",
            "name": "协商还款",
            "value": "协商还款",
            "evidence": "你直说不还了,是什么时候还呢,这个这个这个",
            "briefEvidence": "",
            "mediumEvidence": "",
            "score": 0
        },
        {
            "id": "5b73e94935842e0b838ad32f",
            "bid": "599d1ff844ff53119a13e545",
            "sid": "",
            "cid": "5aefccf02aa1d4001331fdc5",
            "uniqueId": "",
            "name": "协商还款",
            "value": "协商还款",
            "evidence": "快的明天这个6点之前处理一下这个款了,如",
            "briefEvidence": "",
            "mediumEvidence": "",
            "score": 0
        },
        {
            "id": "5b73e94935842e0b838ad330",
            "bid": "599d1ff844ff53119a13e545",
            "sid": "",
            "cid": "5aefccf02aa1d4001331fdc5",
            "uniqueId": "",
            "name": "法律施压",
            "value": "法律施压",
            "evidence": "我们可能会涉及到法律问题 期,也就是说在",
            "briefEvidence": "",
            "mediumEvidence": "",
            "score": 0
        },
        {
            "id": "5b73e94935842e0b838ad333",
            "bid": "599d1ff844ff53119a13e545",
            "sid": "",
            "cid": "5aefccf02aa1d4001331fdc5",
            "uniqueId": "",
            "name": "信用施压",
            "value": "信用施压",
            "evidence": "话,涉及到以后的征信 征信问题,他跟",
            "briefEvidence": "",
            "mediumEvidence": "",
            "score": 0
        },
        {
            "id": "5b73e94935842e0b838ad334",
            "bid": "599d1ff844ff53119a13e545",
            "sid": "",
            "cid": "5aefccf02aa1d4001331fdc5",
            "uniqueId": "",
            "name": "生活限制",
            "value": "生活限制",
            "evidence": "个信用卡问题或者上学问题 包括在往后延伸",
            "briefEvidence": "",
            "mediumEvidence": "",
            "score": 0
        },
        {
            "id": "5b73e94935842e0b838ad335",
            "bid": "599d1ff844ff53119a13e545",
            "sid": "",
            "cid": "5aefccf02aa1d4001331fdc5",
            "uniqueId": "",
            "name": "确认还款",
            "value": "确认还款",
            "evidence": "再给你打电话,4点多给我打电话,到时 嗯,这样子,我",
            "briefEvidence": "",
            "mediumEvidence": "",
            "score": 0
        }
    ],
    "success": true // 成功
}