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:

Recurso de llamada

Una llamada es un objeto que representa una conexión entre un teléfono y Twilio.

Con este recurso, puedes iniciar una llamada, obtener información sobre una llamada completada, obtener una lista de llamadas realizadas a tu cuenta y desde ella, redirigir o finalizar una llamada en curso y eliminar registros de llamadas pasadas de tu cuenta.

Una llamada entrante se produce cuando una persona llama a uno de tus números de teléfono de Twilio, conexiones de cliente o puntos finales habilitados para SIP. Una llamada saliente se produce cuando se inicia una llamada desde un número de teléfono de Twilio a un número de teléfono, cliente o dominio SIP externo.

Puedes iniciar una llamada saliente realizando un POST en el recurso de llamada, lo que creará una nueva llamada.

También puedes iniciar una llamada desde una llamada activa (p. ej., redirigir la llamada a otro número o marcar para entrar en una conferencia); para ello, incluye el verbo de TwiML <Dial> en tu aplicación de TwiML. Sin embargo, la única manera de iniciar una llamada directamente desde Twilio es con una solicitud de API.

¿Buscas instrucciones paso a paso para hacer tu primera llamada con Twilio mediante las bibliotecas auxiliares? Consulta una de nuestras guías de inicio rápido en el lenguaje de programación que desees: C#/.NET, Java, Node.js, PHP, Python o Ruby.

Propiedades de llamada

Resource Properties in REST API format
sid
sid<CA> Not PII

The unique string that we created to identify this Call resource.

date_created
date_time<rfc2822> Not PII

The date and time in GMT that this resource was created specified in RFC 2822 format.

date_updated
date_time<rfc2822> Not PII

The date and time in GMT that this resource was last updated, specified in RFC 2822 format.

parent_call_sid
sid<CA> Not PII

The SID that identifies the call that created this leg.

account_sid
sid<AC> Not PII

The SID of the Account that created this Call resource.

to

The phone number, SIP address, Client identifier or SIM SID that received this call. Phone numbers are in E.164 format (e.g., +16175551212). SIP addresses are formatted as name@company.com. Client identifiers are formatted client:name. SIM SIDs are formatted as sim:sid.

to_formatted

The phone number, SIP address or Client identifier that received this call. Formatted for display. Non-North American phone numbers are in E.164 format (e.g., +442071838750).

from

The phone number, SIP address, Client identifier or SIM SID that made this call. Phone numbers are in E.164 format (e.g., +16175551212). SIP addresses are formatted as name@company.com. Client identifiers are formatted client:name. SIM SIDs are formatted as sim:sid.

from_formatted

The calling phone number, SIP address, or Client identifier formatted for display. Non-North American phone numbers are in E.164 format (e.g., +442071838750).

phone_number_sid
sid<PN> Not PII

If the call was inbound, this is the SID of the IncomingPhoneNumber resource that received the call. If the call was outbound, it is the SID of the OutgoingCallerId resource from which the call was placed.

status
enum:status Not PII

The status of this call. Can be: queued, ringing, in-progress, canceled, completed, failed, busy or no-answer. See Call Status Values below for more information.

start_time
date_time<rfc2822> Not PII

The start time of the call, given as GMT in RFC 2822 format. Empty if the call has not yet been dialed.

end_time
date_time<rfc2822> Not PII

The time the call ended, given as GMT in RFC 2822 format. Empty if the call did not complete successfully.

duration
string Not PII

The length of the call in seconds. This value is empty for busy, failed, unanswered, or ongoing calls.

price
string? Not PII

The charge for this call, in the currency associated with the account. Populated after the call is completed. May not be immediately available.

price_unit
currency Not PII

The currency in which Price is measured, in ISO 4127 format (e.g., USD, EUR, JPY). Always capitalized for calls.

direction
string? Not PII

A string describing the direction of the call. Can be: inbound for inbound calls, outbound-api for calls initiated via the REST API or outbound-dial for calls initiated by a <Dial> verb. Using Elastic SIP Trunking, the values can be trunking-terminating for outgoing calls from your communications infrastructure to the PSTN or trunking-originating for incoming calls to your communications infrastructure from the PSTN.

answered_by
string Not PII

Either human or machine if this call was initiated with answering machine detection. Empty otherwise.

api_version
string Not PII

The API version used to create the call.

forwarded_from

The forwarding phone number if this call was an incoming call forwarded from another number (depends on carrier supporting forwarding). Otherwise, empty.

group_sid
sid<GP> Not PII

The Group SID associated with this call. If no Group is associated with the call, the field is empty.

caller_name

The caller's name if this call was an incoming call to a phone number with caller ID Lookup enabled. Otherwise, empty.

queue_time
string Not PII

The wait time in milliseconds before the call is placed.

trunk_sid
sid<TK> Not PII

The unique identifier of the trunk resource that was used for this call. The field is empty if the call was not made using a SIP trunk or if the call is not terminated.

uri
uri Not PII

The URI of this resource, relative to https://api.twilio.com.

subresource_uris
uri_map Not PII

A list of subresources available to this call, identified by their URIs relative to https://api.twilio.com.

Valores del estado de la llamada

Los siguientes son los valores posibles para el parámetro Status:

Estado Descripción
queued La llamada está lista y esperando su turno antes de marcar.
ringing La llamada está sonando actualmente.
in-progress Se contestó la llamada y está en curso.
canceled La llamada se colgó mientras estaba en cola o sonando.
completed Se contestó la llamada y se finalizó normalmente.
busy El agente de llamada recibió una señal de ocupado.
no-answer No hubo respuesta o se rechazó la llamada.
failed No se pudo completar la llamada como se marcó, probablemente porque el número de teléfono no existía.

Crear un recurso de llamada

post
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls.json

Las llamadas se pueden realizar a través de la API REST a números de teléfono, direcciones SIP o identificadores de cliente. Para realizar una nueva llamada saliente, realiza una solicitud HTTP POST al recurso de llamada de tu cuenta.

Parameters
Parameters in REST API format
account_sid
Path
post sid<AC> Not PII

El SID de la Account que creará el recurso.

to
Required
post endpoint PII MTL: 120 DAYS

The phone number, SIP address, or client identifier to call.

from
Required
post endpoint PII MTL: 120 DAYS

The phone number or client identifier to use as the caller id. If using a phone number, it must be a Twilio number or a Verified outgoing caller id for your account. If the to parameter is a phone number, From must also be a phone number.

method
Optional
post http_method Not PII

The HTTP method we should use when calling the url parameter's value. Can be: GET or POST and the default is POST. If an application_sid parameter is present, this parameter is ignored.

fallback_url
Optional
post url Not PII

The URL that we call using the fallback_method if an error occurs when requesting or executing the TwiML at url. If an application_sid parameter is present, this parameter is ignored.

fallback_method
Optional
post http_method Not PII

The HTTP method that we should use to request the fallback_url. Can be: GET or POST and the default is POST. If an application_sid parameter is present, this parameter is ignored.

status_callback
Optional
post url Not PII

The URL we should call using the status_callback_method to send status information to your application. If no status_callback_event is specified, we will send the completed status. If an application_sid parameter is present, this parameter is ignored. URLs must contain a valid hostname (underscores are not permitted).

status_callback_event
Optional
post string[] Not PII

The call progress events that we will send to the status_callback URL. Can be: initiated, ringing, answered, and completed. If no event is specified, we send the completed status. If you want to receive multiple events, specify each one in a separate status_callback_event parameter. See the code sample for monitoring call progress. If an application_sid is present, this parameter is ignored.

status_callback_method
Optional
post http_method Not PII

The HTTP method we should use when calling the status_callback URL. Can be: GET or POST and the default is POST. If an application_sid parameter is present, this parameter is ignored.

send_digits
Optional
post string Not PII

A string of keys to dial after connecting to the number, maximum of 32 digits. Valid digits in the string include: any digit (0-9), '#', '*' and 'w', to insert a half second pause. For example, if you connected to a company phone number and wanted to pause for one second, and then dial extension 1234 followed by the pound key, the value of this parameter would be ww1234#. Remember to URL-encode this string, since the '#' character has special meaning in a URL. If both SendDigits and MachineDetection parameters are provided, then MachineDetection will be ignored.

timeout
Optional
post integer Not PII

The integer number of seconds that we should allow the phone to ring before assuming there is no answer. The default is 60 seconds and the maximum is 600 seconds. For some call flows, we will add a 5-second buffer to the timeout value you provide. For this reason, a timeout value of 10 seconds could result in an actual timeout closer to 15 seconds. You can set this to a short time, such as 15 seconds, to hang up before reaching an answering machine or voicemail.

record
Optional
post boolean Not PII

Whether to record the call. Can be true to record the phone call, or false to not. The default is false. The recording_url is sent to the status_callback URL.

recording_channels
Optional
post string Not PII

The number of channels in the final recording. Can be: mono or dual. The default is mono. mono records both legs of the call in a single channel of the recording file. dual records each leg to a separate channel of the recording file. The first channel of a dual-channel recording contains the parent call and the second channel contains the child call.

recording_status_callback
Optional
post string Not PII

The URL that we call when the recording is available to be accessed.

recording_status_callback_method
Optional
post http_method Not PII

The HTTP method we should use when calling the recording_status_callback URL. Can be: GET or POST and the default is POST.

sip_auth_username
Optional
post string Not PII

The username used to authenticate the caller making a SIP call.

sip_auth_password
Optional
post string Not PII

The password required to authenticate the user account specified in sip_auth_username.

machine_detection
Optional
post string Not PII

Whether to detect if a human, answering machine, or fax has picked up the call. Can be: Enable or DetectMessageEnd. Use Enable if you would like us to return AnsweredBy as soon as the called party is identified. Use DetectMessageEnd, if you would like to leave a message on an answering machine. If send_digits is provided, this parameter is ignored. For more information, see Answering Machine Detection.

machine_detection_timeout
Optional
post integer Not PII

The number of seconds that we should attempt to detect an answering machine before timing out and sending a voice request with AnsweredBy of unknown. The default timeout is 30 seconds.

recording_status_callback_event
Optional
post string[] Not PII

The recording status events that will trigger calls to the URL specified in recording_status_callback. Can be: in-progress, completed and absent. Defaults to completed. Separate multiple values with a space.

trim
Optional
post string Not PII

Whether to trim any leading and trailing silence from the recording. Can be: trim-silence or do-not-trim and the default is trim-silence.

caller_id
Optional
post string Not PII

The phone number, SIP address, or Client identifier that made this call. Phone numbers are in E.164 format (e.g., +16175551212). SIP addresses are formatted as name@company.com.

machine_detection_speech_threshold
Optional
post integer Not PII

The number of milliseconds that is used as the measuring stick for the length of the speech activity, where durations lower than this value will be interpreted as a human and longer than this value as a machine. Possible Values: 1000-6000. Default: 2400.

machine_detection_speech_end_threshold
Optional
post integer Not PII

The number of milliseconds of silence after speech activity at which point the speech activity is considered complete. Possible Values: 500-5000. Default: 1200.

machine_detection_silence_timeout
Optional
post integer Not PII

The number of milliseconds of initial silence after which an unknown AnsweredBy result will be returned. Possible Values: 2000-10000. Default: 5000.

async_amd
Optional
post string Not PII

Select whether to perform answering machine detection in the background. Default, blocks the execution of the call until Answering Machine Detection is completed. Can be: true or false.

async_amd_status_callback
Optional
post url Not PII

The URL that we should call using the async_amd_status_callback_method to notify customer application whether the call was answered by human, machine or fax.

async_amd_status_callback_method
Optional
post http_method Not PII

The HTTP method we should use when calling the async_amd_status_callback URL. Can be: GET or POST and the default is POST.

byoc
Optional
post sid<BY> Not PII

The SID of a BYOC (Bring Your Own Carrier) trunk to route this call with. Note that byoc is only meaningful when to is a phone number; it will otherwise be ignored. (Beta)

call_reason
Optional
post string PII MTL: 120 DAYS

The Reason for the outgoing call. Use it to specify the purpose of the call that is presented on the called party's phone. (Branded Calls Beta)

call_token
Optional
post string Not PII

A token string needed to invoke a forwarded call. A call_token is generated when an incoming call is received on a Twilio number. Pass an incoming call's call_token value to a forwarded call via the call_token parameter when creating a new call. A forwarded call should bear the same CallerID of the original incoming call.

recording_track
Optional
post string Not PII

The audio track to record for the call. Can be: inbound, outbound or both. The default is both. inbound records the audio that is received by Twilio. outbound records the audio that is generated from Twilio. both records the audio that is received and generated by Twilio.

time_limit
Optional
post integer Not PII

The maximum duration of the call in seconds. Constraints depend on account and configuration.

url
Required if twiml, application_sid is not passed
post url Not PII

The absolute URL that returns the TwiML instructions for the call. We will call this URL using the method when the call connects. For more information, see the Url Parameter section in Making Calls.

twiml
Required if url, application_sid is not passed
post twiml Not PII

TwiML instructions for the call Twilio will use without fetching Twiml from url parameter. If both twiml and url are provided then twiml parameter will be ignored. Max 4000 characters.

application_sid
Required if url, twiml is not passed
post sid<AP> Not PII

The SID of the Application resource that will handle the call, if the call will be handled by an application.

Example 1
Loading Code Sample...
        
        
        Proporciona instrucciones TwiML sobre lo que debe suceder cuando se conecta la llamada.

        Crea un recurso de llamada con TwiML

        Proporciona instrucciones TwiML sobre lo que debe suceder cuando se conecta la llamada.
        Example 2
        Loading Code Sample...
              
              
              Twilio hará una petición sincrónica a la URL especificada para obtener instrucciones sobre cómo gestionar la llamada.

              Crea un recurso de llamada con una URL

              Twilio hará una petición sincrónica a la URL especificada para obtener instrucciones sobre cómo gestionar la llamada.
              Example 3
              Loading Code Sample...
                    
                    
                    En este ejemplo, se establece un StatusCallback para que Twilio pueda devolver información sobre la llamada a la dirección URL especificada.

                    Crea un recurso de llamada y especifica una URL de StatusCallback

                    En este ejemplo, se establece un StatusCallback para que Twilio pueda devolver información sobre la llamada a la dirección URL especificada.
                    Example 4
                    Loading Code Sample...
                          
                          
                          En este ejemplo, se realiza una llamada y se solicita una devolución de llamada cuando se inicia.

                          Crea un recurso de llamada y especifica un StatusCallbackEvent

                          En este ejemplo, se realiza una llamada y se solicita una devolución de llamada cuando se inicia.

                          StatusCallback

                          Después de completar una llamada saliente, Twilio hará una solicitud HTTP asíncrona a la URL de StatusCallback que especificaste en tu solicitud (si la hubiera).

                          Parámetros enviados a la URL de StatusCallback

                          Cuando Twilio envía su solicitud asíncrona a tu URL de StatusCallback, incluye todos los parámetros siguientes:

                          Parámetro Descripción
                          CallSid Un identificador único para esta llamada, generado por Twilio.
                          AccountSid Tu ID de cuenta de Twilio. Tiene 34 caracteres y siempre comienza con las letras AC.
                          De

                          El número de teléfono o identificador de cliente de la parte que inició la llamada.

                          Los números de teléfono utilizan el formato E.164, lo que significa que comienzan con un signo de + y el código de país, por ejemplo+16175551212.

                          Los identificadores de cliente comienzan con el esquema de URI client:; por ejemplo, en una llamada que realiza un cliente llamado “charlie”, el parámetro From seráclient:charlie.

                          To (Para)

                          El número de teléfono o identificador de cliente de la parte a la que se llama.

                          Los números de teléfono utilizan el formato E.164, lo que significa que comienzan con un signo de + y el código de país, por ejemplo+16175551212.

                          Los identificadores de cliente comienzan con el esquema de URI client:; por ejemplo, para una llamada realizada a un cliente llamado “joey”, el parámetro To seráclient:joey.

                          CallStatus

                          Un estado descriptivo de la llamada.

                          The value is one of the following: queued, initiated, ringing, in-progress, completed, busy, failed or no-answer.

                          ApiVersion

                          La versión de la API de Twilio que se utilizó para gestionar esta llamada.

                          En el caso de las llamadas entrantes, esto se determina según la versión de la API establecida en el número que se marca.

                          Para las llamadas salientes, esta es la versión utilizada en la solicitud de la API REST de la llamada saliente.

                          Direction

                          Una cadena que describe la dirección de la llamada:

                          inbound para llamadas entrantes

                          outbound-api para llamadas iniciadas a través de la API REST

                          outbound-dial para llamadas iniciadas por un verbo <Dial>.

                          ForwardedFrom

                          Este parámetro puede establecerse cuando Twilio recibe una llamada transferida. El operador móvil que transfiere la llamada determina el contenido del parámetro.

                          No todos los operadores móviles admiten el paso de esta información.

                          Algunos operadores móviles proporcionan esta información cuando realizan una llamada directa a un número de Twilio.

                          CallerName Este parámetro se establece cuando el IncomingPhoneNumber que recibió la llamada estableció su valor VoiceCallerIdLookup en true (USD 0,01 por búsqueda).
                          ParentCallSid

                          Un identificador único para la llamada que creó este tramo.

                          Si se trata del primer tramo de una llamada, este parámetro no se incluye.

                          StatusCallbackEvent

                          Si especificas cualquier evento de progreso de llamada en el parámetro StatusCallbackEvent, Twilio hará una solicitud asíncrona a la URL de StatusCallback que proporcionaste en tu solicitud de POST.

                          Los eventos de progreso de llamada que puedes especificar son estos:

                          Evento Descripción
                          initiated Twilio quita tu llamada de la cola y comienza a marcar.
                          ringing La llamada comienza a sonar.
                          answered Se contesta la llamada. Si se especifica este evento, Twilio enviará un estado in-progress.
                          completed La llamada se completa, independientemente del estado de finalización (que puede ser busy, cancelled, completed, failed o no-answer). Si no se especifica ningún StatusCallbackEvent, se indica como completada de forma predeterminada.

                          Cuando se producen estos eventos, la solicitud de StatusCallback de Twilio también incluirá estos parámetros adicionales:

                          Parámetro Descripción
                          CallStatus Un estado descriptivo de la llamada. El valor puede ser queued, initiated, ringing, in-progress, busy, failed o no-answer. Para obtener más información, consulta los valores de CallStatus en nuestra introducción a TwiML.
                          Duration La duración en minutos de la llamada que acaba de finalizar; las llamadas se facturan por minuto. Solo presente en el evento completed.
                          CallDuration La duración en segundos de la llamada que acaba de finalizar. Solo presente en el evento completed.
                          SipResponseCode

                          El código SIP que produjo un error en la llamada.
                          Por ejemplo, un número que no era accesible devolverá 404, y si el valor de Timeout (Tiempo de espera) se alcanzó antes de que la llamada se conectara, este código será 487.

                          Solo está presente en el evento completed si el estado de llamada esfailed o no-answer.

                          RecordingUrl La URL del audio grabado de la llamada telefónica.
                          Este parámetro solo se incluye si Record=true se establece en la solicitud de la API REST y no incluye las grabaciones iniciadas de otras formas. RecordingUrl solo está presente en el evento completed.
                          Es posible que no se pueda acceder al archivo de grabación cuando se envía la devolución de llamada de estado. Nota: Utiliza RecordingStatusCallback para obtener una notificación confiable cuando se pueda acceder a la grabación.
                          RecordingSid ID exclusivo de la grabación de esta llamada. RecordingSid solo está presente con el evento completed.
                          RecordingDuration La duración del audio grabado (en segundos). RecordingDuration solo está presente en el evento completed. Para obtener la duración exacta de la grabación después de cualquier recorte de silencio, utiliza RecordingStatusCallback.
                          Timestamp La marca de tiempo cuando se desencadenó el evento, dada como UTC en formato RFC 2822.
                          CallbackSource Una cadena que describe el origen del webhook. Esto se proporciona para ayudar a aclarar por qué se hizo el webhook. En las devoluciones de llamada de estado, este valor es siempre call-progress-events.
                          SequenceNumber Orden en el que se desencadenaron los eventos, empezando por 0. Aunque los eventos se desencadenan en orden, se realizan como solicitudes HTTP independientes y no hay garantía de que lleguen en el mismo orden.

                          Para obtener más información sobre el parámetro StatusCallbackEvent y lo que puedes esperar de Twilio durante y después de una llamada saliente, consulta nuestra página de descripción general sobre cómo realizar llamadas salientes.

                          RecordingStatusCallback

                          Si solicitaste una grabación de tu llamada saliente y especificaste una URL de RecordingStatusCallback, Twilio realizará una solicitud GET o POST a esa URL cuando la grabación esté disponible.

                          Twilio pasará los siguientes parámetros a tu URL de RecordingStatusCallback:

                          Parámetro Descripción
                          AccountSid El identificador exclusivo de la cuenta responsable de esta grabación.
                          CallSid Un identificador exclusivo de la llamada asociada a la grabación. CallSid siempre se referirá al tramo principal de una llamada de dos tramos.
                          RecordingSid El identificador exclusivo de la grabación.
                          RecordingUrl La URL del audio grabado.
                          RecordingStatus El estado de la grabación. Estos son los valores posibles: in-progress, completed, absent.
                          RecordingDuration La duración de la grabación, en segundos.
                          RecordingChannels La cantidad de canales en el archivo de grabación final como un entero. Los valores posibles son 1, 2.
                          RecordingStartTime La marca de hora de inicio de la grabación.
                          RecordingSource El método de inicio utilizado para crear esta grabación. Para las grabaciones iniciadas cuando Record=true se establece en la API REST, se devolverá OutboundAPI.
                          RecordingTrack La pista de audio grabada. Los valores posibles son inbound, outbound o both.

                          RecordingStatusCallbackEvent

                          Al igual que puedes especificar eventos de progreso de llamada con StatusCallbackEvent, también puedes especificar qué cambios de estado de grabación deben desencadenar una devolución de llamada a la aplicación.

                          Estos son los valores de estado de grabación disponibles:

                          Parámetro Descripción
                          in-progress La grabación comenzó.
                          completed La grabación está completa y se puede acceder a ella.
                          absent No está la grabación y no se puede acceder a ella.

                          El valor predeterminado de este parámetro es completed. Para especificar varios valores, sepáralos con un espacio.

                          Para pausar, reanudar o detener grabaciones, consulta el recurso de grabación de llamadas.

                          Obtén un recurso de llamada

                          get
                          https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls/{Sid}.json

                          Esta llamada de API devuelve el recurso de llamada de una llamada individual, identificada por su CallSid. Este recurso es , en última instancia, coherente.

                          Para obtener actualizaciones del estado de las llamadas en tiempo real, se recomienda utilizar StatusCallbackEvent en la solicitud de la API saliente o el atributo statusCallbackEvent del verbo de TwiML <Dial> en el caso de las llamadas secundarias.

                          Parameters
                          Parameters in REST API format
                          account_sid
                          Path
                          get sid<AC> Not PII

                          The SID of the Account that created the Call resource(s) to fetch.

                          sid
                          Path
                          get sid<CA> Not PII

                          The SID of the Call resource to fetch.

                          Example 1
                          Loading Code Sample...
                                
                                
                                Obtén una llamada específica, según lo detallado por su identificador único (CallSid).

                                Obtén un recurso de llamada

                                Obtén una llamada específica, según lo detallado por su identificador único (CallSid).

                                Grabaciones de llamadas

                                Puedes acceder al subrecurso de lista de grabaciones en cualquier llamada determinada.

                                Lo que aparece a continuación devolverá una lista de todas las grabaciones generadas con una llamada determinada (identificada por su CallSid):

                                /2010-04-01/Accounts/{YourAccountSid}/Calls/{CallSid}/Recordings

                                Consulta la documentación del recurso de grabación de llamadas para ver las propiedades del recurso y los formatos de respuesta.

                                Comentarios de llamada

                                Para acceder a la información de comentarios sobre la calidad de una llamada telefónica determinada, solicita el subrecurso de comentarios de cualquier llamada (identificado por su CallSid):

                                /2010-04-01/Accounts/{YourAccountSid}/Calls/{CallSid}/Feedback

                                Consulta la documentación del recurso de comentarios de calidad de la llamada para ver las propiedades y los formatos de respuesta. Consulta también el recurso FeedbackSummary para obtener información resumida sobre la calidad de las llamadas.

                                Leer varios recursos de llamada

                                get
                                https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls.json

                                Devuelve una lista de llamadas telefónicas realizadas a una cuenta y desde ella, identificada por su AccountSid.

                                Los siguientes parámetros de cadena de consulta permiten filtrar y limitar la lista devuelta por la API REST. Estos parámetros distinguen entre mayúsculas y minúsculas.

                                Parameters
                                Parameters in REST API format
                                account_sid
                                Path
                                get sid<AC> Not PII

                                The SID of the Account that created the Call resource(s) to read.

                                to
                                Optional
                                get phone_number PII MTL: 120 DAYS

                                Only show calls made to this phone number, SIP address, Client identifier or SIM SID.

                                from
                                Optional
                                get phone_number PII MTL: 120 DAYS

                                Only include calls from this phone number, SIP address, Client identifier or SIM SID.

                                parent_call_sid
                                Optional
                                get sid<CA> Not PII

                                Only include calls spawned by calls with this SID.

                                status
                                Optional
                                get enum:status Not PII

                                The status of the calls to include. Can be: queued, ringing, in-progress, canceled, completed, failed, busy, or no-answer.

                                start_time
                                Optional
                                get date_time_inequality<iso8601> Not PII

                                Only include calls that started on this date. Specify a date as YYYY-MM-DD in GMT, for example: 2009-07-06, to read only calls that started on this date. You can also specify an inequality, such as StartTime<=YYYY-MM-DD, to read calls that started on or before midnight of this date, and StartTime>=YYYY-MM-DD to read calls that started on or after midnight of this date.

                                end_time
                                Optional
                                get date_time_inequality<iso8601> Not PII

                                Only include calls that ended on this date. Specify a date as YYYY-MM-DD in GMT, for example: 2009-07-06, to read only calls that ended on this date. You can also specify an inequality, such as EndTime<=YYYY-MM-DD, to read calls that ended on or before midnight of this date, and EndTime>=YYYY-MM-DD to read calls that ended on or after midnight of this date.

                                Example 1
                                Loading Code Sample...
                                      
                                      
                                      Obtén una lista de todas las llamadas realizadas o recibidas por tu cuenta de Twilio.

                                      Leer varios recursos de llamada

                                      Obtén una lista de todas las llamadas realizadas o recibidas por tu cuenta de Twilio.
                                      Example 2
                                      Loading Code Sample...
                                            
                                            
                                            Filtra la lista de llamadas para devolver las llamadas finalizadas que se iniciaron el 6 de julio del 2009.

                                            Leer varios recursos de llamadas y filtrarlas por fecha de inicio

                                            Filtra la lista de llamadas para devolver las llamadas finalizadas que se iniciaron el 6 de julio del 2009.
                                            Example 3
                                            Loading Code Sample...
                                                  
                                                  
                                                  Filtra la lista de llamadas para devolver las llamadas finalizadas que se iniciaron a partir de la medianoche del 6 de julio del 2009.

                                                  Leer varios recursos de llamadas y filtrarlas por fecha “posterior al inicio”

                                                  Filtra la lista de llamadas para devolver las llamadas finalizadas que se iniciaron a partir de la medianoche del 6 de julio del 2009.
                                                  Example 4
                                                  Loading Code Sample...
                                                        
                                                        
                                                        Filtra la lista de llamadas para devolver las llamadas finalizadas que comenzaron entre la medianoche del 4 de julio del 2009 y la medianoche del 6 de julio del 2009.

                                                        Leer varios recursos de llamadas y filtrarlas por un intervalo de tiempo

                                                        Filtra la lista de llamadas para devolver las llamadas finalizadas que comenzaron entre la medianoche del 4 de julio del 2009 y la medianoche del 6 de julio del 2009.
                                                        Example 5
                                                        Loading Code Sample...
                                                              
                                                              
                                                              Filtra la lista de llamadas para devolver las llamadas con el estado “busy” (ocupado) realizadas con el número “To” (Para) especificado.

                                                              Leer varios recursos de llamadas y filtrarlas por estado de llamada y número de teléfono

                                                              Filtra la lista de llamadas para devolver las llamadas con el estado “busy” (ocupado) realizadas con el número “To” (Para) especificado.
                                                              Example 6
                                                              Loading Code Sample...
                                                                    
                                                                    
                                                                    Filtra la lista de llamadas para devolver las llamadas realizadas desde un dispositivo de Twilio Client llamado “charlie”.

                                                                    Leer varios recursos de llamadas y filtrar por llamadas realizadas desde un dispositivo específico

                                                                    Filtra la lista de llamadas para devolver las llamadas realizadas desde un dispositivo de Twilio Client llamado “charlie”.

                                                                    Puedes agregar una extensión .csv a cualquier URI de recurso para obtener una representación CSV (valores separados por comas). La especificación de CSV puede resultar especialmente útil para los registros de llamadas. Prueba esto:

                                                                    GET /2010-04-01/Accounts/{AccountSid}/Calls.csv

                                                                    Lee la guía para devolver JSON, CSV y HTML a fin de obtener más información sobre todas las representaciones alternativas disponibles.

                                                                    Paginación

                                                                    Si utilizas la API REST de Twilio, la lista que se te devuelve incluye información de paginación.

                                                                    Si tienes pensado solicitar más registros de los que caben en una sola página, puedes utilizar el nextpageuri proporcionado en lugar de aumentar las páginas por número de página.

                                                                    El uso de nextpageuri para la paginación garantiza que la siguiente solicitud se retome en el lugar en que la dejaste. Esto puede ayudarte a evitar que recuperes datos duplicados si realizas o recibes llamadas de forma activa.

                                                                    Todas las bibliotecas auxiliares de Twilio gestionan la paginación automáticamente. No es necesario solicitar explícitamente páginas individuales cuando se utiliza una biblioteca auxiliar para obtener listas de recursos.

                                                                    Actualizar un recurso de llamada

                                                                    post
                                                                    https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls/{Sid}.json

                                                                    La actualización de un recurso de llamada permite modificar una llamada activa.

                                                                    La modificación de llamadas en tiempo real te permite interrumpir una llamada en curso y terminarla o hacer que comience a procesar TwiML desde una nueva URL o desde el TwiML proporcionado con la modificación. La modificación de llamadas es útil para cualquier aplicación en la que desees cambiar el comportamiento de una llamada en ejecución de forma asíncrona, por ejemplo, música de espera, colas de llamadas, transferencia de llamadas o forzar una finalización.

                                                                    Al realizar POST en una instancia de llamada específica, puedes redirigir una llamada que está en curso o terminar una llamada.

                                                                    Para obtener orientación paso a paso sobre la modificación de llamadas en curso, consulta el tutorial Modificar llamadas en curso en el idioma web que elijas.

                                                                    Parameters
                                                                    Parameters in REST API format
                                                                    account_sid
                                                                    Path
                                                                    post sid<AC> Not PII

                                                                    The SID of the Account that created the Call resource(s) to update.

                                                                    sid
                                                                    Path
                                                                    post sid<CA> Not PII

                                                                    The Twilio-provided string that uniquely identifies the Call resource to update

                                                                    url
                                                                    Optional
                                                                    post url Not PII

                                                                    The absolute URL that returns the TwiML instructions for the call. We will call this URL using the method when the call connects. For more information, see the Url Parameter section in Making Calls.

                                                                    method
                                                                    Optional
                                                                    post http_method Not PII

                                                                    The HTTP method we should use when calling the url. Can be: GET or POST and the default is POST. If an application_sid parameter is present, this parameter is ignored.

                                                                    status
                                                                    Optional
                                                                    post enum:update_status Not PII

                                                                    The new status of the resource. Can be: canceled or completed. Specifying canceled will attempt to hang up calls that are queued or ringing; however, it will not affect calls already in progress. Specifying completed will attempt to hang up a call even if it's already in progress.

                                                                    fallback_url
                                                                    Optional
                                                                    post url Not PII

                                                                    The URL that we call using the fallback_method if an error occurs when requesting or executing the TwiML at url. If an application_sid parameter is present, this parameter is ignored.

                                                                    fallback_method
                                                                    Optional
                                                                    post http_method Not PII

                                                                    The HTTP method that we should use to request the fallback_url. Can be: GET or POST and the default is POST. If an application_sid parameter is present, this parameter is ignored.

                                                                    status_callback
                                                                    Optional
                                                                    post url Not PII

                                                                    The URL we should call using the status_callback_method to send status information to your application. If no status_callback_event is specified, we will send the completed status. If an application_sid parameter is present, this parameter is ignored. URLs must contain a valid hostname (underscores are not permitted).

                                                                    status_callback_method
                                                                    Optional
                                                                    post http_method Not PII

                                                                    The HTTP method we should use when requesting the status_callback URL. Can be: GET or POST and the default is POST. If an application_sid parameter is present, this parameter is ignored.

                                                                    twiml
                                                                    Optional
                                                                    post twiml Not PII

                                                                    TwiML instructions for the call Twilio will use without fetching Twiml from url. Twiml and url parameters are mutually exclusive

                                                                    time_limit
                                                                    Optional
                                                                    post integer Not PII

                                                                    The maximum duration of the call in seconds. Constraints depend on account and configuration.

                                                                    Example 1
                                                                    Loading Code Sample...
                                                                          
                                                                          
                                                                          Proporciona nuevas instrucciones TwiML a una llamada en curso.

                                                                          Actualizar una llamada en curso con TwiML

                                                                          Proporciona nuevas instrucciones TwiML a una llamada en curso.
                                                                          Example 2
                                                                          Loading Code Sample...
                                                                                
                                                                                
                                                                                Redirige una llamada en curso realizando POST en la llamada, lo que establece el nuevo destino en el código alojado en el parámetro de la URL.

                                                                                Actualizar una llamada en curso con URL

                                                                                Redirige una llamada en curso realizando POST en la llamada, lo que establece el nuevo destino en el código alojado en el parámetro de la URL.
                                                                                Example 3
                                                                                Loading Code Sample...
                                                                                      
                                                                                      
                                                                                      Finaliza una llamada en curso realizando POST en ella; esto establece el estado como “completed” (completada).

                                                                                      Actualizar un recurso de llamada para finalizarla

                                                                                      Finaliza una llamada en curso realizando POST en ella; esto establece el estado como “completed” (completada).

                                                                                      Al redirigir una llamada activa a otro número de teléfono, Twilio crea una instancia de llamada completamente nueva para ese nuevo número de teléfono. La llamada original es la llamada principal, y cualquier número adicional marcado establece una llamada secundaria. Las llamadas principales y secundarias tendrán SID de llamada de identificación única.

                                                                                      Ten en cuenta que Twilio considera que está en curso cualquier llamada principal que esté ejecutando actualmente un <Dial>. Incluso si redirigiste la llamada inicial a un nuevo número, la llamada principal sigue activa y, por lo tanto, debes utilizar Status=completed para finalizarla.

                                                                                      Si las funciones SIP mejoradas no están activadas en tu cuenta, las llamadas secundarias no contestadas no se pueden cancelar a través de la API REST, pero la llamada principal se puede modificar para que apunte a un nuevo TwiML. Esta acción finalizará la llamada secundaria.

                                                                                      Example 4
                                                                                      Loading Code Sample...
                                                                                            
                                                                                            
                                                                                            Asegúrate de especificar también la dirección URL al actualizar StatusCallback

                                                                                            Actualizar StatusCallback de una llamada activa

                                                                                            Asegúrate de especificar también la dirección URL al actualizar StatusCallback

                                                                                            Para actualizar StatusCallback en una llamada, es necesario establecer la Url en la misma afirmación.

                                                                                            Eliminar un recurso de llamada

                                                                                            delete
                                                                                            https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls/{Sid}.json

                                                                                            Esto eliminará un registro de llamadas de tu cuenta. Una vez eliminado el registro, ya no aparecerá en los registros de la API y el portal de la cuenta.

                                                                                            Si se realiza correctamente, esta ELIMINACIÓN devuelve un HTTP 204 (Sin contenido) sin cuerpo.

                                                                                            Ten en cuenta que se producirá un error si intentas eliminar el registro de una llamada que está activamente en curso.

                                                                                            Parameters
                                                                                            Parameters in REST API format
                                                                                            account_sid
                                                                                            Path
                                                                                            delete sid<AC> Not PII

                                                                                            El SID de la Cuenta que creó los recursos de llamada que se eliminarán.

                                                                                            sid
                                                                                            Path
                                                                                            delete sid<CA> Not PII

                                                                                            El SID de llamada proporcionado por Twilio que identifica de forma exclusiva el recurso de llamada que se eliminará.

                                                                                            Nota: Para las llamadas con menos de 13 meses de antigüedad, los recursos eliminados de este punto final también se eliminarán de los archivos de registro. Las llamadas de más de 13 meses solo se pueden eliminar a través de la API de exportación masiva.

                                                                                            Example 1
                                                                                            Loading Code Sample...
                                                                                                  
                                                                                                  

                                                                                                  Eliminar un recurso de llamada

                                                                                                  Retención de recursos de llamadas

                                                                                                  Puedes recuperar recursos mediante la realización de GET al punto final /Calls durante 13 meses después de crear el recurso. Los registros de más de 13 meses solo se pueden recuperar mediante exportación masiva.

                                                                                                  Proporcionamos una utilidad de exportación masiva en la consola y a través de la API. La exportación masiva generará archivos S3 que contienen un día de datos por archivo y enviará el enlace de descarga a través del webhook, el correo electrónico o la consola.

                                                                                                  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.

                                                                                                  Loading Code Sample...
                                                                                                        
                                                                                                        
                                                                                                        

                                                                                                        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