
Obtém ou define diversas informações sobre o canal. Itens adicionais podem estar disponíveis a partir do driver do canal; consulte a documentação específica do driver para obter detalhes. Qualquer item solicitado que não esteja disponível no canal atual retornará uma string vazia.
Exemplo: Exemplos padrão de itens CHANNEL; empurre um sub-rotina de tratamento de desligamento existente no local dialplan default,s,1 para o canal atual:
same => n,Set(CHANNEL(hangup_handler_push)=default,s,1)
; Defina a zona de tons atual para Alemanha (de)
same => n,Set(CHANNEL(tonezone)=de)
; Defina o número máximo permitido de tentativas de encaminhamento
same => n,Set(CHANNEL(max_forwards)=10)
; Se este canal for ejetado de sua próxima ponte e se
; o canal não for desligado, comece a executar o dialplan no
; local default,after-bridge,1
same => n,Set(CHANNEL(after_bridge_goto)=default,after-bridge,1)
; Registre o estado atual do canal
same => n,Log(NOTICE, This channel is: ${CHANNEL(state)})
Itens padrão (fornecidos por todas as tecnologias de canal) incluem:
amaflags - Flags de contabilização automática de mensagensaccountcode - Código de conta do canalchanneltype - Tecnologia usada para o canalstate - Estado do canalname - Nome do canaluniqueid - Identificador único da chamadalanguage - Idioma para sons reproduzidoshangup_handler_push/pop - Manipuladores de desligamentotonezone - Zona para indicações sonorasmax_forwards - Número máximo de encaminhamentos permitidosPara tecnologias específicas como DAHDI, IAX, OOH323 e PJSIP, existem itens adicionais específicos. Por exemplo, para PJSIP:
; Registre o Call-ID atual
same => n,Log(NOTICE, ${CHANNEL(pjsip,call-id)})
; Registre o endereço de destino do fluxo de áudio
same => n,Log(NOTICE, ${CHANNEL(rtp,dest)})
; Armazene o tempo de ida e volta associado a
; um fluxo de vídeo no campo CDR video-rtt
same => n,Set(CDR(video-rtt)=${CHANNEL(rtcp,rtt,video)})
A função CHANNEL() suporta parâmetros específicos por tecnologia, como informações RTP/RTCP para mídia, estatísticas de qualidade de chamada, informações de sessão SIP e configurações específicas de hardware para DAHDI.

