Webhooks

{primary} Webhooks allow for the call data generated by your Calldrip Account to be sent to a location of your choosing (i.e. your chosen CRM).

Webhooks allow for the call data generated by your Calldrip Account to be sent to a location of your choosing

How it works:


After an agent presses 1 and/or after the call, we send the call data in either JSON or XML format to the specified endpoint. These parameters can be added or changed via your Calldrip Account.

Parameters


Parameter Description
<time> 24-hr UTC
<date> Date the call was made on (YYYY-MM-DD)
<phone> (9876543210)
<id> Calldrip User ID
<calldrip_account_id> ID of the Calldrip account to which the call belongs
<calldrip_call_id> ID of the call
<alternate_id> Unique ID from lead source (ex. DealerSocket Lead ID)
<source_id> ID of the source the call came from
<source_name> Name of the source the call came from
<date_received> Date the call was received (YYYY-MM-DD)
<time_received> Time the call was received (24-hr UTC)
<call type=""> Inbound or outbound call (outbound or inbound)
<attempts> How many attempts were made
<duration> Duration of the call in seconds (seconds)
<recording_url> URL for the call recording
<whisper> Automated message given when call is first answered by agent
<status> Call status (answered, attempted, after hours, not called)
<ring_time> How long the before the call is answered in seconds (seconds)
<o_time> Call Origination Time; when the call came in (24-hr UTC)

Examples


Agent Presses 1 - JSON Example

{
  "calldrip_account_id": "123",
  "calldrip_account_name": "Calldrip Account",
  "calldrip_organization_id": "1",
  "lead": {
    "id": 12,
     "alternate_id": "bbb8e32e-cc1c-448c-8bf7-e2462c66efcb",
     "first_name": "Jon",
     "last_name": "Doe",
     "user_id": 1234,
     "phone_number": 5555555555,
     "email": "jon_doe@gmail.com",
    "notes": "Interested in used"
  },
  "agent": {
    "id": 32,
    "first_name": "Jon",
     "last_name": "Doe",
     "phone_number": 5555555555,
     "email": "jon_doe@gmail.com"  
  },
  "call": {
    "id": 432,
    "source_id": 32,
    "source_name": "Eigen Website",
     "attempts": 1,
     "duration": 100,
     "recording_url": "http://examplerecording.test",
     "inbound": false,
     "outbound": true,
     "whisper": "Interested in used",
     "status": "ANSWERED",
     "response_time": 10,
    "origination_time": 0,
    "date_received": "2018-07-18",
    "time_received": "12:31:44"
  },
  "vehicle_data": {
    "tradein": {
      "year": 2008,
      "make": "Toyota",
      "model": "Corolla",
      "vin": 9876543210,
      "registration_number": 345623109233,
      "status": "used"
    },
    "vehicle_of_interest": {
      "year": 2009,
      "make": "Toyota",
      "model": "Camry",
      "vin": 9876543210,
      "registration_number": 345623109233,
      "status": "used"
    }
  }
}

Agent Presses 1 - XML Example

<calldata>
    <calldrip_account_id>123</calldrip_account_id>
    <calldrip_account_name>Calldrip Account</calldrip_account_name>
    <calldrip_organization_id>1</calldrip_organization_id>
    <calldrip_call_id>342</calldrip_call_id>
    <alternate_id>342</alternate_id>
    <source_id>12</source_id>
    <source_name>"cars.com"</source_name>
    <date_received>"2018-07-18"</date_received>
    <time_received>"12:31:44"</time_received>
    <lead>
        <lead_id>12</lead_id>
        <alternate_id>483289</alternate_id>
        <name part="first">Jon</name>
        <name part="last">Doe</name>
        <phone>5555555555</phone>
        <email>"jon_doe@gmail.com"</email>
        <notes>Interested in Used</notes>
    </lead>
    <agent>
        <id>3</id>
        <name part="first">Fred</name>
        <name part="last">Johnson</name>
        <phone>5555555555</phone>
        <email>"fjohnson@gmail.com"</email>
    </agent>
    <call>
        <id>324</id>
        <source_id>432</source_id>
        <source_name>cars.com</source_name>
        <attempts>2</attempts>
        <duration>55</duration>
        <recording_url>http://examplerecording.test</recording_url>
        <inbound>false</inbound>
        <outbound>true</outbound>
        <whisper>Interested in Used</whisper>
        <status>ANSWERED</status>
        <response_time>21</response_time>
        <origination_time>0</origination_time>
    </call>
    <vehicle_data>
        <vehicle interest='buy'>
            <year>2009</year>
            <make>Honda</make>
            <model>Civic</model>
            <vin>9876543210</vin>
            <registration_number>345623109233</registration_number>
            <status>used</status>
        </vehicle>
        <vehicle interest='trade-in'>
            <year>2005</year>
            <make>Honda</make>
            <model>Accord</model>
            <vin>9876543210</vin>
            <registration_number>345623109233</registration_number>
            <status>used</status>
        </vehicle>    
    </vehicle_data>
</calldata>

After the Call - JSON Example

{
    "calldrip_account_id": 12345,
    "calldrip_account_name": "Calldrip Account",
    "calldrip_organization_id": "1",
    "lead": {
        "lead_id": 1234,
        "alternate_id": 324,
        "first_name": "Jon",
        "last_name": "Doe",
        "phone_number": "555-555-5555",
        "email": "jon_doe@gmail.com",
        "notes": "Interested in new but willing to see used"
    },
    "agent": {
        "id": 32,
        "first_name": "Fred",
        "last_name": "Johnson",
        "phone_number": "555-555-5555",
        "email": "fjohnson@gmail.com"
    },
    "call": {
        "id": 1234,
        "source_id": 7890,
        "source_name": "cars.com",
        "attempts": 1,
        "duration": 100,
        "recording_url": "http://examplerecording.test",
        "inbound": false,
        "outbound": true,
        "whisper": "One car please",
        "status": "ANSWERED",
        "response_time": 20,
        "origination_time": 0,
        "date_received": "2018-07-31",
        "time_received": "22:09:37"
    },
    "vehicle_data": {
        "tradein": {
            "year": 2008,
            "make": "Toyota",
            "model": "Corolla",
            "vin": 9876543210,
            "registration_number": 345623109233,
            "status": "used"
        },        
        "vehicle_of_interest": {
            "year": 2018,
            "make": "Chevrolet",
            "model": "Cruze",
            "vin": 1234567890,
            "registration_number": 523489022345,
            "status": "new"
        }
    }
}

After the Call - XML Example

<calldata>
    <calldrip_account_id>12345</calldrip_call_id>
    <calldrip_account_name>South Town Honda</calldrip_account>
    <calldrip_organization_id>1</calldrip_organization_id>
    <calldrip_call_id>32</calldrip_call_id>
    <alternate_id>4321</alternate_id>
    <source_id>7890</source_id>
    <source_name>cars.com</source_name>
    <date_received>2018-07-31</date_received>
    <time_received>22:15:21</time_received>
    <lead>
        <lead_id>1234</lead_id>
        <alternate_id>483289</alternate_id>
        <name part="first">Jon</name>
        <name part="last">Doe</name>
        <phone>555-555-5555</phone>
        <email>jon_doe@gmail.com</email>
    </lead>
    <agent>
        <id>42</id>        
        <name part="first">Fred</name>
        <name part="last">Johnson</name>
        <phone type="voice">555-555-5555</phone>
        <email>fjohnson@gmail.com</email>
    </agent>
    <call>
        <id>324</id>
        <source_id>432</source_id>
        <source_name>cars.com</source_name>
        <attempts>1</attempts>
        <duration>100</duration>
        <recording_url>http://examplerecording.test</recording_url>
        <inbound>false</inbound>
        <outbound>true</outbound>
        <whisper>Interested in used</whisper>
        <status>ANSWERED</status>
        <response_time>20</response_time>
        <origination_time>0</origination_time>
    </call>
    <vehicle_data>
        <vehicle interest="buy">
            <year>2018</year>
            <make>Chevrolet</make>
            <model>Cruze</model>
            <vin>1234567890</vin>
            <registration_number>523489022345</registration_number>
            <status>used</status>
        </vehicle>
        <vehicle interest="trade-in">
            <year>2008</year>
            <make>Toyota</make>
            <model>Corolla</model>
            <vin>9876543210</vin>
            <registration_number>345623109233</registration_number>
            <status>used</status>
        </vehicle>
    </vehicle_data>
</calldata>