TwiML™ Voice: <Reject>
O verbo <Reject>
rejeita uma chamada recebida para o seu número Twilio sem cobrar. Isso é muito útil para bloquear chamadas indesejadas.
Se o primeiro verbo em um documento TwiML é <Reject>
, a Twilio não atenderá a chamada. A chamada termina com um status de busy
ou no-answer
, dependendo do atributo do verbo reason
. Quaisquer verbos após <Reject>
são inacessíveis e ignorados.
Usar <Reject>
como o primeiro verbo em sua resposta é a única maneira de impedir que a Twilio atenda uma chamada. Qualquer outra resposta resultará em uma chamada atendida e sua conta será cobrada.
Se você estiver usando a API v2008 obsoleta da Twilio, <Reject>
resultará em um evento de faturamento, porque o estado da chamada mudará de inbound
para completed
para rejeitar a chamada. Usar <Reject>
com a API v2010, conforme descrito neste documento, não resultará em um evento de cobrança. Saiba como atualizar da API v2008 da Twilio para a API v2010 aqui.
Atributos do verbo
O verbo <Reject>
é compatível com os seguintes atributos que modificam seu comportamento:
Nome do atributo | Valores permitidos | Valor padrão |
---|---|---|
reason | rejected , busy |
rejected |
motivo
O atributo reason
recebe os valores rejected
e busy
. Isso informa à Twilio qual mensagem reproduzir ao rejeitar uma chamada. Selecionar busy
reproduzirá um sinal de
ocupado para o autor da chamada, enquanto selecionar rejected
reproduzirá uma resposta padrão fora de serviço. O padrão é rejected
.
Esta é uma preferência e o que é realmente reproduzido é determinado pelo provedor de serviços do autor da chamada, pois ele dita o que deseja reproduzir para o autor.
Regras de aninhamento
Você não pode aninhar nenhum verbo dentro de <Reject>
e nem aninhar <Reject>
em nenhum outro verbo.
Exemplos
Exemplo 1: Rejeitar uma chamada que esteja reproduzindo uma mensagem padrão fora de serviço
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.