Transcripciones de grabaciones
Una transcripción representa el texto y los metadatos transcritos de una grabación transcrita de una llamada de voz.
El texto de transcripción en sí es el resultado de convertir una grabación de audio en texto legible. Para generar transcripciones a partir de grabaciones de llamadas, utiliza el verbo TwiML<Record>
y establece transcribe="true"
. Ten en cuenta estas observaciones:
Se te cobrará a tu cuenta si solicitas la transcripción de una grabación, ya que se trata de una función de pago. Además, la transcripción está limitada actualmente a grabaciones iniciadas con el verbo TwiML <Record> y que tienen una duración máxima de dos minutos.
Para obtener información sobre precios, consulta la página de precios de transcripciones.
Transcription properties
Resource Properties in REST API format | |
---|---|
account_sid
|
El SID de la cuenta que creó el recurso de transcripción. |
api_version
|
La versión de la API utilizada para crear la transcripción. |
date_created
|
La fecha y hora en GMT en que se creó el recurso, especificadas en formato RFC 2822. |
date_updated
|
La fecha y hora en GMT en que se actualizó el recurso por última vez, especificadas en el formato RFC 2822. |
duration
|
La duración del audio transcrito en segundos. |
price
|
El cargo por la transcripción en la moneda asociada a la cuenta. Este valor se rellena una vez completada la transcripción, por lo que puede que no esté disponible inmediatamente. |
price_unit
|
Moneda en la que se mide el “precio”, en formato ISO 4127 (por ejemplo, “USD”, “EUR”, “JPY”). |
recording_sid
|
SID de la grabación a partir de la cual se creó la transcripción. |
sid
|
La cadena única que creamos para identificar el recurso de transcripción. |
status
|
El estado de la transcripción. Puede ser: “in-progress”, “completed”, “failed”. |
transcription_text
|
El contenido del texto de la transcripción. |
type
|
El tipo de transcripción. Solo puede ser: “fast”. |
uri
|
La URL del recurso, referente a “https://api.twilio.com”. |
Fetch a Transcription resource
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Transcriptions/{Sid}.json
Twilio responderá con los metadatos JSON para la transcripción. Si agregas “.txt
” al final del URI del recurso de transcripción, Twilio devolverá solo el texto de la transcripción:
/2010-04-01/Accounts/{AccountSid}/Transcriptions/{TranscriptionSid}.txt
Parameters
Parameters in REST API format | |
---|---|
account_sid
Path
|
El SID de la cuenta que creó el recurso de transcripción que se recuperará. |
sid
Path
|
La cadena proporcionada por Twilio que identifica de forma única el recurso de transcripción que se recuperará. |
Example 1
Read multiple Transcription resources
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Transcriptions.json
Devuelve el conjunto completo de transcripciones generadas a partir de todas las grabaciones de una cuenta.
La lista que Twilio devuelve incluye información de paginación.
Parameters
Parameters in REST API format | |
---|---|
account_sid
Path
|
El SID de la cuenta que creó los recursos de transcripción que se leerán. |
Example 1
También puedes acceder a una lista completa de transcripciones directamente desde una grabación determinada; para ello, pasa el valor de RecordingSid
al recurso de grabación:
/2010-04-01/Accounts/{YourAccountSid}/Recordings/{RecordingSid}/Transcriptions.json
El comando cURL para recuperar transcripciones de una grabación tiene el siguiente aspecto:
curl -G https://api.twilio.com/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Recordings/REXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Transcriptions.json \
-u 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_auth_token'
Si prefieres que Twilio responda con XML, cambia .json
a .xml
.
Delete a Transcription resource
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Transcriptions/{Sid}.json
Elimina una transcripción de tu cuenta.
Si la solicitud se realiza correctamente, Twilio devolverá HTTP 204 (Sin contenido) sin cuerpo.
Parameters
Parameters in REST API format | |
---|---|
account_sid
Path
|
El SID de la cuenta que creó los recursos de transcripción que se eliminarán. |
sid
Path
|
La cadena proporcionada por Twilio que identifica de forma exclusiva el recurso de transcripción que se eliminará. |
Example 1
¿Necesitas ayuda?
Todos la necesitamos a veces; la programación es difícil. Obtén ayuda ahora de nuestro equipo de soporte, o recurre a la sabiduría de la multitud visitando Stack Overflow Collective de Twilio o navegando por la etiqueta de Twilio en Stack Overflow.