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 GuidesWebhookAsync Webhook RequestsCall Disposition (Async)
  • Overview
    • About Webhooks
    • Firewall Settings
    • Responding to Requests
    • Securing Requests
  • Setting up Webhooks
    • Setting up Global Webhooks
    • Setting up Project Specific Webhooks
    • Testing Webhook Requests
    • Using Dynamic URLs
    • Using Webhook Templates
  • Async Webhook Requests
    • About Async Webhook Requests
    • Call Disposition (Async)
    • Email (Async)
    • Chat (Async)
    • Payment Transaction (Async)
    • SMS (Async)
    • Ticket Status (Async)
    • User Created and User Changed (Async)
  • Sync Webhook Requests
    • About Sync Webhook Requests
    • IVR (Sync)
    • Project Login (Sync)
    • Search API (Sync)
  • Examples
    • Microsoft Teams messages
Back to Support and Learning Center

Call Disposition (Async)

When a disposition is set, the following object is sent to your site, encoded in JSON. For details about system default dispositions, see Dispositions.

Note: A Webhook request is only triggered if an agent user or the dialer sets a disposition. An admin or supervisor user setting a disposition will not generate a Webhook request.

Table of Contents

  • Request Object
  • Disposition object
  • Client Data object
  • Contacts object
  • Sample Request Body
  • Capturing Call Recording URL

Request Object

Name Type Comment
agent_description string Comment added by the agent.
agentName string The name of the agent.
client_data object Custom data object, including contacts.
closed integer Shows that the record is closed or the PPD dialer is going to call it later. Possible values:
– 1
– 0
create_time string Time of disposition setting in yyyy-mm-dd hh:mm:ss format.
destination string Called party’s phone number.
direction string Direction of the call that is terminated with the disposition:
– in
– out
disposition object Disposition object.
first_outbound_call_attempt string Time of the first call attempt, regardless of whether the call was successful or not. Format: yyyy-mm-dd hh:mm:ss
next_calldate string Time of next call scheduled for the record
nextContactId integer The ID of the next contact
numberid integer Record identifier.
phone_id integer Phone’s identifier.
projectid integer Project identifier.
projectName string The name of the project.
source string Calling party’s phone number.
sum_attempted_calls integer Total number of call attempts.
teamids array of integers Array of teamids.
timestamp string Time of disposition setting in ISO 8601 format.
userid integer Agent identifier.
username string Agent username.
uuid string Call identifier.
call_start_time string Time of the call’s start.
call_end_time string Time of the call’s end.
call_start_time_iso string Time of the call’s start in ISO 8601 format..
call_end_time_iso string Time of the call’s end in ISO 8601 format.
project_fields object The values of the project fields.
user_email string The user’s email address.

Disposition object

Name Type Comment
assesment string Disposition assessment:
– success: call recipient reached and call goal achieved
– ordered: call recipient reached
– failed: call recipient not reached
callback integer Disposition Webhook attribute. Possible values:
– 1
– 0
comission_collector integer Disposition commission collection possibility attribute. Possible values:
– 0
– 1
comment_mode string Defines the possibility for agents to write comments. Possible values:
– allow
– force
– disable
commission integer Call centre’s commission, as defined by supervisor.
default string Disposition system attribute. Possible values:
– yes
– no
description string Disposition comment, as provided by supervisor.
hide_history integer Disposition hide possibility attribute. Possible values:
– 0
– 1
id integer Disposition identifier in VCC’s database.
instant string Disposition auto-save possibility attribute. Possible values:
– yes
– no
label string Disposition export value, as provided by the supervisor.
mode string Disposition status. Possible values:
– active
– inactive
– deleted
name string Disposition name.
price integer Agent’s commission, as defined by supervisor.
quota string Disposition quota attribute. Possible values:
– yes
– no
recall integer The default call-back time, in seconds, as defined by the supervisor for the given disposition. It is set only if the status is ‘recall’ or ‘shared_recall’.
status string Disposition type, specifying the actual status of the record. Possible values: see on the link (status key).

Client Data object

Name Type Comment
phone1 string First phone number provided for the record
name string Name of the record
contacts object Contacts object, including contact data.

This object can include additional data that was added by the users via VCC Live interface or API. Additional data elements are either in string or array format. In case the additional data element is an array, it includes the following attributes:

Name Type Comment
valueid integer Value ID
fieldid integer Field ID
label string Label of the value
export_value string Export value
description string Description of the value

Contacts object

Name Type Comment
name string Name of contact
phone string Phone number of contact
email string Email address of contact
title string Title of contact
try_before_reach integer Number of call attempts before contact is reached.

Sample Request Body

{
    "disposition": {
        "name": "Successful",
        "assesment": "ordered",
        "status": "finished",
        "price": 0,
        "commission": 0,
        "description": "",
        "label": "",
        "recall": 0,
        "id": 14,
        "mode": "active",
        "quota": "no",
        "instant": "no",
        "default": "no",
        "commission_collector": 0,
        "hide_history": 0,
        "comment_mode": "allow",
        "callback": 1
    },
    "agent_description": "test",
    "closed": 0,
    "description": "test",
    "call_start_time": "2023-08-12 14:20:38",
    "call_start_time_iso": "2023-08-12T14:20:38+02:00",
    "call_end_time": "2023-08-12 14:21:38",
    "call_end_time_iso": "2023-08-12T14:21:38+02:00",
    "first_outbound_call_attempt": "2023-01-16 09:20:23",
    "next_calldate": "2023-08-17 15:30:00",
    "phone_id": 1,
    "sum_attempted_calls": 1,
    "direction": "out",
    "source": "3617777777",
    "project_fields": {
        "projectId": 1040,
        "values": {
            "Department": "telesales"
        }
    },
    "destination": "1234",
    "create_time": "2015-11-12 10:32:26",
    "uuid": "a7587a1a-2581-4dfe-b9eb-6a8ddb7caf0e",
    "projectid": 4,
    "projectName": "Test",
    "numberid": 25,
    "username": "rachel.smith",
    "user_email": "[email protected]",
    "agentName": "Rachel Smith",
    "nextContactId": null,
    "userid": 26,
    "teamids": [
        1
    ],
    "client_data": {
        "email": "[email protected]",
        "scenario": [
            {
                "valueid": 3,
                "fieldid": 7,
                "label": "Success",
                "export_value": "",
                "description": "1"
            }
        ],
        "name": "Rachel Smith",
        "amount": "100000",
        "pci_currency": [
            {
                "valueid": 8,
                "fieldid": 3,
                "label": "usd",
                "export_value": null,
                "description": ""
            }
        ],
        "phone1": "3630000000",
        "termekek": [
            {
                "valueid": 12,
                "fieldid": 10,
                "label": "Ticket",
                "export_value": "100000",
                "description": ""
            }
        ],
        "contacts": {
            "1": {
                "name": null,
                "phone": "3600000000",
                "email": null,
                "title": null
            }
        }
    },
    "timestamp": "2015-11-12T10:32:26+01:00"
}

Capturing Call Recording URL

You can send with the help of the call disposition webhook the URL of the call recording that was generated for the given call. In the webhook template, you need to add the following (“recordingfileUrl” can be replaced with any attribute of your choice). You need to populate TOKEN with a valid VCC Live Database API token and replace ‘myaccount’ with your account name:

“recordingfileUrl”: "https://myaccount:[email protected]/v2/cdr/current year/current month/current day/uuid/voicefile"

current year: replace with {{call_end_time|date(‘Y’)}}
current month: replace with {{call_end_time|date(‘m’)}}
current day: replace with {{call_end_time|date(‘d’)}}
uuid: replace with {{ uuid }}

Note: Keep in mind to whitelist the IPs in VCC from which you would like to retrieve the voice files.

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