Uso de campos de ticket personalizados e formulários de ticket com o Web Widget (clássico)

Qual é o meu plano?

O Web Widget (clássico) permite que você personalize as informações exibidas em seu formulário de contato de diversas maneiras. Neste artigo, discutiremos as seguintes personalizações:

• Adição de campos de ticket personalizados ao formulário de contato padrão do Web Widget (clássico)
• Remoção do campo do nome no formulário de contato padrão e nos formulários de ticket
• Transformação do campo do nome no formulário de contato padrão e nos formulários de ticket em um campo obrigatório
• Uso de vários formulários de ticket com o Web Widget (clássico)

Este artigo inclui os tópicos a seguir:

• Adição de campos de ticket personalizados ao formulário de contato padrão
• Ativação de vários formulários de ticket no Web Widget (clássico)
• Personalização de descrições de campo no Web Widget (clássico)
• Personalização avançada: formulários de ticket contextuais
• Personalização avançada: preenchimento prévio de campos de texto do formulário de contato

Artigo relacionado:

• Configuração dos componentes no Web Widget (clássico)

Adição de campos de ticket personalizados ao formulário de contato padrão

Os clientes em qualquer plano do Support podem escolher exibir um, dois ou todos os campos de ticket personalizados e editáveis visíveis no formulário de contato do Web Widget (clássico). Em alguns planos de uso, é possível escolher a quantidade desejada de campos de ticket personalizados no formulário de contato padrão. Para obter mais informações sobre campos de tickets personalizados, consulte Inclusão de campos personalizados em seus tickets e nos formulários de solicitação de suporte.

O Web Widget (clássico) não oferece suporte aos campos de ticket do sistema, como o campo Prioridade. Eles aparecem no formulário de contato padrão, e em qualquer outro formulário de ticket, quando acessados pela central de ajuda, mas não aparecem no Web Widget (clássico). Há suporte para a reordenação de campos no Web Widget (clássico) usando formulários de ticket, mas não no formulário de contato.

Campos personalizados de expressão regular (Regex), data e seleção múltipla não podem ser usados no Web Widget (clássico).

Como exibir campos de ticket personalizados no formulário de contato padrão

1. Na Central de administração, clique em Canais na barra lateral e selecione Clássico > Web Widget.
2. Na aba Informações básicas, marque a caixa de seleção Formulário de contato e clique na lista suspensa Campos personalizados de ticket.

   

3. Selecione as opções de campos personalizados de ticket que deseja exibir no formulário de contato ou Selecionar tudo.
4. Clique em Salvar.

Ativação de vários formulários de ticket no Web Widget (clássico)

Se você possui um plano Zendesk Suite, Support Enterprise ou Enterprise Plus, é possível usar vários formulários de ticket no Web Widget (clássico). Para obter uma lista e informações gerais sobre o funcionamento dos formulários de ticket, consulte Criação de formulários de ticket para oferecer suporte a diversos tipos de solicitação.

Os formulários de ticket permitem que você personalize os campos exibidos em seu formulário de contato com base no tipo de solicitação feita pelo cliente. Para que esse recurso funcione, você deve criar mais de um formulário de ticket.

Como ativar os formulários de ticket no Web Widget (clássico)

1. Na Central de administração, clique em Canais na barra lateral e selecione Clássico > Web Widget.
2. Na aba Informações básicas, marque as caixas de seleção Formulário de contato e Formulários de ticket.
3. Clique em Salvar.

Quando os formulários de ticket estão ativados, se o cliente clicar no botão Deixe uma mensagem, é solicitado que ele selecione um formulário de ticket que atenda às suas necessidades, de uma lista de todos os seus formulários de ticket ativos:

quando eles selecionam, o formulário de contato exibe os campos específicos desse formulário de ticket.

Personalização de descrições de campo no Web Widget (clássico)

É possível adicionar campos de ticket personalizados e suas descrições ao formulário de contato padrão no Web Widget (clássico). Para que eles sejam exibidos, selecione o campo da opção Campos de ticket personalizados nas configurações de administrador do Web Widget (clássico).

No entanto, lembre-se de que o Web Widget (clássico) não oferece suporte aos campos do sistema, como o campo Prioridade. Isso independe do tipo de plano. Eles aparecem no formulário de contato padrão, e em qualquer outro formulário de ticket, quando acessados pela central de ajuda, mas não aparecem no Web Widget (clássico).

Os formulários de ticket não estão disponíveis em todos os planos de uso. Se disponível em seu plano, também é possível incluir campos personalizados e suas descrições nos formulários de ticket. Para exibir os campos de ticket personalizados e suas descrições, ative a opção Formulários de ticket nas configurações do Web Widget (clássico).

Observação: se o componente Formulários de ticket está desativado, o formulário de contato padrão não inclui os campos personalizados e suas descrições no formulário de contato padrão. Em vez disso, o formulário de contato padrão incluirá uma descrição que diz Como podemos ajudá-lo?.

Você pode criar e editar as descrições de campos de ticket da página do administrador Campos de ticket. Para obter informações sobre os campos de ticket, consulte Sobre campos de tickets.

Como adicionar uma descrição de campo

1. Na Central de administração, clique em Objetos e regras na barra lateral e selecione Tickets > Campos.
2. Clique no nome do campo que precisa de uma descrição.
3. Na seção Para usuários finais, clique em Editável.
4. Insira uma descrição para o campo e clique em Atualizar campo.

Personalização avançada: formulários de ticket contextuais

Você pode criar experiências mais personalizadas para seus usuários limitando os formulários disponibilizados para os usuários finais com base na página da web que eles estão visitando ao modificar o objeto zESettings na API JavaScript do Web Widget (clássico). Para obter informações sobre o uso da API, consulte Personalização avançada do Web Widget (clássico).

No código da página da web que você deseja modificar, atualize o objeto zESettings para incluir o número da ID dos formulários de ticket que você deseja exibir. Sua ID dos formulários de ticket está listada na URL na página do administrador dos Formulários de ticket.

Como localizar o número da ID do formulário de ticket

1. Na Central de administração, clique em Objetos e regras na barra lateral e selecione Tickets > Formulários.
2. Clique no nome do formulário que deseja ocultar ou usar como formulário independente.
3. Anote a ID do formulário na barra de endereços:

   

Use os exemplos a seguir para modificar o código do seu website.

Como exibir um único formulário de ticket:

<script type="text/javascript">
window.zESettings = {
  webWidget: {
    contactForm: {
      ticketForms: [
        { id: ###### }
      ]
    }
  }
};
</script>

Como exibir dois formulários de ticket:

<script type="text/javascript">
window.zESettings = {
  webWidget: {
    contactForm: {
      ticketForms: [
        { id: ###### }, 
        { id: ###### }
      ]
    }
  }
};
</script>

Adicione as IDs extra ao objeto zESettings conforme necessário.

Personalização avançada: preenchimento prévio de campos de texto

Você pode usar as novas configurações para preencher previamente campos específicos. Você pode usar cadeias de caracteres diferentes para localidades diferentes ou uma cadeia para todas as localidades usando um asterisco (*). Isso é similar a outras cadeias de texto personalizadas, como o título do Formulário de contato.

Observação: esta seção discute como preencher previamente os campos do sistema. Para obter informações sobre o preenchimento prévio de nomes de usuário e endereços de e-mail, consulte Web Widget API zE.identify.

Para preencher previamente um campo do sistema, como "subject" e/ou "description", atualize o objeto zESettings da seguinte maneira.

Exemplo: texto de descrição preenchido previamente

Use o código a seguir:

<script type="text/javascript">
zESettings = {
  webWidget: {
    contactForm: {
      fields: [
        { id: 'description', prefill: { '*': 'This is prefilled description text' } }
      ]
    }
  }
};
</script>

Exemplo: campo personalizado preenchido previamente:

Use o código a seguir:

<script type="text/javascript">
zESettings = {
  webWidget: {
    contactForm: {
      fields: [
        { id: #####, prefill: { '*': 'Desired text' } }
      ]
    }
  }
};
</script>

Nesse bloco de código, id: ##### corresponde ao identificador do campo personalizado.

Você pode escolher sempre preencher previamente um campo específico em todos os seus formulários, ou separadamente em formulários específicos.

Exemplo de código: texto diferente para o mesmo campo em formulários diferentes:

<script type="text/javascript">
window.zESettings = {
  webWidget: {
    contactForm: {
      ticketForms: [
       { 
         id: ###TicketFormID###, 
         fields: [
           {
              id: 'description',
              prefill: {
                '*': description
              }
            }
          ]
        },
        {
          id: ###TicketFormID###, 
          fields: [
            {
              id: 'description',
              prefill: {
                '*': 'different description'
              }
            }
          ]
        }
      ]
    }
  }
};
</script>