INS 4.4 Use external API ingestion
Recordings can also be submitted programmatically, so a call recorded elsewhere is analysed without anyone uploading a file.
- Sélectionnez Paramètres, then expand Integration.
- Read the POST endpoint. It is on your own subdomain, in the form
https://<your-subdomain>/insights.api/api/v1/request-metadata/external. - Send the audio using one of two alternatives, one of which is required:
voice_file, the audio as binary form data.audio_url, a link to hosted audio.- Optionally include
payloadas a JSON object. - Set
Content-Typetomultipart/form-data. - Where the values are available and approved, include the common payload keys:
caller_name, the caller or customer name.callee_name, the agent or callee name.- After submission, watch Fichiers and Appel for the ingested record and its analysis.
Send callee_name on every request. It is the API equivalent of the Agent field on the upload form, and omitting it produces the same unassigned calls (see INS 5.2).
Use Copy to clipboard rather than retyping the endpoint. The Integration panel offers it for the method, the endpoint and the request example.