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

Menu

Expand
Classifique esta página:

Recurso de Chamada

Uma Chamada é um objeto que representa uma conexão entre um telefone e a Twilio.

Usando esse recurso, você pode iniciar uma chamada, buscar informações sobre uma chamada concluída, buscar uma lista de chamadas feitas de e para sua conta, redirecionar ou encerrar uma chamada em andamento e excluir registros de chamadas passadas de sua conta.

Uma chamada inbound ocorre quando uma pessoa liga para um dos números de telefone da Twilio, conexões de cliente ou endpoints habilitados para SIP. Uma chamada outbound ocorre quando você inicia uma chamada de um número de telefone da Twilio para um número de telefone externo, cliente ou domínio SIP.

Você pode iniciar uma chamada outbound POSTando no Recurso de Chamada, criando uma nova chamada.

Você também pode iniciar uma chamada a partir de uma chamada ativa (por exemplo, encaminhando para outro número ou discando para uma conferência) incluindo o verbo <Dial> do TwiML em seu aplicativo TwiML. No entanto, a única maneira de iniciar uma chamada diretamente da Twilio é com uma solicitação de API.

Você está procurando instruções passo a passo para fazer sua primeira chamada com a Twilio usando as bibliotecas auxiliares? Confira um dos nossos inícios rápidos na linguagem de programação de sua escolha: C#/.NET, Java, Node.js, PHP, Python ou Ruby.

Propriedades da chamada

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 de status da chamada

A seguir estão os valores possíveis para o parâmetro Status:

Status Descrição
queued (em fila) A chamada está pronta e aguardando na linha antes de discar.
ringing (tocando) A chamada está tocando no momento.
in-progress (em andamento) A chamada foi atendida e está em andamento no momento.
canceled (cancelado) A chamada foi desligada enquanto estava na fila ou tocando.
completed (concluído) A chamada foi atendida e terminou normalmente.
busy (ocupado) O autor da chamada recebeu um sinal de ocupado.
no-answer (sem resposta) Não houve resposta ou a chamada foi rejeitada.
falha A chamada não pôde ser concluída como discada, provavelmente porque o número de telefone não era existente.

Criar um Recurso de Chamada

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

As chamadas podem ser feitas por meio da API REST para números de telefone, endereços SIP ou identificadores de cliente. Para fazer uma nova chamada outbound, faça uma solicitação HTTP POST para o recurso de chamada da sua conta.

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

O SID da Account (Conta) para create (criar) o 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
        
        
        
        Forneça instruções do TwiML sobre o que deve acontecer quando a chamada for conectada.

        Crie um recurso de chamada com TwistML

        Forneça instruções do TwiML sobre o que deve acontecer quando a chamada for conectada.
        Example 2
              
              
              
              A Twilio fará uma solicitação síncrona para o URL especificado para recuperar instruções sobre como lidar com a chamada.

              Criar um recurso de chamada com o URL

              A Twilio fará uma solicitação síncrona para o URL especificado para recuperar instruções sobre como lidar com a chamada.
              Example 3
                    
                    
                    
                    Este exemplo define um StatusCallback para que a Twilio possa retornar informações sobre a chamada ao URL especificado.

                    Criar um Recurso de Chamada e especificar um URL de StatusCallback

                    Este exemplo define um StatusCallback para que a Twilio possa retornar informações sobre a chamada ao URL especificado.
                    Example 4
                          
                          
                          
                          Este exemplo faz uma chamada e solicita um retorno de chamada quando a chamada é iniciada.

                          Criar um Recurso de Chamada e especificar um StatusCallbackEvent

                          Este exemplo faz uma chamada e solicita um retorno de chamada quando a chamada é iniciada.

                          StatusCallback

                          Depois de concluir uma chamada outbound, a Twilio fará uma solicitação HTTP assíncrona ao StatusCallback especificado em sua solicitação (se houver).

                          Parâmetros enviados ao URL de StatusCallback

                          Quando a Twilio envia sua solicitação assíncrona para seu URL StatusCallback, ele inclui todos os seguintes parâmetros:

                          Parâmetro Descrição
                          CallSid Um identificador exclusivo para esta chamada, gerado pela Twilio.
                          AccountSid Seu ID da conta da Twilio. Ele tem 34 caracteres e sempre começa com as letras AC.
                          From

                          O número de telefone ou identificador do cliente da parte que iniciou a chamada.

                          Os números de telefone usam a formatação E.164, o que significa que eles começam com um + e um código de país, por exemplo +16175551212.

                          Os identificadores de cliente começam com o esquema URI client:; por exemplo, em uma chamada de um cliente chamado "charlie", o parâmetro From será client:charlie.

                          To (Para)

                          O número de telefone ou identificador do cliente da parte chamada.

                          Os números de telefone usam a formatação E.164, o que significa que eles começam com um + e um código de país, por exemplo +16175551212.

                          Os identificadores de cliente começam com o esquema URI client:; por exemplo, para uma chamada para um cliente chamado "joey", o parâmetro To será client:joey.

                          CallStatus

                          Um status descritivo para a chamada.

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

                          ApiVersion

                          A versão da API da Twilio usada para lidar com esta chamada.

                          Para chamadas recebidas, isso é determinado pela versão da API definida no número discado.

                          Para chamadas de saída, esta é a versão usada na solicitação da API REST da chamada de saída.

                          Direction

                          Uma string que descreve a direção da chamada:

                          inbound para chamadas inbound

                          outbound-api para chamadas iniciadas via API REST

                          outbound-dial para chamadas iniciadas por um verbo <Dial>.

                          ForwardedFrom

                          Este parâmetro pode ser definido quando a Twilio recebe uma chamada encaminhada. A operadora que encaminha a chamada determina o conteúdo do parâmetro.

                          Nem todas as operadoras oferecem suporte para a aprovação dessas informações.

                          Algumas operadoras fornecem essas informações ao fazer uma chamada direta para um número da Twilio.

                          CallerName Esse parâmetro é definido quando o IncomingPhoneNumber que recebeu a chamada definiu seu valor VoiceCallerIdLookup para true (US$ 0,01 por pesquisa).
                          ParentCallSid

                          Um identificador exclusivo para a chamada que criou este trecho.

                          Se este for o primeiro trecho de uma chamada, esse parâmetro não será incluído.

                          StatusCallbackEvent

                          Se você especificar qualquer evento de progresso de chamada no parâmetro StatusCallbackEvent, a Twilio fará uma solicitação assíncrona para o URL StatusCallback fornecido em sua solicitação POST.

                          Os eventos de progresso de chamada que você pode especificar são:

                          Evento Descrição
                          initiated (iniciado) A Twilio remove sua chamada da fila e inicia a discagem.
                          ringing (tocando) A chamada começa a tocar.
                          answered (atendido) A chamada é atendida. Se esse evento for especificado, a Twilio enviará um status in-progress.
                          completed (concluído) A chamada é concluída, independentemente do status de encerramento (que pode ser busy, cancelled, completed, failed ou no-answer). Se nenhum StatusCallbackEvent for especificado, completed (concluído) será acionado por padrão.

                          Quando esses eventos ocorrem, a solicitação StatusCallback da Twilio também incluirá estes parâmetros adicionais:

                          Parâmetro Descrição
                          CallStatus Um status descritivo para a chamada. O valor é um de queued, initiated, ringing, in-progress, busy, failed ou no-answer. Para obter mais detalhes, consulte os valores de CallStatus em nossa introdução ao TwiML.
                          Duration (Duração) A duração em minutos da chamada recém‐concluída; as chamadas são cobradas por minuto. Presente apenas no evento completed.
                          CallDuration A duração em segundos da chamada recém‐concluída. Presente apenas no evento completed.
                          SipResponseCode

                          O código SIP que resultou em uma chamada com falha.
                          Por exemplo, um número que não pode ser alcançado retornará 404, e se o valor de tempo‐limite tiver sido atingido antes da chamada conectada, esse código será 487.

                          Presente apenas no evento completed se CallStatus for failed ou no-answer.

                          RecordingUrl O URL do áudio gravado da chamada telefônica.
                          Esse parâmetro é incluído somente se Record=true estiver definido na solicitação da API REST e não incluir gravações iniciadas de outras maneiras. RecordingUrl está presente somente no evento completed.
                          O arquivo de gravação talvez ainda não esteja acessível quando o StatusCallback for enviado. Observação: Use RecordingStatusCallback para notificação confiável sobre quando a gravação estiver disponível para acesso.
                          RecordingSid O ID exclusivo da Gravação desta chamada. RecordingSid está presente somente com o evento completed.
                          RecordingDuration A duração do áudio gravado (em segundos). RecordingDuration está presente somente no evento completed. Para obter uma duração de gravação final precisa após um corte de silêncio, use RecordingStatusCallback.
                          Timestamp O carimbo de data/hora quando o evento foi disparado, fornecido como UTC no formato RFC 2822.
                          CallbackSource Uma cadeia de caracteres que descreve a origem do webhook. Isso é fornecido para ajudar a esclarecer por que o webhook foi feito. Em Retornos de Chamada de Status, esse valor é sempre call-progress-events.
                          SequenceNumber A ordem em que os eventos foram disparados, começando no 0. Embora os eventos sejam disparados em ordem, eles são feitos como solicitações HTTP separadas, e não há garantia de que eles chegarão na mesma ordem.

                          Para saber mais sobre o parâmetro StatusCallbackEvent e o que você pode esperar da Twilio durante e após uma chamada outbound, consulte nossa página de visão geral sobre making outbound calls (como fazer chamadas outbound).

                          RecordingStatusCallback

                          Se você solicitou uma gravação de sua chamada outbound e especificou um URL RecordingStatusCallback, a Twilio fará uma solicitação GET ou POST para esse URL quando a gravação estiver disponível.

                          A Twilio passará ao longo dos seguintes parâmetros para o seu URL RecordingStatusCallback:

                          Parâmetro Descrição
                          AccountSid O identificador exclusivo da conta responsável por esta gravação.
                          CallSid Um identificador exclusivo para a chamada associada à gravação. O CallSid sempre fará referência ao trecho principal de uma chamada de dois trechos.
                          RecordingSid O identificador exclusivo da gravação.
                          RecordingUrl O URL do áudio gravado.
                          RecordingStatus O status da gravação. Os valores possíveis são: in-progress, completed, absent.
                          RecordingDuration A duração da gravação, em segundos.
                          RecordingChannels O número de canais no arquivo de gravação final como um número inteiro. Os valores possíveis são 1,2.
                          RecordingStartTime O carimbo de data/hora de quando a gravação foi iniciada.
                          RecordingSource O método de início usado para criar esta gravação. Para gravações iniciadas quando Record=true for definido na API REST,OutboundAPI será retornado.
                          RecordingTrack A faixa de áudio gravada. Os valores possíveis são inbound, outbound ou both.

                          RecordingStatusCallbackEvent

                          Assim como você pode especificar eventos de progresso de chamada com StatusCallbackEvent, também é possível especificar quais alterações de status de gravação devem acionar um retorno de chamada para seu aplicativo.

                          Os valores de status de gravação disponíveis são:

                          Parâmetro Descrição
                          in-progress (em andamento) A gravação foi iniciada.
                          completed (concluído) A gravação está completa e disponível para acesso.
                          absent (ausente) A gravação está ausente e inacessível.

                          Esse parâmetro assume como padrão completed. Para especificar vários valores, separe‐os com um espaço.

                          Para pausar, retomar ou parar gravações, consulte o recurso Call Recording (Gravação de chamadas).

                          Buscar um Recurso de Chamada

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

                          Esta chamada de API retorna o Recurso de Chamada de uma chamada individual, identificada por seu CallSid. Este recurso é eventualmente consistente.

                          Para obter atualizações de status de chamada em tempo real, recomendamos o uso do StatusCallbackEvent na solicitação da API de saída ou o atributo statusCallbackEvent do verbo <Dial> do TwiML para o caso de chamadas filhas.

                          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
                                
                                
                                
                                Obtenha uma Chamada específica, conforme especificado por seu identificador exclusivo (CallSid).

                                Buscar um Recurso de Chamada

                                Obtenha uma Chamada específica, conforme especificado por seu identificador exclusivo (CallSid).

                                Gravações de chamadas

                                Você pode acessar o sub‐recurso da lista de Gravações em qualquer Chamada específica.

                                O seguinte retornará uma lista de todas as gravações geradas com uma determinada chamada (identificada por seu CallSid):

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

                                Consulte os documentos do recurso Call Recording (Gravação de chamadas) para obter as propriedades do recurso e os formatos de resposta.

                                Feedback de Chamada

                                Você pode acessar as informações de feedback de qualidade da chamada de uma determinada chamada telefônica solicitando o sub‐recurso Feedback em qualquer Chamada (identificado por seu CallSid):

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

                                Consulte também a documentação do recurso de Feedback Call Quality (Qualidade de chamada) para obter as propriedades e os formatos de resposta. Consulte também o recurso FeedbackSummary para obter informações resumidas sobre a qualidade da chamada.

                                Ler vários recursos de Chamada

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

                                Retorna uma lista de chamadas telefônicas feitas de e para uma conta, identificada por seu AccountSid.

                                Os parâmetros de string de consulta a seguir permitem filtrar e limitar a lista retornada a você pela API REST. Esses parâmetros diferenciam maiúsculas de 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
                                      
                                      
                                      
                                      Obtenha uma lista de todas as chamadas feitas ou recebidas pela sua conta da Twilio.

                                      Ler vários recursos de Chamada

                                      Obtenha uma lista de todas as chamadas feitas ou recebidas pela sua conta da Twilio.
                                      Example 2
                                            
                                            
                                            
                                            Filtra a lista de chamadas para retornar chamadas concluídas iniciadas em 6 de julho de 2009.

                                            Ler vários recursos de Chamada e filtrar por data de início

                                            Filtra a lista de chamadas para retornar chamadas concluídas iniciadas em 6 de julho de 2009.
                                            Example 3
                                                  
                                                  
                                                  
                                                  Filtra a lista de chamadas para retornar chamadas concluídas iniciadas em ou após a meia‑noite, 6 de julho de 2009.

                                                  Ler vários recursos de Chamada e filtrar por data "after start" (após o início)

                                                  Filtra a lista de chamadas para retornar chamadas concluídas iniciadas em ou após a meia‑noite, 6 de julho de 2009.
                                                  Example 4
                                                        
                                                        
                                                        
                                                        Filtra a lista de chamadas para retornar chamadas concluídas que começaram entre 4 de julho de 2009 e meia‑noite de 6 de julho de 2009.

                                                        Ler vários recursos de Chamada e filtrar por um período de tempo

                                                        Filtra a lista de chamadas para retornar chamadas concluídas que começaram entre 4 de julho de 2009 e meia‑noite de 6 de julho de 2009.
                                                        Example 5
                                                              
                                                              
                                                              
                                                              Filtra a lista de chamadas para retornar chamadas com o status "busy" (ocupado) que foram feitas com o número "To" (Para) especificado.

                                                              Ler vários recursos de Chamada e filtrar por status de chamada e número de telefone

                                                              Filtra a lista de chamadas para retornar chamadas com o status "busy" (ocupado) que foram feitas com o número "To" (Para) especificado.
                                                              Example 6
                                                                    
                                                                    
                                                                    
                                                                    Filtra a lista de chamadas para retornar chamadas feitas a partir de um dispositivo do Twilio Client chamado "charlie".

                                                                    Ler vários recursos de Chamada e filtrar por chamadas feitas a partir de um dispositivo específico

                                                                    Filtra a lista de chamadas para retornar chamadas feitas a partir de um dispositivo do Twilio Client chamado "charlie".

                                                                    Você pode anexar uma extensão .csv a qualquer URI de recurso para obter a representação CSV (Comma Separated Values, valores separados por vírgula). Especificar o CSV pode ser especialmente útil para registros de chamadas. Tente isto:

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

                                                                    Leia o guia para Returning JSON, CSV, and HTML (Retornar JSON, CSV e HTML) para obter mais informações sobre todas as representações alternativas disponíveis.

                                                                    Paginação

                                                                    Se você estiver usando a API REST da Twilio, a lista retornada a você incluirá informações de paginação.

                                                                    Se planeja solicitar mais registros do que caberá em uma única página, você pode usar o nextpageuri fornecido em vez de incrementar as páginas por número de página.

                                                                    O uso de nextpageuri para a paginação garante que sua próxima solicitação retome de onde você parou. Isso pode ajudar a impedir que você recupere dados duplicados se estiver fazendo ou recebendo chamadas ativamente.

                                                                    Todas as Twilio Helper Libraries (Bibliotecas auxiliares da Twilio) lidam com a paginação automaticamente. Você não precisa solicitar explicitamente páginas individuais ao usar uma Biblioteca auxiliar para buscar listas de recursos.

                                                                    Atualizar um recurso de Chamada

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

                                                                    A atualização de um recurso de Chamada permite que você modifique uma chamada ativa.

                                                                    A modificação de chamadas em tempo real permite interromper uma chamada em andamento e encerrá‐la ou fazer com que ela comece a processar o TwiML a partir de um novo URL ou do TwiML fornecido com modificação. A modificação de chamadas é útil para qualquer aplicativo em que você deseja alterar o comportamento de uma chamada em execução de forma assíncrona. Por exemplo, colocar música em espera, filas de chamadas, transferir chamadas ou forçar um desligamento.

                                                                    Ao usar POST em uma instância de Chamada específica, você pode redirecionar uma chamada que está em andamento ou encerrar uma chamada.

                                                                    Para obter orientações passo a passo sobre como modificar chamadas em andamento, consulte o tutorial Modify Calls in Progress (Modificar chamadas em andamento) no idioma de sua preferência na web.

                                                                    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
                                                                          
                                                                          
                                                                          
                                                                          Fornece novas instruções do TwiML para uma chamada em andamento.

                                                                          Atualizar uma Chamada em andamento com o TwiML

                                                                          Fornece novas instruções do TwiML para uma chamada em andamento.
                                                                          Example 2
                                                                                
                                                                                
                                                                                
                                                                                Redireciona uma chamada em andamento POSTando para a Chamada, definindo o novo destino no código hospedado no parâmetro do URL.

                                                                                Atualizar uma Chamada em andamento com o URL

                                                                                Redireciona uma chamada em andamento POSTando para a Chamada, definindo o novo destino no código hospedado no parâmetro do URL.
                                                                                Example 3
                                                                                      
                                                                                      
                                                                                      
                                                                                      Encerra uma chamada em andamento POSTando para a Chamada, especificando o status como "completed" (concluído).

                                                                                      Atualizar um recurso de Chamada para encerrar a chamada

                                                                                      Encerra uma chamada em andamento POSTando para a Chamada, especificando o status como "completed" (concluído).

                                                                                      Quando você redireciona uma chamada ativa para outro número de telefone, a Twilio cria uma instância de Chamada totalmente nova para esse novo número de telefone. A chamada original é a chamada principal e qualquer número adicional discado estabelece uma chamada secundária. As chamadas principal e secundária terão SIDs de Chamada com identificação exclusiva.

                                                                                      Observe que qualquer chamada principal que execute atualmente um <Dial> é considerada em andamento pela Twilio. Mesmo que você tenha redirecionado sua chamada inicial para um novo número, a chamada principal ainda estará ativa e, portanto, você deverá usar Status=completed para encerrá‐la.

                                                                                      Se os Enhanced SIP Features (Recursos SIP aprimorados) não estiverem ativados em sua conta, as chamadas secundárias não atendidas não poderão ser canceladas pela API REST, mas a chamada principal poderá ser modificada para apontar para o novo TwiML. Esta ação encerrará a chamada secundária.

                                                                                      Example 4
                                                                                            
                                                                                            
                                                                                            
                                                                                            Garante que você também especifique o URL ao atualizar o StatusCallback

                                                                                            Atualizar o StatusCallback de uma chamada ativa

                                                                                            Garante que você também especifique o URL ao atualizar o StatusCallback

                                                                                            Para atualizar um StatusCallback em uma Chamada, é necessário definir o Url na mesma instrução.

                                                                                            Excluir um recurso de Chamada

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

                                                                                            Isso excluirá um registro de chamada da sua conta. Depois que o registro for excluído, ele não aparecerá mais nos logs da API e do Portal da Conta.

                                                                                            Se bem‐sucedido, esse DELETE retornará um HTTP 204 (Sem conteúdo) sem corpo.

                                                                                            Observe que um erro ocorrerá se você tentar remover um registro de chamada para uma chamada que está em andamento.

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

                                                                                            O SID da Account (Conta) que criou os recursos de Chamada para delete (excluir).

                                                                                            sid
                                                                                            Path
                                                                                            delete sid<CA> Not PII

                                                                                            A SID de chamada fornecida pela Twilio que identifica exclusivamente o recurso de Chamada para delete (excluir)

                                                                                            Observação: Para chamadas com menos de 13 meses de idade, os recursos excluídos desse endpoint também serão excluídos nos arquivos de log. Chamadas com mais de 13 meses podem ser excluídas apenas por meio da API de Exportação em Massa.

                                                                                            Example 1
                                                                                                  
                                                                                                  
                                                                                                  

                                                                                                  Excluir um recurso de Chamada

                                                                                                  Retenção de recurso de Chamada

                                                                                                  Você pode recuperar recursos via GET para o endpoint /Calls 13 meses após a criação do recurso. Registros com mais de treze meses só podem ser recuperados via Exportação em Massa.

                                                                                                  Fornecemos um utilitário de Exportação em Massa no Console e via API. A Exportação em massa gerará arquivos S3 contendo um dia de dados por arquivo e entregará o link de download via webhook, e‐mail ou Console.

                                                                                                  Classifique esta página:

                                                                                                  Precisa de ajuda?

                                                                                                  Às vezes, todos nós precisamos; a programação é difícil. Receba ajuda agora da nossa equipe de suporte, ou confie na sabedoria da multidão navegando pelo Stack Overflow Collective da Twilio ou buscando a tag Twilio no Stack Overflow.

                                                                                                        
                                                                                                        
                                                                                                        

                                                                                                        Obrigado pelo seu feedback!

                                                                                                        Selecione o(s) motivo(s) para seu feedback. As informações adicionais que você fornece nos ajudam a melhorar nossa documentação:

                                                                                                        Enviando seu feedback...
                                                                                                        🎉 Obrigado pelo seu feedback!
                                                                                                        Algo deu errado. Tente novamente.

                                                                                                        Obrigado pelo seu feedback!

                                                                                                        thanks-feedback-gif