You are viewing the Spanish (Mexico) site, but your language preference is set to English. Switch to English site →

Menu

Expand
Calificar esta página:

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
sid<AC> Not PII

El SID de la cuenta que creó el recurso de transcripción.

api_version
string Not PII

La versión de la API utilizada para crear la transcripción.

date_created
date_time<rfc2822> Not PII

La fecha y hora en GMT en que se creó el recurso, especificadas en formato RFC 2822.

date_updated
date_time<rfc2822> Not PII

La fecha y hora en GMT en que se actualizó el recurso por última vez, especificadas en el formato RFC 2822.

duration
string Not PII

La duración del audio transcrito en segundos.

price
decimal Not PII

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
currency Not PII

Moneda en la que se mide el “precio”, en formato ISO 4127 (por ejemplo, “USD”, “EUR”, “JPY”).

recording_sid
sid<RE> Not PII

SID de la grabación a partir de la cual se creó la transcripción.

sid
sid<TR> Not PII

La cadena única que creamos para identificar el recurso de transcripción.

status
enum:status Not PII

El estado de la transcripción. Puede ser: “in-progress”, “completed”, “failed”.

transcription_text

El contenido del texto de la transcripción.

type
string Not PII

El tipo de transcripción. Solo puede ser: “fast”.

uri
uri Not PII

La URL del recurso, referente a “https://api.twilio.com”.

Fetch a Transcription resource

get
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
get sid<AC> Not PII

El SID de la cuenta que creó el recurso de transcripción que se recuperará.

sid
Path
get sid<TR> Not PII

La cadena proporcionada por Twilio que identifica de forma única el recurso de transcripción que se recuperará.

Example 1
        
        
        

        Obtén una transcripción específica

        Read multiple Transcription resources

        get
        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
        get sid<AC> Not PII

        El SID de la cuenta que creó los recursos de transcripción que se leerán.

        Example 1
              
              
              

              Leer: mostrar todas las transcripciones

              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

              delete
              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
              delete sid<AC> Not PII

              El SID de la cuenta que creó los recursos de transcripción que se eliminarán.

              sid
              Path
              delete sid<TR> Not PII

              La cadena proporcionada por Twilio que identifica de forma exclusiva el recurso de transcripción que se eliminará.

              Example 1
                    
                    
                    

                    Eliminar una transcripción

                    Calificar esta página:

                    ¿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.

                          
                          
                          

                          Gracias por tus comentarios.

                          Selecciona los motivos de tus comentarios. La información adicional que nos brindas nos ayuda a mejorar nuestra documentación:

                          Enviando tus comentarios…
                          🎉 Gracias por tus comentarios.
                          Se produjo un error. Inténtalo de nuevo.

                          Gracias por tus comentarios.

                          thanks-feedback-gif