Este componente permite que você valide um CNPJ enviado pelo usuário, verificando se ele é válido e, se for o caso, retornando o CNPJ pós-validação.
Esse processo é essencial para garantir a integridade dos dados em interações automatizadas, especialmente quando o CNPJ é utilizado em fluxos de dados.
Este artigo irá guiá-lo pelo processo de configuração dessa ação no Builder de maneira simples e prática.
Estrutura da Ação
A estrutura básica para usar o componente validate_cnpj é a seguinte:
[ { "name": "validate_cnpj", "parameters": { "cnpj": "<? input.text ?>" }, "result_variable": "cnpj_validation" } ]
Atributos
- name: O nome da ação, que neste caso é validate_cnpj.
- parameters: Este campo recebe o CNPJ a ser validado. O valor enviado pelo usuário será passado para esse parâmetro.
- cnpj: O CNPJ a ser validado.
- result_variable: A variável de contexto que armazenará o resultado da validação. Essa variável poderá ser usada para acessar os dados do CNPJ após a validação. Em caso de sucesso, essa variável conterá o seguinte JSON:
{ "valid": true, "cnpj": "<CNPJ pós-validação>" }
Exemplo
[ { "name": "validate_cnpj", "parameters": { "cnpj": "93.094.153/0001-26" }, "result_variable": "cnpj_validation" } ]
Neste caso, o CNPJ enviado pelo usuário é "93.094.153/0001-26". Após a validação, o resultado será armazenado na variável de contexto cnpj_validation, com a seguinte resposta:
{ "valid": true, "cnpj": "93094153000126" }
Como usar o resultado
Após a validação do CNPJ, o resultado será armazenado na variável de contexto definida (cnpj_validation), e você poderá usá-la para tomar decisões no fluxo do seu chatbot ou sistema. Por exemplo, se o CNPJ não for válido, você pode disparar uma mensagem de erro para o usuário.