This is an internal API used by PBX servers.
It is invoked when a recording has completed and the employee who owns the recording wants to receive it via e-mail. The e-mail is sent to the employees own e-mail address.
The e-mail has the same content as the E-mail endpoint - in this order, and only when present on the recording:
The e-mail is written in the employees language (Danish or English).
When the owner of the recording has automatic transcription enabled (recording.transcribe is not DISABLED), this endpoint does not send the e-mail before the transcription and the AI summary are stored on the recording. Without that wait the e-mail is rendered without them, as the PBX invokes Transcribe auto and this endpoint as two independent requests.
The request may therefore take minutes to reply - far longer than the PBX HTTP timeout. That is harmless: the e-mail is sent whether or not the PBX is still waiting for the reply. A PBX retry does not send a second e-mail - the recording is claimed in pbxRecordingEmailSent for 15 minutes and the retry replies with sent set to false.
| URL | https://api.telecomx.dk/pbx/recording/RECORDING_ID/send | ||
|---|---|---|---|
| Method | GET | ||
| Access level | None - may only be invoked from PBX server IP addresses. | ||
| Params | RECORDING_ID | String | Id of recording to e-mail. |
https://api.telecomx.dk/pbx/recording/1234578901234567890ABCD/send
| JSON object | ||
|---|---|---|
| success | Boolean | True on success |
| sent | Boolean | True when this request sent the e-mail, false when the recording had already been e-mailed within the last 15 minutes (a PBX retry) |
{ "success": true, "sent": true }
| Error code | Message | Description |
|---|---|---|
| 403 | access_denied | Not invoked from a PBX server |
| 404 | not_found | Recording not found |
| 404 | employee | Recording is a common recording with no employee, or the employee has no e-mail address |
| 500 | internal_error | <Unspecified> |