Automatização de Horários de Feriados no 3CX

Introdução

Este documento oferece um guia completo para a configuração de avisos de feriados e encaminhamento de chamadas no 3CX. Ele detalha dois métodos principais para gerenciar os fluxos de chamadas durante feriados: horários de feriados centralizados por departamento e o script de chamadas holiday.cs.

  • Os horários de feriados por departamento permitem que os administradores definam os feriados e as mensagens associadas a eles em nível departamental. Esses horários podem então ser aplicados automaticamente a diversos terminais, incluindo Filas, URAs, Grupos de Toque e Atendimento de Chamadas por Departamento, simplificando a manutenção e garantindo a consistência das mensagens de feriados em todo o sistema.
  • O script de chamadas holiday.cs oferece uma lógica de fluxo de chamadas altamente personalizável para requisitos de encaminhamento mais avançados ou específicos.

Horários de Feriados por Departamento

Essa funcionalidade permite definir feriados e mensagens associadas no nível do departamento, que podem então ser aplicadas dinamicamente a vários terminais.

Etapas de Configuração

  • Passo 1: Criar ou Selecionar um Departamento: Antes de definir feriados, certifique-se de que há um departamento configurado no 3CX. Se ainda não houver, será necessário criá-lo.
  • Acesse Admin > Departamentos.
  • Escolha um departamento existente ou clique em + Adicionar para criar um novo.

Lista de departamentos com opção de adicionar novo

  • Etapa 2: Definir Feriados do Departamento: Depois de criar um departamento, você pode definir feriados específicos e os comunicados associados a eles.
  • Vá para Admin > Horário de Atendimento.
  • Selecione o departamento correspondente (por exemplo, “Escritório da Itália”).
  • Clique na guia Feriados Oficiais.
  • Clique em + Adicionar para definir um novo feriado.
  • Digite um nome para o feriado (por exemplo, “Natal”).
  • Especifique a data do feriado (por exemplo, “25 de dezembro”).
  • Carregue ou selecione uma mensagem de aviso já existente para ser reproduzida durante este feriado (por exemplo, “Estaremos fechados no dia de Natal.”). Essa mensagem será associada de forma centralizada ao feriado.

Tela de configuração de feriados do escritório com opções de adicionar e listar feriados

  • Etapa 3: Atribuir o Calendário de Feriados do Departamento a um Endpoint: Por fim, configure os endpoints desejados para que utilizem o calendário de feriados do departamento.
  • Edite o endpoint específico (por exemplo, uma Fila, um Grupo de Chamadas, uma URA ou as configurações de Atendimento de Chamadas do próprio Departamento).
  • Localize a opção “Quando estiver de férias, encaminhar para”.
  • Altere esta opção para "Encerrar chamada" ou qualquer outra opção exceto a predefinida "Aceitar mesmo assim". Essa ação desbloqueia outras opções de anúncio de férias.
  • Ative a opção "Reproduzir Anúncio".
  • No menu suspenso, selecione “Reproduzir mensagem de feriado do departamento”.

Menu suspenso para selecionar prompt de anúncio de feriado

A rota de feriado do endpoint passará a resolver dinamicamente o anúncio do Feriado do Departamento ativo, mantendo seu destino normal.

Como Funcionam os Calendários de Feriados por Departamento

Quando um endpoint (como uma Fila, URA, Grupo de Chamadas ou Atendimento de Chamadas de um Departamento) é configurado para usar a opção “Reproduzir mensagem de feriado do departamento”, ele verificará automaticamente os feriados definidos para o Departamento ativo. Se um feriado estiver ativo, o sistema reproduzirá o anúncio de feriado associado e seguirá o encaminhamento de feriados configurado. Isso elimina a necessidade de atualizar manualmente as mensagens ou regras em cada endpoint para cada feriado.

Utilizando o Script de Chamada holiday.cs

O script de chamada holiday.cs é um recurso já existente que oferece funcionalidades avançadas para encaminhar chamadas em feriados para cenários específicos que podem não estar contemplados nos horários baseados em Departamentos.

O script holiday.cs permite uma lógica de fluxo de chamadas altamente personalizada com base em datas ou condições específicas. Ele pode ser modificado para implementar requisitos de encaminhamento exclusivos, como mensagens de voz diferentes para números DID distintos no mesmo feriado, ou encaminhamento condicional complexo.

Etapas de Configuração

  • Passo 1: Criar um Feriado
  • Acesse Admin > Horário de Atendimento.
  • Selecione o Departamento correspondente e clique na guia Feriados Oficias.
  • Adicione um novo feriado com um nome exclusivo (exemplo: Dia Nacional).
  • Passo 2: Prepare a Mensagem de Feriado
  • Grave ou crie um arquivo de áudio (formato .wav) para a mensagem de feriado (Exemplo: nationalday.wav) e faça o upload.
  • Etapa 3: Criar um Script de Processamento de Chamadas no 3CX
  • Faça login no seu Console de Admin e acesse Integrações > Scripts de Chamada.
  • Clique em Adicionar da Loja.
  • Selecione holiday.cs.

Tela de configuração de script de processamento de chamadas

  • Digite um nome para o script de chamada (deve conter apenas letras minúsculas, sem espaços).
  • Selecione como deseja que este script seja executado por meio da opção "Executar este script". Por exemplo, escolha Ao receber uma chamada em um Tronco SIP.
  • Atribua o script ao tronco SIP desejado.
  • Selecione um Departamento de sua preferência.
  • Clique em OK para continuar. Isso irá redirecioná-lo para a página do editor de código, que compilará automaticamente o script.

Tela de criação de script de processamento de chamadas

  • O conteúdo do código C# será carregado no editor de código.
  • Pressione Salvar para salvar o script e compilar o código.

Tela de edição de script de processamento de chamadas com código compilado

Quando a compilação for bem-sucedida, o script será executado assim que for detectada uma chamada recebida em qualquer DID do Tronco SIP atribuído.

Como Funciona o Script de Chamada Holiday.cs

  • Quando uma chamada é recebida no Tronco SIP designado, o script é acionado.
  • O script verifica se a data atual corresponde a algum dos feriados que você definiu.
  • Se for encontrada uma correspondência, o script reproduz o aviso de áudio de feriado que você criou na Etapa 2.
  • Se o dia cair num feriado, a chamada será encaminhada para o destino de feriado.

Quando Usar Cada Opção

Agendas de Feriados por Departamento

  • Recomendado para: A maioria dos cenários padrão de encaminhamento durante feriados, nos quais um aviso de feriado e um encaminhamento uniformes se aplicam a vários terminais dentro de um departamento.
  • Vantagens: Simplicidade, gerenciamento centralizado, esforço manual reduzido, aplicação dinâmica das regras de feriados.
  • Utilize quando: Você quiser definir um feriado uma única vez para um departamento e fazer com que todas as Filas, URAs e Grupos de Toque associados reproduzam automaticamente a mensagem de feriado correta e sigam o encaminhamento de chamadas para o feriado.

Script de Chamada holiday.cs

  • Recomendado para: Requisitos avançados ou altamente específicos de encaminhamento de chamadas durante feriados que não possam ser atendidos pelos horários definidos por departamento. Isso inclui lógica personalizada para DIDs encaminhados a usuários ou modificações específicas no fluxo de chamadas (por exemplo, encerrar uma chamada após um aviso ou excluir DIDs específicos).
  • Vantagens: Alta flexibilidade, lógica personalizada, controle detalhado do fluxo de chamadas.
  • Utilize quando: Você precisar implementar um encaminhamento exclusivo com base em DIDs específicos, condições complexas baseadas no tempo ou integrar-se a sistemas externos para obter informações sobre feriados. Este método requer familiaridade com a edição de scripts de chamadas.

Veja Também

Última Atualização

Este documento foi atualizado pela última vez em 4 de junho de 2026

https://www.3cx.com.br/docs/holiday-prompts/