Comandos básicos do Asterisk

A CLI do Asterisk mostra, em tempo real, o que acontece dentro da central. Dominar uma dúzia de comandos resolve a maior parte do dia a dia.

Leitura de 5 min · Atualizado em 2026

A linha de comando (CLI) é onde quem opera a central vê as chamadas vivas, recarrega configurações sem derrubar nada e descobre por que um ramal não registra. Abaixo, os comandos essenciais agrupados por tarefa — com o que cada um faz.

1 · Conectar asterisk -rvvv core set verbose 5 exit 2 · Recarregar core reload dialplan reload pjsip reload 3 · Inspecionar core show channels pjsip show endpoints dialplan show
Os três gestos do dia a dia: entrar, aplicar mudanças e olhar o que está vivo.

Entrar e sair da CLI

  • asterisk -rvvvConecta ao Asterisk que já está rodando. O -r é remote; cada v aumenta a verbosidade (detalhe na tela).
  • exitSai da CLI sem parar o serviço.

Verbosidade e depuração

  • core set verbose 5Aumenta o detalhe das mensagens já dentro da CLI, sem reconectar. core set verbose 0 volta ao silêncio.
  • core set debug 3Liga o debug interno para casos difíceis. Baixe para 0 depois — senão enche o disco.
  • logger show channelsMostra para onde os logs estão indo.

Recarregar sem derrubar a central

Você aplica mudanças sem reiniciar e sem interromper as chamadas em andamento. Recarregue só o que mexeu — é mais rápido e mais seguro.

  • core reloadRecarrega toda a configuração.
  • dialplan reloadAplica mudanças no roteiro de chamadas (dialplan).
  • pjsip reloadRecarrega ramais e troncos SIP (PJSIP).
  • module reload res_musiconhold.soRecarrega um módulo específico.

Ver chamadas ao vivo

  • core show channelsLista as chamadas em curso e o total.
  • core show channels conciseUma linha por canal — ótimo para scripts. Há também verbose para mais detalhe.
  • core show channel PJSIP/1001-00000007Abre os detalhes de uma chamada específica (use o nome do canal que apareceu na lista).

Endpoints e ramais (PJSIP)

Quando um ramal não registra ou um tronco não completa, a CLI conta a história:

  • pjsip show endpointsLista todos os ramais e troncos e o estado de cada um (registrado, indisponível…).
  • pjsip show endpoint 1001Abre os detalhes de um endpoint específico.
  • pjsip show registrationsMostra os registros ativos.
  • pjsip show contactsRevela quem está realmente conectado.
  • sip show peersEquivalente no canal SIP clássico, em instalações legadas.

Curiosidade

A CLI tem autocompletar: digite parte de um comando e aperte Tab que ela sugere o resto. E quase todo comando aceita ? ou help no fim para explicar o que faz.

Esses comandos são a base do dia a dia. A Saper opera essa engenharia em escala, monitorada 24h, no PABX Multi-Tenant e no Softswitch SPX.

Fontes: Asterisk Docs — Running Asterisk (CLI e conexão remota); Asterisk Docs — Asterisk Command Line Interface; Asterisk Docs — Configuring res_pjsip; Asterisk.org.

Operar Asterisk em escala sem dor de cabeça?

A Saper roda toda essa engenharia por você, monitorada 24h, no PABX Multi-Tenant — para o seu provedor focar em vender voz.

7 acessos nos últimos 30 dias

Leia também

Continue aprendendo