https://vcc.live/wp-content/uploads/2022/03/vcclive_main_logo.svg
  • Product
    Back to all pages
    https://vcc.live/wp-content/uploads/2023/09/call-cetner-software-test-7.svg
    Call center

    Explore our call center software for driving productivity, fueling automation, and delivering exceptional CX.

    Powering Decathlon's call center

    https://vcc.live/wp-content/uploads/2022/09/Decathlon_Austria_Thumbnail.jpg
    Why VCC Brochure Security
    https://vcc.live/wp-content/uploads/2023/09/outbound-test-3.svg
    Outbound

    Handle more live calls, boost talk time, and automate outreach with a feature-filled outbound solution.

    Features to boost outbound activities

    Automatic dialing Voicemail detection Outbound IVR Over-the-phone payments

    Fueling your outbound sales

    https://vcc.live/wp-content/uploads/2023/09/boosting-sales-thumbnail-image.jpg
    Sales teams > Case studies > Collections >
    https://vcc.live/wp-content/uploads/2023/09/inbound-icon-3.svg
    Inbound

    Swiftly resolve issues, empower omnichannel, and handle volume with ease with our CX-focused solution.

    VCC live for inbound contact centers

    IVR systems Distributing calls (ACD) Call center scripting KPI dashboard

    Transforming customer service for tbi bank

    https://vcc.live/wp-content/uploads/2023/05/tbi-interview-banking.jpg
    Customer service > Case studies > Multichannel >
    https://vcc.live/wp-content/uploads/2023/09/omnichannel-test-3.svg
    Omnichannel

    Instantly switch between your customer's preferred channels and handle multiple conversations at once.

    Key channels VCC Live supports

    Voice SMS Email Chat software Chat apps Social media

    Email, social and more for SYKES and Huawei

    https://vcc.live/wp-content/uploads/2023/09/sykes-topnav-menu.svg
    WhatsApp > Messenger > Case studies >
    https://vcc.live/wp-content/uploads/2023/09/integrations-test-4.svg
    Integrations

    Connect VCC Live with any of your trusted business tools, including CRMs, payment tools, and much more.

    Selected integrations for VCC Live users

    Salesforce Hubspot Looker (Data Studio) Docusign Dialogflow Zapier

    Handle calls without leaving Salesforce

    https://vcc.live/wp-content/uploads/2023/06/salesforce-video-1.jpg
    Looker case study > Release center > Security >
  • Solutions
    Back to all pages
    https://vcc.live/wp-content/uploads/2023/08/sales-call-center-icon.svg
    Sales teams

    Connect and sell more than ever before with an automation-led solution for driving sales success.

    Powerful BI for next-level sales

    https://vcc.live/wp-content/uploads/2023/09/effective-communicatio-case-study-topnav.png
    https://vcc.live/wp-content/uploads/2023/08/customer-service-call-center-icon.svg
    Customer service

    Orchestrate a high-volume handling and resolution-focused approach that delights customers.

    92% of calls within SLA

    https://vcc.live/wp-content/uploads/2023/09/decathlon-case-study-topnav-2.png
    https://vcc.live/wp-content/uploads/2023/08/debt-collection-call-center-icon.svg
    Debt collection

    Make collections faster and simpler to speed up repayments and recover like never before.

    94% voicemail detection rate

    https://vcc.live/wp-content/uploads/2023/09/delfin-group-case-study-topnav.png
    https://vcc.live/wp-content/uploads/2023/10/ai-topnav-icon-2.svg
    AI and automation

    Drive intelligent productivity and efficiency with VCC Live's suite of AI and automation tools.

  • Industries
    Back to all pages
    BPO Retail Banking Insurance Consumer Lending Healthcare
  • Pricing
  • Resources
    Back to all pages
    Blog Case Studies Ebooks Call Center Courses Webinars Customer interviews Information Security Telco Services Learning Center Developers Release Center Download
  • Company
    Back to all pages

    Explore more

    About us Why VCC Live Careers News Partners

    Check out our history

    https://vcc.live/wp-content/uploads/2023/09/20yrs-anniversary-thumbnail.jpg
  • Partners
  • Become a partner
  • Email us
CONTACT US VIEW DEMO
Developer GuidesDatabase APIDatabaseManage RecordsAdd record
  • Overview
    • About Database API
    • The API location
    • Authentication and Security
    • Testing API
    • Request and Response
    • HTTP Response Codes
  • Examples
    • Hello World Example
    • Advanced Example
    • Web Callback Example
  • Reference
  • Project
    • List projects
    • List project outbound numbers
    • Get project parameters
    • Cloning projects
    • Get quota limits
    • Modify quota limits
  • Database
    • Manage Records
      • List records
      • Get detailed record information
      • Add record
      • Modify record
      • Modify contact
      • Batch record modification
    • Manage Fields and Values
      • Add field and values
      • Add new value(s) to a field
      • Modify value(s) of a field
      • Delete a value
    • Manage Dispositions
      • Add disposition
      • Batch disposition modification
    • Robinson list / DNC list
      • Add new value to Robinson list
      • Delete from Robinson list resource
  • Statistics
    • Dashboard API
    • Get CDR log
    • Get CDR log for a specified uuid
    • Get Email Log
    • Get voicefile for a specified CDR
    • Get inbound statistics
    • User state log
    • User-based statistics
    • User-based model
    • Number of available agents in a queue
    • User's Current Status
    • Get call statistics (deprecated)
  • Users
    • List users
    • Add new user
    • List teams
    • List all roles
    • List online users
    • List user activities
  • Archiver
    • Get the year and month when no voicefiles were archived
    • List all downloadable voice files in a given month
    • Set a successfully downloaded voicefile as archived
    • Download voice file
  • Campaign Manager
    • Get Database
    • Get Fields
    • Add Customer
    • Modify Customer
Back to Support and Learning Center
English Hungarian

Add record

Add one or more new records to a project database.

If the value field (that can handle only one value) contains text, then:

  • it finds the field value based on the text input, and sets it (based on the id)
  • if it does not find the field value, then it automatically creates a new field value

If the value field (that can handle more than one values) contains text, then:

  • it attempts to divide the text separated by the “|” character
  • if it doesn’t find any “|” character, then it handles it as one value

The followings apply to each separated values:

  • it finds the field value based on the text input, and sets it (based on the id)
  • if it does not find the field value, then it automatically creates a new field value
Request
Method POST
Resource https://[customer].asp.virtual-call-center.eu/v2/projects/[projectid]/records
Options N/A
Body Customized data, encoded in JSON.
Response
Body States whether the request is successful or not.

Request

Resource parameters

Name Type Mandatory Comment
customer string yes Your call centre’s unique identifier (subdomain).
projectid integer yes Unique project identifier.

Request object

Name Type Mandatory Comment
contacts object no Contains all contact data related to the client.
disposition object no Disposition for the given record to be set.
form object yes The record’s customized data, such as name, telephone number, address, city, likes, etc. can be set via the form key. If simple or multiple values are set, use ‘valueid’.
phone_field string no Which telephone number should be called next. Possible values: phone1, phone2…phone9
next_calldate string no This is the next time the record is due to be called, in YYYY-MM-DD hh:mm:ss format.
premium object no Agent and call centre commissions.

Note: If there’s a next_calldate provided in the disposition object, then it overrides the request object’s next_calldate command, as the disposition object’s next_calldate is positioned at a higher priority.

Contacts object

Name Type Mandatory Comment
email string no Email of the contact.
name string no Name of the contact.
phone string yes Phone number of the contact.
title string no Title of the contact e.g.: supervisor, Head of Customer Service.

Premium object

Name Type Mandatory Comment
commission string no Agent’s commission value connected to the record.
price string no Call centre commission value connected to the record.

Disposition object

Name Type Mandatory Comment
dispositionid integer yes Unique disposition identifier.
next_calldate string no If call-back or shared call-back type dispositions are set, this is the next time the record is due to be called, in YYYY-MM-DD hh:mm:ss format.
userid string yes Unique user identifier.
sendDispositionMessages boolean no If SMS and/or email sending is set up for the disposition, the SMS and/or email will be sent. Values: true, false

Response

Response object

Name Type Comment
response array Unique ‘numberid'(s) of the inserted record(s).

Example – Adding a Record

URL: https://mycc.asp.virtual-call-center.eu/v2/projects/134/records

Request body

{
    "next_calldate": "2020-11-11 11:11:11",
    "phone_field": "phone4",
    "form": {
        "name": "Peter Green",
        "city": "Budapest",
        "likes": "sports|movies"
    },
    "contacts": {
        "1": {
            "title": "Supervisor",
            "name": "Peter Green",
            "phone": "3619997400",
            "email": "[email protected]"
        },
        "4": {
            "phone": "3619996400"
        }
    },
    "premium": {
        "price": "100",
        "commission": "50"
    },
    "disposition": {
        "dispositionid": "1",
        "userid": "7",
        "next_calldate": "2015-07-20 10:26:55"
    }
}

Response body

{
     "response": [6],
     "errors": []
}

Example – Adding Multiple Records

URL: https://mycc.asp.virtual-call-center.eu/v2/projects/134/records

Request body

[
{
    "next_calldate": "2020-11-11 11:11:12",
    "phone_field": "phone4",
    "form": {
        "name": "Peter Green",
        "city": "Budapest",
        "likes": "sports|movies"
    },
    "contacts": {
        "1": {
            "title": "Supervisor",
            "name": "Peter Green",
            "phone": "3619997400",
            "email": "[email protected]"
        },
        "4": {
            "phone": "3619996400"
        }
    },
    "premium": {
        "price": "100",
        "commission": "50"
    },
    "disposition": {
        "dispositionid": "1",
        "userid": "7",
        "next_calldate": "2015-07-20 10:26:55"
    }
},
{
    "next_calldate": "2020-11-11 11:11:13",
    "phone_field": "phone4",
    "form": {
        "name": "Rachel Smith",
        "city": "London",
        "likes": "books|gadgets"
    },
    "contacts": {
        "1": {
            "title": "QA Assistant",
            "name": "Rachel Smith",
            "phone": "449997400",
            "email": "[email protected]"
        },
        "4": {
            "phone": "449997400"
        }
    },
    "premium": {
        "price": "100",
        "commission": "50"
    },
    "disposition": {
        "dispositionid": "1",
        "userid": "7",
        "next_calldate": "2015-07-21 15:26:55"
    }
}
]

Response body

{
"response":[7,8],
"errors":[]
}
Back to Support and Learning Center

Comments

Can’t find what you need? Use the comment section below to connect with others, get answers from our experts, or share your ideas with us.


There are no comments yet.

Click here to cancel reply.

Please note that by clicking on the Submit button, you agree to a member of VCC Live team contacting you with business offers. You can find detailed information on how we can establish contact with you in our Privacy Policy

illustration

Product

  • Call center
  • Outbound
  • Inbound
  • Omnichannel
  • Channels
  • Integrations
  • More on VCC

Main Features

  • IVR system
  • Auto dialer
  • Call queuing software
  • Automatic Call Distribution
  • Call center scripting tool
  • Outbound IVR
  • Predictive dialer
  • Voicemail detection
  • Contact center dashboard

Solutions

  • Customer Service
  • Sales Teams
  • Debt Collection
  • AI and Automation
  • BPO
  • Retail
  • Financial Services
  • Banking
  • Insurance
  • Consumer Lending
  • Healthcare

Resources

  • Blog
  • Case Studies
  • Ebooks
  • Call Center Courses
  • Information Security
  • Learning Center
  • Download
  • Telco services
  • Call center KPI library

Company

  • About us
  • Why VCC Live
  • Careers
  • News
  • Partners
https://vcc.live/wp-content/uploads/2022/03/iso-cert-1-min.png https://vcc.live/wp-content/uploads/2022/03/iso-cert-2-min.png https://vcc.live/wp-content/uploads/2022/03/iso-cert-3-min.png https://vcc.live/wp-content/uploads/2025/04/SOC2-website-e1745483442463.png

Social Media

https://vcc.live/wp-content/uploads/2022/03/linkedin-footer.svg https://vcc.live/wp-content/uploads/2022/03/twitter-footer.svg https://vcc.live/wp-content/uploads/2022/03/facebook-footer.svg https://vcc.live/wp-content/uploads/2022/03/instagram-footer.svg

Call us

https://vcc.live/wp-content/uploads/2022/03/flag-hu.png Hungary
+36 19996400
https://vcc.live/wp-content/uploads/2022/03/flag-en.png UK
+44 2086380169
https://vcc.live/wp-content/uploads/2022/03/flag-de.png Germany
+49 3021782516
https://vcc.live/wp-content/uploads/2022/03/flag-pl.png Poland
+48 123950886
https://vcc.live/wp-content/uploads/2022/03/flag-ro.png Romania
+40 31706167
https://vcc.live/wp-content/uploads/2022/03/flag-usa.png USA
+1 3024988337
  • Privacy Policy
  • Cookie Policy
  • Legal Statement
  • General Terms of Agreement
  • Magyar nyelvű jogi dokumentumok
illustration