1. Login to https://web.callhippo.com.
  2. Go to the Integrations tab.
  3. On the Integrations page, you will find the REST API.
  4. Go to the Webhook section.
  5. Click on the Connect button.




  • Provide URLs on which you want to get data of your call and SMS logs and click on Save.



Note:

  • Calling Activity: Upon enabling this, all the Call logs will be synced to the webhook URL.
  • SMS Activity: Upon enabling this, all the SMS logs will be synced to the webhook URL.
  • Call Status notification: Upon enabling this, all the call events will be synced to the webhook URL.
  • Call Notify: Available on Request only and works with predictive dialer. Upon enabling this whenever a call is picked by the receiver, the notification will be sent to the agent.


  1. We provide data by POST method in JSON format. 
  2. The URL should be an HTTP URL with POST method for which the GET method will have to be ensured from your end. After every call or SMS, we provide data by the POST method in JSON format. Sample data given below:


Call Activity Response Example:


{
  "type":string"call"
  "from":string"+15709894XXX"
  "to":string"+919724706XXX"
  "toNumber":string"+919724706XXX"
  "fromNumber":string"+15709894XXX"
  "callType":string"Outgoing"
  "duration":string"00:02"
  "durationSeconds":int2
  "status":string"Completed"
  "reason":string"IVR Message" // optional field
  "statusReason":string""
  "time":string"2025-06-23T13:13:50.000Z"
  "startTime":string"2025-06-23T13:13:50.000Z"
  "endTime":string"2025-06-23T13:13:58.000Z"
  "callCharge":string"0.06"
  "email":string"[email protected]"
  "adminEmail":string"[email protected]"
  "callSid":string"CA98d34afc6604c2ee36b7fb24d9308XXX"
  "countryName":string"India"
  "answeredDevice":string"web" // optional field
  "ringAnswerDuration":string"00:04"
  "billedMinutes":int1
  "hangupBy":string"Client"
  "tags":[1 item
  0:string"Test Tag"
  ]
  "dispositions":[1 item
  0:string"Test Dispo"
  ]
  "callQueue":boolfalse
  "dialCode":string"91"
  "totalCallDuration":int6
  "callerName":string"Shahezad Khorajiya" // optional field
  "note":string"Test" // optional field
  "recordingUrl":string"https://callhippo-media.s3.amazonaws.com593XX/callrecordings/CA98d34afc6604c2ee36b7fb24d93081XX.mp3" // optional field
  "extraParams" :  // optional field
        virtualNumber : "+916357891557"
        campaignId : "5007",
        agentId : "633fb717568eb306d3dc2ec6", 
        crmUniqueId : "17448046682131095"
    }



SMS Activity Response Example:


{
   "activityType": "sms",
   “content": "SMS text goes here",
   "from": "+9323243432",
   "to": "+41232132131",
   "smsType": "Outgoing",
   "status": "Completed",
   "time": "2020-05-12T00:53:57.688+0000",
   "smsCharge": "0.040",
   "email": "[email protected]", //optional field
   "smsSendBy": "Demo User", //optional field
   "adminEmail": "[email protected]", 
}


Call status notification response example:


{
   "agentEmail": "[email protected]",
   "callType": "Outgoing",
   "fromNumber": "+17xxxxxxxx6",
   "toNumber": "+13xxxxxxxx0",
   "agentId": "610xxxxxxxxxxxxxxxxxx8f3",
   "callSid": "8956bxxxxxxxxx-xxxxxx-xxxxxx02428",
   *"dateTime": "2024-03-28T10:05:50.000Z",
   "dialCode": "1",
   "status": "completed"
}


Webhook Response Parameters:


  • activityType: Possible values call / SMS.
  • from: From which number you got a call or you dial from number.
  • to: On which number you got a call or you dial to the number.
  • callType: Incoming / Outgoing.
  • duration: Duration of a call (MM:SS).
  • status: Call-related status. possible values are Completed, Missed, Rejected, Voicemail, Welcome message, IVR message, Unavailable, Cancelled and No Answer.
  • time: Call log created datetime.
  • startTime: Call start datetime.
  • endTime: Call end datetime.
  • callCharge: Call charges.
  • callerName: CallHippo user name who did or received a call. (Optional Field)
  • note: Call notes. (Optional Field)
  • recordingUrl: Recording URL of your call. (Optional Field)
  • extraParams: campaignId, agentId, crmUniqueId (Optional Field)
  • callSid: Unique ID of call.
  • email: Agent email associated with call or SMS.
  • adminEmail: CallHippo account owner email.
  • countryName: Name of calling country
  • reason:  Reason for call status. (Optional Field)
  • statusReason:  Reason for call not not set up or failed.
  • answeredDevice: Call answered device. possible values: “web”, “ios”, “android”. (Optional Field)
  • ringAnswerDuration: Call ringing duration. format: “mm:ss”.
  • billedMinutes: Total billed minutes for the call,
  • hangupBy: Who did hang up the call. Possible values: “Agent”, “Client”.
  • tags: If an agent added any tags in call notes will be returned in this field.
  • dispositions: If an agent added any dispositions in ACW screen it will be returned in this field.
  • callQueue: Whether the call went in the call queue or not. Possible values : true or false.
  • content: SMS text (if activity type is sms).
  • smsType: Incoming / Outgoing. 
  • smsCharge: SMS charges.
  • smsSendBy: The name of the agent who sent the SMS.