Este componente permite validar números de celular informados pelos usuários. Essa validação é feita através de regras baseadas em expressões regulares (regex), garantindo que apenas números em formatos válidos sejam aceitos.

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 configuração do componente exige que você forneça algumas informações em formato JSON, conforme descrito abaixo:

[
 {
   "name": "validate_cellphone",
   "parameters": {
     "phone": "<? input.text ?>"
 },
 "result_variable": "cellphone_validation"
 }
]

Atributos

• name: Identificação do componente. No caso, deve ser sempre "validate_cellphone".

• parameters:

phone: O número de celular que será validado. Geralmente, este é capturado a partir do input do usuário (exemplo: <? input.text ?>).

• result_variable: Nome da variável de contexto que receberá o resultado da validação.

Resultado da validação

Após a validação, a variável de contexto especificada em result_variable conterá o resultado no seguinte formato JSON:

Caso a validação seja bem-sucedida:

{
 "valid": true,
 "phone": "<número de telefone pós-validação>"
}

Caso a validação não seja bem-sucedida:

{
  "valid": false
}

Exemplo prático

Considere o seguinte exemplo, onde o usuário digita o número de celular (35) 98877 6655:

JSON de configuração

[
  {
    "name": "validate_cellphone",
    "parameters": {
      "phone": "(35) 98877 6655"
    },
    "result_variable": "cellphone_validation"
  }
]

Resultado da validação

Se o número estiver em um formato válido, o seguinte JSON será retornado:

{
  "valid": true,
  "phone": "35988776655"
}

Isso significa que o número foi validado com sucesso e formatado para um padrão sem espaços, parênteses ou hifens.