This endpoint allows you to search and send calls for speech recognition based on various input filters (like duration, language, phrase, and more), and if transcription is complete, the results are sent automatically to your callback URL. It supports dynamic placeholders in the callback data to include call, speech, and user. The response initially provides a speech request ID and call IDs, while the full speech results are sent later to the callback URL.
Expected Input
callback_url: (string) The URL where the callback will be sent. (mandatory)
callback_method: (string) The HTTP method for the callback request. options: POST, PUT. (mandatory)
callback_data: (string) The data of the callback response action, JSON with placeholders. (mandatory)
token(string)
min_duration(integer)
max_duration(integer)
call_status(string)
from(DateTime)
till(DateTime)
language(string)
phrase(string)
summary(string)
rank_description(string)
rank_min(Integer 0-100)
rank_max(Integer 0-100)
limit(integer)
Allowed placeholders for callback_data:
Speech-related:
- {speech_result} - Speech result
- {speech_phrases} - Array of Speech phrases
- {speech_task_state} - Speech task's current state
- {speech_summary} - Text Summary of the call
- {speech_rank} - Rank of the call between 0 to 100
- {speech_rank_description} - Text of the speech recognition rank description
Call-related:
- {call_id} - Call Id
- {caller_user_id} - Caller User Id
- {caller_username} - Caller username
- {start_at} - Call Start At
- {end_at} - Call End At
- {agent_callerid_name} - Agent Caller Id name
- {agent_callerid_number} - Agent Caller Id number
- {call_duration} - Call duration
- {call_bill_duration} - Call bill duration
Expected Output
The response will be in JSON format and may include a speechRequestId and callIds object containing the details of calls that initiate to speech recognition service. while speech transcript will be ready, the request will initiate to your callback_url
**Important: The token used to create the speech transcription for a call will be the only token authorized to retrieve the speech recognition results.