> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/pt/servicos-corporativos/zoom-contact-center/expert-insights/agentless-dialer-with-custom-fields.md).
# Discador sem agente com campos personalizados
## Visão geral
### O que é o Discador sem agente?
O Zoom central de contato **Discador sem agente** é um tipo de discador que realiza chamadas Realizadas sem exigir que os agentes estejam logados ou Disponível. Diferente do **Pré-visualização** e **Progressivo** discadores, que são conduzidos por agentes, o **Discador sem agente** opera de forma independente, executando campanhas discando contatos de uma lista e entregando experiências automatizadas por meio de uma mensagem configurada **Fluxo** ou mensagem gravada. **Discador sem agente** é útil para comunicações Realizadas em que um agente ao vivo não é necessário para cada ligar. Casos de uso comuns incluem:
* Lembretes de compromissos
* Notificações de pagamento em atraso
* Atualizações da comunidade
* Convites do Evento
* Lembretes de rastreio de saúde
Com **Campos personalizados** suporte, essas mensagens podem ser personalizadas por contato.
{% hint style="success" %}
**Exemplo**
Em vez de um genérico "você tem uma consulta agendada", o discador pode dizer "a sua consulta está agendada para sexta-feira às 15:00 na nossa Localização da Main Street."
{% endhint %}
{% hint style="info" %}
Os contactos também podem receber a opção de se ligar com um agente ao vivo durante a ligar, se necessário.
{% endhint %}
### Licenciamento
O **Discador sem agente** requer uma licença de add-on na Zoom central de contato. Pelo menos uma licença de usuário do Zoom central de contato (Essentials ou superior) é necessária para o administrador que configura o Gerenciamento da central de contato. O próprio Discador sem agente tem uma taxa de uso cobrada por minuto. Entre em contato com a sua equipe de Vendas da Zoom para obter informações adicionais sobre preços.
Quando um ligar do Agentless Dialer é escalado para um agente humano por meio do Flow, o agente que o recebe pode ter qualquer tipo de licença do Zoom central de contato (Essentials, Premium ou Elite). Não há exigência de que o agente tenha uma licença Premium+ para lidar com os ligar escalados do Agentless Dialer.
### Conceitos principais
Uma implementação personalizada do Agentless Dialer envolve quatro componentes principais:
O **Campanh**n é o objeto de nível superior que define o comportamento do discador. Especifica o tipo de discador (sem agente), a lista de contatos a ligar, o ID do chamador, o horário comercial, os limites de chamadas simultâneas, **Detecção de secretária eletrônica** (AMD) configurações, e o que acontece quando um contato humano é detectado (reproduzir uma mensagem ou encaminhar para um fluxo). A campanha também tem uma configuração "Always Running" que controla se a campanha é executada continuamente ou uma vez.
O **Lista de contatos** contém os Números de telefone e os dados associados das pessoas para as quais a campanha ligará. Cada entrada na lista inclui campos padrão (nome, sobrenome, número de telefone etc.) e pode incluir campos personalizados com dados adicionais. Uma única lista de contatos pode ser associada a uma ou mais campanhas.
**Campos personalizados** estende o registro padrão da lista de contatos com colunas de dados definidas pelo usuário. Cada campo personalizado tem um nome, um tipo de dados (por exemplo, texto, data/hora) e uma opção para controlar se o valor fica visível para os agentes. Os campos personalizados permitem que dados específicos da campanha — como datas de agendamento, números de conta ou detalhes de Localização — acompanhem cada contato e sejam referenciados dinamicamente no fluxo. Os valores podem ser preenchidos manualmente, por meio de importação/exportação de CSV, ou por meio da API do Zoom central de contato.
O **Fluxo** é a lógica de tratamento de ligações que é executada quando um contato discado atende (ou quando o AMD detecta um contato humano). Os fluxos para o Agentless Dialer usam o mesmo construtor de Flow e o mesmo conjunto de widgets que os fluxos de voz Recebidas padrão. Dentro de um Flow, você pode reproduzir mensagens personalizadas usando campos da lista de contatos, coletar entrada DTMF, fazer chamadas à API, encaminhar para um agente de voz ZVA ou encaminhar para a fila de um agente humano. A escalada para um agente ao vivo é uma capacidade padrão do Flow do Zoom central de contato e pode ser incorporada em qualquer Flow do Agentless Dialer.
{% hint style="info" %}
Para uma introdução aos Flows, consulte o [Bluepaper de Experiência do Cliente do Zoom](/technical-library/pt/servicos-corporativos/zoom-contact-center/zoom-customer-experience/zoom-contact-center-components/flows.md).
{% endhint %}
## Flows com Suporte para Campos Personalizados
Com os Campos Personalizados, o Flow pode oferecer uma experiência totalmente personalizada para cada contato discado. Os Campos Personalizados são expostos como atributos de contato no construtor de fluxos e podem ser referenciados em qualquer lugar onde variáveis sejam suportadas, incluindo **Enviar mídia** widgets, **Coletar Entrada** widgets, **Condição** widgets e **Script** widgets.
O construtor de fluxos fornece uma interface Inserir Variável que permite navegar e inserir a sintaxe correta da variável. Há dois namespaces de variáveis disponíveis nos flows:
* **Campos da lista de contato**: Dados da lista de contato da campanha, incluindo tanto os campos padrão (por exemplo, `listaDeContato.campoPadrão.primeiroNome`) e campos personalizados (por exemplo, `listaDeContato.campoPersonalizado.horaDoAgendamento`). Estas são as fontes mais confiáveis para dados específicos da campanha.
* **Campos da agenda de endereços**: Dados da agenda de endereços do Zoom central de contato, incluindo campos padrão e personalizados. Observe que não há garantia de que um número discado exista na agenda de endereços, portanto os campos da lista de contato são preferidos para os dados da campanha.
{% hint style="success" %}
**Exemplo**
"Olá {{listaDeContato.campoPadrão.primeiroNome}} {{listaDeContato.campoPadrão.sobrenome}}, aqui é a Example Corp ligando com um lembrete de agendamento. Sua consulta está agendada para {{listaDeContato.campoPersonalizado.horaDoAgendamento}} na localização {{listaDeContato.campoPersonalizado.LocalizaçãoDoAgendamento}}. Para confirmar, Imprensa 1. Para Cancelar, Imprensa 2. Para falar com um agente, Imprensa 3."
{% endhint %}
### Campos Personalizados e Detecção de Secretária Eletrônica (AMD)
Os Campos Personalizados têm status Disponível no Flow, independentemente de o AMD estar habilitado. Com o AMD desligado, todas as chamadas conectadas são roteadas para o Flow. Com o AMD ligado, as chamadas nas quais um contato ao vivo é detectado são roteadas para o Flow. Em ambos os casos, os campos personalizados estão totalmente acessíveis dentro do Flow.
{% hint style="info" %}
Quando o AMD (Answering Machine Detection) detecta um correio de voz, o sistema automaticamente reproduz uma mensagem pré-gravada da Biblioteca de Assets em vez de rotear a chamada para um Flow. Devido a essa limitação, Campos Personalizados não podem ser usados em mensagens de correio de voz. Uma futura versão irá Adicionar Suporte ao Roteamento de chamadas de correio de voz detectadas pelo AMD para os Flows da central de contato Zoom, o que irá Habilitar mensagens personalizadas de correio de voz com conteúdo dinâmico para campanhas do Agentless Dialer.
{% endhint %}
## Configuração e Configurar inicial
Esta seção descreve as etapas para Configurar uma campanha personalizada de Discador sem Agente.
### Etapa 1: Criar campos personalizados
1. Navegue até **Gestão da central de contato** > **Gestão de campanhas**.
2. Vá para o **Lista de contatos** secção.
3. Selecionar **Campos personalizados**.
4. Clique em **Adicionar campo personalizado**.
5. Inserir um nome para o campo personalizado (por exemplo, `appointmentTime`, `appointmentLocation`).
6. Selecionar o tipo de dados (por exemplo, Texto, Data/Hora).
7. Opcionalmente, Configurar se o valor do campo deve ser exibido aos agentes da central de contato Zoom.
8. Repita para cada campo personalizado necessário.
### Etapa 2: Criar um fluxo com referências a campos da lista de contatos
1. Navegue até **Gestão da central de contato** > **Fluxos**.
2. Crie um novo fluxo de voz para a **Discador sem agente** campanha.
3. Adicionar widgets conforme necessário (Enviar mídia, Coletar entrada, Condição, Script, Encaminhar para etc.).
4. Em qualquer widget que ofereça suporte à inserção de texto ou variável, use o **Inserir variável** botão para procurar e inserir campos padrão e campos personalizados da lista de contatos.
* Os campos padrão da lista de contatos seguem o formato: `{{contactList.standardField.fieldName}}`
* Os campos personalizados da lista de contatos seguem o formato: `{{contactList.customField.fieldName}}`
#### Padrão de design de fluxo: escalonamento para um agente humano
Para dar ao contato discado a opção de falar com um agente ao vivo, use um **Coletar Entrada** widget para capturar o pressionamento de uma tecla DTMF (por exemplo, "Imprensa 3 para falar com um agente") e encaminhar a ligar para uma fila por meio do **Rota para** widget.
Recomenda-se definir uma variável antes que a ligar chegue à fila, para que o agente possa identificar que a ligar teve origem em uma campanha de discador sem agente. Isso é importante porque a fila pode ser combinada — os agentes nessa fila também podem receber chamadas Recebidas padrão e, caso contrário, não teriam como distinguir a origem da ligar.
Para fazer isso, use um **Definir variável** widget para armazenar um valor descritivo (por exemplo, definir uma variável personalizada `agentlessCampaign` para `"Discador de lembrete de compromisso"`) antes do **Rota para** widget. Em seguida, em **Gestão da central de contato** > **Preferências**, Configurar essa variável para que seja exibida aos agentes. Quando o agente receber a ligar, verá o valor da variável na tela de notificação recebida, fornecendo contexto sobre o motivo pelo qual a ligar foi feita. Variáveis globais adicionais podem ser adicionadas para Exibir informações adicionais ao agente durante o escalonamento.
Os agentes que recebem chamadas escalonadas do Discador sem Agente podem ter qualquer nível de licença da central de contato Zoom (Essentials, Premium ou Elite).
### Etapa 3: Criar uma lista de contatos
1. Navegue até **Gestão da central de contato** > **Gestão de campanhas** > **Listas de contatos**.
2. Crie uma nova lista de contatos ou Selecionar uma existente.
3. Adicionar contatos manualmente, por importação de CSV ou pela API da central de contato Zoom.
4. Ao Adicionar contatos, preencha tanto os campos padrão (nome, sobrenome, número de telefone) quanto quaisquer campos personalizados que você definiu.
### Etapa 4: Criar e Configurar a campanha
1. Navegue até **Gestão da central de contato** > **Gestão de campanhas**.
2. Clique em **Adicionar campanha** e Selecionar **Discador sem Agente.**
3. Nomeie a campanha e Configurar as seguintes Configurações:
* **Lista de contatos**: Selecionar a lista de contatos criada em [Etapa 3](#step-3-create-a-contact-list).
* **ID do chamador**: Selecionar o número da ID do chamador para Realizadas.
* **Máximo de chamadas simultâneas**: Defina um valor entre 1 e 15.
* **Horário comercial**: Configurar a janela de discagem permitida.
* **Sempre em execução**: Defina como Verdadeiro se os contatos forem adicionados continuamente, ou Falso para uma execução única da campanha.
* **Detecção de correio de voz (AMD)**: Habilitar ou Desabilitar conforme necessário. Se habilitado, Configurar a ação de correio de voz (desconectar ou reproduzir mensagem da biblioteca de ativos).
* **Contato ao vivo detectado**: Selecionar **Conectar ao fluxo** e Escolher o fluxo criado em [Etapa 2](#step-2-create-a-flow-with-contact-list-field-references).
## Gerenciando a Lista de Contatos
Os contatos podem ser adicionados à lista de contatos por entrada manual no portal de administração, importação de CSV ou pela API da central de contato Zoom. Os três métodos aceitam campos padrão e personalizados.
### Adicionando Contatos via Importação/Exportação de CSV
Para importar contatos com campos personalizados via CSV, é útil primeiro adicionar um único contato manualmente com todos os campos personalizados desejados preenchidos e, em seguida, exportar a lista. O CSV exportado conterá os cabeçalhos de coluna corretos para campos padrão e personalizados, que você pode usar como modelo para importações em massa.
### Adicionando Contatos via API
A API da central de contato Zoom permite adicionar entradas da lista de contatos com valores de campos personalizados de forma programática. Isso é útil para integrações em que os dados de contato são gerenciados em um sistema externo (por exemplo, um CRM, uma plataforma de agendando ou EHR) e precisam ser enviados automaticamente para a lista de contatos.
Para mais informações, consulte a [documentação de referência da API](https://developers.zoom.us/docs/api/contact-center/#tag/campaigns/post/contact_center/outbound_campaign/contact_lists/{contactListId}/contacts).
### Tempo: Quando Adicionar Contatos
O momento de adicionar contatos depende da configuração Sempre em execução da campanha:
* **Sempre em execução** = **Verdadeiro**: Os contatos podem ser adicionados à lista de contatos a qualquer momento — antes, durante ou depois de a campanha começar. A campanha é executada continuamente e irá captar os contatos recém-adicionados à medida que forem carregados. Esse modo é ideal para casos de uso contínuos, como lembretes de consulta recorrentes, em que novos contatos são gerados ao longo do dia.
* **Sempre em execução** = **Falso**: Os contatos devem ser carregados na lista de contatos antes de a campanha ser iniciada. Quando a campanha terminar de discar para todos os contatos da lista, ela passará para o estado Encerrado. Os contatos adicionados após o fim da campanha não serão discados, a menos que a campanha seja reiniciada. Esse modo é adequado para campanhas em lote, como notificações de Evento únicas ou lembretes de pagamento.
### Removendo Contatos da Campanha
Talvez você precise remover um contato da campanha por vários motivos. Por exemplo, um cliente pode entrar em contato com você antes que você consiga ligar para ele. Para remover um contato, use a [API de remoção de contato da lista de contatos da campanha](https://developers.zoom.us/docs/api/contact-center/#tag/campaigns/delete/contact_center/outbound_campaign/contact_lists/{contactListId}/contacts/{contactId}).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://library.zoom.com/technical-library/pt/servicos-corporativos/zoom-contact-center/expert-insights/agentless-dialer-with-custom-fields.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.