Você pode importar as programações existentes para o Gerenciamento da força de trabalho (WFM) do Zendesk de um arquivo CSV. Isso ajuda você a mover dados de programação de outro sistema ou atualizar programações para vários agentes de uma só vez.

Qual é o meu plano?
Adicional Gerenciamento da força de trabalho (WFM) ou Gestão do engajamento da força de trabalho (WEM)

Resumo: ◀▼

É possível importar programações existentes usando um modelo CSV que exige correspondência exata do nome e do e-mail do agente. As programações importadas sobrescrevem os turnos que começam no mesmo dia, mas não removem os turnos noturnos sobrepostos nem os períodos de folga existentes. Você também pode exportar programações selecionando intervalos de datas e agentes, recebendo a exportação por e-mail. Certifique-se de que existam programações para o intervalo de datas escolhido para evitar exportações vazias.

Você pode importar as programações existentes para o Gerenciamento da força de trabalho (WFM) do Zendesk de um arquivo CSV. Isso ajuda você a mover dados de programação de outro sistema ou atualizar programações para vários agentes de uma só vez.

Você também pode exportar as programações como um arquivo CSV. Use o arquivo exportado para revisar os dados de programação, fazer atualizações em massa ou salvar uma cópia das programações.

Este artigo contém os seguintes tópicos:

  • Sobre a importação de programações
  • Importação de uma programação
  • Exportação de uma programação

Sobre a importação de programações

Você pode importar uma programação de duas maneiras: usar uma importação simplificada para definir a variante intradiária e para o WFM gerar tarefas intradiárias com base na previsão, ou usar uma importação avançada para definir cada tarefa manualmente.

Uso de uma importação simplificada (recomendado)

Com uma importação simplificada, você especifica o tempo de trabalho de cada agente e a variante intradiária que se aplica a seu turno. O WFM gera o turno da variante intradiária selecionada e suas tarefas configuradas. A hora de início no CSV determina quando o turno começa.

Quando você seleciona essa opção, é possível baixar dois arquivos de modelo:

  • As chaves de campo intradiário, que contêm a lista de todos os locais, nomes de turno, nomes de variante intradiária e IDs de variante intradiária.
  • O modelo de importação simplificada, que contém um exemplo de como o arquivo CSV deve ser formatado.

Use as chaves de campo intradiário para concluir o modelo de importação simplificada. Veja o exemplo a seguir.

Local Nome do turno Nome da variante intradiária ID da variante intradiária
Lisbon Turno automático 1 Turno da manhã 01234567-c4e1-4eb1-56gt09-fr45609kiuo

Em seguida, carregue o arquivo CSV de importação simplificada. Veja o exemplo a seguir.

agentName agentEmail intradayVariantName intradayVariantId startTime timeZone date endDate
Anna Noah a.noah@myemail.com P1 01234567-c4e1-4eb1-56gt09-fr45609kiuo 09:00 Europa/Varsóvia 2025-12-31 2026-01-31

A tabela a seguir lista os campos a serem incluídos no arquivo CSV de importação simplificada. A primeira linha do arquivo CSV deve ser a linha do cabeçalho e deve corresponder exatamente ao modelo.

Campo Requisito Descrição
agentName Opcional Somente para referência.
agentEmail Obrigatório O endereço de e-mail do agente.
intradayVariantName Opcional Somente para referência.
intradayVariantId Obrigatório O ID da variante intradiária a ser aplicado.
startTime Obrigatório A hora de início do turno.
timeZone Opcional O fuso horário do turno. Se estiver em branco, o WFM usará o fuso horário do local do turno do agente. Se fornecido, use um formato padrão, como UTC+01:00 ou GMT-02:00.
date Obrigatório A data de início do turno no formato YYYY-MM-DD.
endDate Opcional A data final no intervalo de datas do turno. O WFM cria um turno na hora de início especificada para cada dia de date até endDate. Se estiver em branco, o WFM cria um turno apenas na data definida no campo date.

Uso de uma importação avançada

Com uma importação avançada, você importa uma programação definindo manualmente cada tarefa.

Quando você seleciona essa opção, é possível baixar dois arquivos de modelo:

  • As chaves de campo intradiário contêm uma lista de todas as tarefas e respectivos IDs, incluindo:
    • Grupos de trabalho
    • Tarefas gerais ou status unificados do agente (ambos listados como generalTask)
    • Folga
  • O modelo de importação avançada, que contém um exemplo de como o arquivo CSV deve ser formatado.

Use as chaves de campo intradiário para concluir o modelo de importação avançada. Veja o exemplo a seguir.

agentName agentEmail taskType taskId taskName timeOffType startTime endTime
Anna Noah a.noah@myemail.com generalTask 303733 Almoço   2025-06-20T16:45:00+02:00 2025-06-20T17:45:00+02:00

A tabela a seguir lista os campos a serem incluídos no arquivo CSV de importação avançada. A primeira linha do arquivo CSV deve ser a linha do cabeçalho e deve corresponder exatamente ao modelo.

Campo Requisito Descrição
agentName Opcional O nome do agente. Esse campo é somente para referência.
agentEmail Obrigatório O endereço de e-mail do agente.
taskType Obrigatório O tipo de tarefa programada. Valores com suporte são workstream, generalTask e timeOff.
taskId Obrigatório para grupos de trabalho e tarefas gerais O ID exclusivo do grupo de trabalho ou da tarefa geral.
taskName Opcional O grupo de trabalho, a tarefa geral ou o nome de tipo de folga. Esse campo é somente para referência.
timeOffType Obrigatório para tarefas de folga O tipo de folga a ser aplicado quando taskType é timeOff.

Deixe esse campo em branco para grupos de trabalho e tarefas gerais.

startTime Obrigatório A data e a hora de início da tarefa em formato ISO 8601, incluindo o deslocamento do fuso horário.
endTime Obrigatório A data e a hora de término da tarefa em formato ISO 8601, incluindo o deslocamento do fuso horário.

Após a importação, a publicação dos turnos permanece cancelada. Para publicá-las, consulte Publicação da programação.

Observe as informações importantes a seguir antes de importar uma programação:

  • O WFM remove todos os turnos que começam no intervalo de datas importado de cada agente para evitar duplicatas. Todos os turnos são substituídos caso comecem no mesmo dia UTC.
  • O WFM não substitui a folga importada durante a importação da programação, podendo resultar em duas ou mais camadas de folga no mesmo período.
  • Caso haja sobreposições de turnos durante a noite, a importação não apaga a programação do dia anterior e pode criar sobreposições de turnos.
  • TimeOffType aceita somente os valores full-day e partial.
  • Quando preencher o modelo de importação, garanta que os nomes e endereços de e-mail dos agentes correspondam exatamente no Zendesk WFM. Todos os campos diferenciam maiúsculas de minúsculas e cada agente deve estar ativo. Para garantir a precisão, considere exportar a lista atual de agentes.
  • Quando várias linhas de CSV definem turnos para o mesmo agente em datas sobrepostas, as linhas posteriores no CSV substituem as linhas anteriores.

    Por exemplo, se o CSV incluir:

    1. 1 a 10 de janeiro: Modelo 2
    2. 2 a 4 de janeiro: Modelo 4
    3. 1 a 2 de janeiro: Modelo 3
    A programação resultante é:
    • 1 a 2 de janeiro: Modelo 3
    • 3 a 4 de janeiro: Modelo 4
    • 5 a 10 de janeiro: Modelo 2
  • O limite de tamanho do arquivo CSV importado é 5 MB.
  • Você pode importar programações com datas de até 2 anos no futuro e até 30 dias no passado.
  • A hora de início do turno do CSV se aplica a cada dia no intervalo de datas selecionado. O modelo intradiário, selecionado por ID, fornece apenas a duração do turno e a configuração da tarefa. O WFM ignora a hora de início do modelo intradiário e usa o valor do CSV no lugar.
  • O agente e a variante intradiária devem pertencer ao mesmo local.

Importação de uma programação

A importação de uma programação substitui permanentemente a programação existente. Certifique-se de que seus arquivos CSV usam a mesma estrutura dos arquivos de modelo.

Como importar uma programação

  1. Em Gerenciamento da força de trabalho, clique em Programação na barra lateral e selecione Programar.
  2. Clique no ícone de CSV.
  3. Selecione Importar programação.
  4. Selecione um método de importação:
    • Importação simplificada (recomendado)
    • Importação avançada
  5. Faça o upload do arquivo CSV.
  6. Clique em Importar programação.

    Uma vez carregado, seu arquivo é validado e processado no segundo plano. Você receberá uma notificação confirmando se a importação foi bem-sucedida ou falhou. Se a validação falhar, o WFM rejeitará o arquivo e destacará erros específicos no nível de linha para que você possa corrigi-los e recarregar.

Exportação de uma programação

Certifique-se de que o intervalo de datas da exportação inclui um rascunho ou uma programação publicada. Se nenhuma programação for inserida ou publicada, a exportação não conterá dados para o intervalo de datas e os usuários selecionados.

Como exportar uma programação

  1. Em Gerenciamento da força de trabalho, clique em Programação na barra lateral e selecione Programar.
  2. Clique no ícone de CSV.
  3. Selecione Exportar programação.
  4. Escolha se você quer exportar a Programação publicada ou a Versão preliminar.
  5. Selecione um Intervalo de datas.
  6. Clique na aba Agentes e selecione os agentes cuja programação você quer exportar.
  7. Clique em Exportar programação.

    Quando a exportação é concluída, o WFM envia o arquivo para seu endereço de e-mail.

Powered by Zendesk