👩‍💻
Manual de Integração
  • 🏠Início
  • 🔗Webhooks
    • Habilitando
    • Tipos de webhook
  • 🌐API
    • Autenticacão
    • Utilizacão
  • 💬Flow
    • Gatilhos
      • Frases de treino (PLN)
      • Anúncios da META
      • Webhooks
        • RD Marketing
        • Customizado
    • Integrações nativas
      • Configurando RD CRM
      • Configurando Pipedrive
      • Configurando Nectar CRM
      • Configurando RD Marketing
    • Captura de dados
    • Variáveis de contato
    • Validação e formatação de captura
    • Utilizando dados do contato
    • Requisição HTTP
      • Retorno vinculado à Suri
      • Retorno livre
      • Retorno de lista
    • Múltiplas etapas
  • 🧠Intenção de IA (legado)
    • Resumão
    • Exemplo de uso 1: segunda via
    • Fluxo Suri vs. Fluxo Externo
    • Exemplo de uso 2: formulário
  • ❓FAQ
Powered by GitBook
On this page
  1. Flow

Validação e formatação de captura

PreviousVariáveis de contatoNextUtilizando dados do contato

Last updated 7 months ago

Quando salvamos dados capturados, estamos trabalhando unicamente com texto, mas em certos casos precisamos garantir que a resposta do contato siga alguma regra e não só isso, às vezes precisamos garantir que esse dado seja salvo utilizando uma formatação específica. Para isso no flow trabalhamos com esses dois conceitos:

  • Regra de validação: regra à qual o valor informado pelo contato deve se enquadrar para que seja aceito pela captura. Um exemplo clássico é o CPF: ao informar um CPF, a pessoa pode digitá-lo com "." e "-" ou somente números, mas ambos são um CPF válido.

  • Formatação: "máscara", ou seja, estrutura a ser utilizada na hora de salvar o dado. Ainda utilizando o exemplo do CPF, podemos desejar que seja salvo unicamente utilizando números ou que seja forçado a salvar utilizando "." e "-", como em 000.000.000-00.

Para escolher uma regra, ao criar uma ação de Captura no flow, escolha a regra desejada no campo mais abaixo. Por padrão, a regra sempre é "Aceitar tudo". As opções disponíveis dependerão do tipo de dado a ser capturado. Por exemplo, "Nome" tem como opções: "Apenas nome válido" e "Apenas nome completo", já "Telefone" pode ser "Apenas telefone válido" ou "Apenas telefone do Brasil (com DDD)":

Já o campo "Formatar valor" só aparece se o dado capturado tiver uma regra de validação passível de formatação. Não temos como formatar um nome de pessoa, por exemplo, mas temos como formatar um telefone, salvando-o com apenas números ou seguindo o padrão brasileiro (85) 9 9999-8888

E o que acontece se minha regra ou formatação não forem satisfeitas?

Se o seu contato "errar" a resposta na captura, consideramos que a regra não foi satisfeita. Nesses casos, caso a ação de captura contenha uma "Mensagem de resposta inválida" configurada, a enviamos ao contato na tentativa dele responder corretamente. Caso contrário, apenas repetimos a mensagem de captura configurada para que ele mande outra resposta*.

Seguem abaixo todas as possibilidades de regras e formatação e a explicação de cada uma:

  • Para Nome:

    • Apenas nome válido: aceita apenas textos que contenham caracteres (sem números ou caracteres especiais). Exemplo: "João".

    • Apenas nome completo: aceita apenas nomes válidos (regra acima) e que contenham ao menos um espaço e outro nome em seguida. Exemplo: "João Pedro".

  • Para Telefone:

    • Apenas telefone válido: aceita apenas números que se enquadrem como telefone, podendo ou não ser formatados ou núemro internacionais. Exemplos: 988776655, (85) 8877-6655, +1 (534) 333-7656

    • Apenas telefone do Brasil (com DDD): aecita apenas telefones do Brasil que obrigatoriamente tenham DDD, sejam eles formatados ou não. Exemplos: 85 9.8877-6655, 85988776655

  • Para E-mail:

    • Apenas e-mail válido: aceita apenas emails válidos, isto é, que contenham ao menos um @ e um domínio ao final. Exemplos: contato@suri.ai, nao-responda@gmail.com

  • Para Documento de Identificação:

    • Apenas CPF válido: aceita apenas CPF válido, seja ele formatado ou não. Exemplos: 00000000000, 000.000.000-00

    • Apenas CNPJ válido: aceita apenas CNPJ válido, seja ele formatado ou não. Exemplos: 00000000000000, 00.000.000-0000/00

  • Para Variável

    • Apenas números: somente números. Exemplos: 0, -1, 40.7

    • Apenas números inteiros: somente número inteiros. Exemplos: -1, 0, 1, 2, 100000

    • Apenas números naturais (>= 0): somente números positivos. Exemplos: 0, 1.1, 10000, 34.7

    • Apenas números inteiros naturais (>= 0): somente números inteiros positivos. Exemplos: 0, 1, 2, 10000

    • Apenas datas válidas: somente datas válidas nos mais variados formatos, mas que ao menos tenha a data completa (não precisa de horas). Exemplo: "2024-09-25", 25 de dezembro de 2012, 13/05/2020 13:45.

    • Todas as regras citadas nos tópicos anteriores: como variável pode representar qualquer tipo de dado, elas podem receber todas as regras citadas nos tópicos anteriores

*Note que a possibilidade do contato responder novamente é configurável através da opção de "Resgate" do flow. Então caso o número total de tentativas foi atingido, o fluxo de resgate será enviado e, portanto, não há uma nova tentativa de captura. Para mais possibilidades de configuração de fluxo, .

💬
veja nossos tutoriais em vídeo