Trigger AI Outbound Call

This API triggers an outbound call to the lead and initiates the conversation. It's an async API which triggers the call in the background and returns a call ID to track status. When the call is completed, a callback is sent to the registered callback URL as a POST request. The callback contains call_recording, call_transcript, summary and any other custom variable that you would want AI to ask.

NOTE: Please ensure you have shared the callback URL with Revspot team before hitting this API.

Trigger AI call for a lead

post

Endpoint to trigger AI call for a lead

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

emailstring · nullableOptional

namestringRequired

Lead name

phonestringRequired

Lead phone number

call_schedule_timestring · nullableOptional

Scheduled time for the call, leave empty to trigger immediately

lead_idstring · nullableOptional

If not provided, a UUID will be auto-generated

Responses

200

Success

application/json

messagestringOptionalExample: AI call lead request received

400

Bad Request

application/json

401

Unauthorized

application/json

post

https://api.revspot.ai/lead/ai_call

HTTPcURLJavaScriptPython

POST https://api.revspot.ai/lead/ai_call HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 90

{
  "email": "text",
  "name": "text",
  "phone": "text",
  "call_schedule_time": "text",
  "lead_id": "text"
}

{
  "message": "AI call lead request received"
}