Manual Técnico Completo
Os Campos e Contextos permitem personalizar o processo de contratação do CRM sem necessidade de desenvolvimento. Através deles é possível criar formulários dinâmicos, coletar informações específicas durante a venda, automatizar integrações com sistemas externos e enviar todos os dados para o ERP de forma estruturada.
Além dos campos personalizados, a funcionalidade também possui um mecanismo de Gatilhos e Ações, permitindo executar chamadas para APIs externas e utilizar seus retornos durante o fluxo de contratação.
Utilize Campos e Contextos sempre que houver necessidade de coletar informações adicionais que não fazem parte do fluxo padrão do CRM. Alguns exemplos:
O funcionamento da funcionalidade pode ser resumido no seguinte fluxo:
Cada campo personalizado pertence obrigatoriamente a um contexto. Atualmente o CRM possui sete contextos.
Permite adicionar campos na etapa de agendamento do lançador de vendas.
Exemplos: Melhor horário, Referência do endereço, Observações.
Permite adicionar campos na primeira etapa do lançador de vendas, juntamente com os dados principais do cliente.
Exemplos: Como conheceu a empresa, Código promocional, Indicação.
Permite adicionar campos diretamente no card expandido do funil de vendas. Esses campos podem ser utilizados para acompanhar informações comerciais específicas durante a negociação.
Este contexto possui quatro possibilidades de exibição dos campos:
Forma de Pagamento
Os campos aparecem conforme a forma de pagamento escolhida (Cartão de Crédito, Débito em Conta, PIX, Boleto).
Plano
Permite exibir campos apenas quando determinados planos forem contratados. Ex: Plano 600 Mbps → Perguntar tipo de roteador.
Serviço
Permite exibir campos específicos para determinados serviços. Ex: Telefonia móvel → Perguntar tipo do chip.
Portabilidade
Permite exibir campos conforme exista ou não portabilidade. Ex: Portabilidade = Sim → Solicitar informações adicionais da linha telefônica.
Os seguintes tipos podem ser cadastrados:
✏️ Texto
Campo de texto livre. Também pode possuir validações de máscara: CPF, Celular, Data (DD/MM/AAAA), Data de validade, Número do cartão, Código de segurança, Texto curto, Valor decimal.
🔢 Número
Aceita apenas valores numéricos.
🔘 Lista de Escolha
Permite selecionar apenas uma opção. Exemplo: SIM, NÃO.
☑️ Caixa de Escolha
Permite selecionar várias opções simultaneamente.
📎 Arquivo
Permite realizar upload de documentos.
Cada campo pode possuir:
Os campos também podem ser reorganizados em qualquer ordem durante sua edição.
Os formulários do CRM são dinâmicos. Isso significa que determinados campos somente aparecerão quando condições previamente configuradas forem atendidas.
Exemplo
Operadores disponíveis
As dependências podem ser utilizadas em todos os contextos do sistema.
Um campo pode permanecer inativo. Nesse caso:
Essa funcionalidade é muito utilizada para armazenar retornos de integrações automáticas.
Os Gatilhos permitem automatizar ações sempre que um determinado campo for monitorado. Um gatilho é responsável por observar um campo personalizado e executar uma ou mais ações quando o formulário é concluído.
Cada ação representa uma chamada para uma API externa. Ao cadastrar uma ação são configurados: Nome, Status, URL, Método HTTP. Também é possível configurar Cabeçalhos (Headers) e Corpo da requisição (Body).
Métodos suportados
As ações podem utilizar informações do CRM dinamicamente através de Tags. As tags são substituídas automaticamente antes da chamada da API.
Campos personalizados
{{field.nome_da_tag}}Ex: {{field.cpf}}
Dados do registro
{{model.nome}} · {{model.cpf}} · {{model.uuid}}Exemplo de URL
https://api.exemplo.com/clientes/{{field.cpf}} → https://api.exemplo.com/clientes/12345678900Exemplo de Cabeçalho
{"Authorization": "Bearer {{field.token}}"}Exemplo de Corpo
{"cpf":"{{field.cpf}}", "cliente":"{{model.nome}}", "contrato":"{{model.uuid}}"}Caso alguma tag não seja encontrada, seu valor será substituído por vazio.
Após executar uma ação, o CRM pode interpretar a resposta da API. Cada ação pode possuir diversas respostas mapeadas. Essas respostas permitem capturar informações do retorno da API e armazená-las em campos personalizados. Os dados são obtidos através de caminhos (JSON Path).
Retorno da API
{"cliente": {"iccid": "8955123456789012345"}}Mapeamento
cliente.iccid → Campo personalizado "ICCID"
Esse campo pode permanecer oculto para o usuário e ainda assim ser enviado ao ERP.
Imagine o seguinte cenário: o cliente contrata um plano de telefonia móvel de 10 GB com portabilidade. Durante o preenchimento do formulário:
O cliente escolhe o serviço de telefonia móvel
O campo Tipo de Chip é exibido
O cliente seleciona eSIM
Ao avançar para a próxima etapa do formulário, o gatilho é executado
O CRM envia uma requisição ao portal da operadora MVNO
A API reserva automaticamente um ICCID
O retorno da API é interpretado
O ICCID é salvo em um campo personalizado oculto
Todas as informações são enviadas ao ERP na máscara da solicitação
O histórico da integração fica registrado nos logs
Todo esse processo ocorre automaticamente, sem necessidade de intervenção do vendedor.
Todas as execuções das ações são registradas. Cada registro apresenta:
Esses logs permitem acompanhar o histórico das integrações e identificar possíveis falhas de comunicação.
Utilize tags descritivas e padronizadas para facilitar futuras integrações.
Evite criar dependências complexas entre campos.
Prefira armazenar informações retornadas por APIs em campos inativos.
Organize os campos utilizando a ordem de exibição para melhorar a experiência do usuário.
Sempre valide suas integrações consultando os logs antes de disponibilizá-las em produção.
Utilize gatilhos apenas quando houver necessidade de integração ou automação. Para simples coleta de dados, os campos personalizados já atendem ao processo.
Essa documentação apresenta o funcionamento completo da funcionalidade Campos e Contextos do CRM, permitindo construir formulários inteligentes, automatizar integrações com sistemas externos e enriquecer o processo de contratação sem necessidade de desenvolvimento adicional. Ela foi concebida para oferecer flexibilidade na configuração dos fluxos de negócio, mantendo o CRM adaptável a diferentes cenários comerciais e operacionais.
Gestão sem Fronteiras