Formato de dados

Regras de validação e padronização dos campos de identificação do Contato

Com o objetivo de promover a Integridade Conceitual e a Qualidade de Dados em todo o ecossistema de produtos RD Station, implementamos novas regras de padronização para os campos centrais do contato:

• Nome
• Email
• Telefone

Endpoints impactados nessas regras:

• Criar contato
• Atualizar contato pelo uuid/email/phone
• Evento de conversão padrão
• Eventos de E-commerce
• Evento de Início da Conversa
• Evento de Término da Conversa
• Evento de Chamada Concluída
• Evento de Início do Playback de uma Mídia
• Evento de Término do Playback de uma Mídia
• Conversão via API Key

Campo name

Regras obrigatórias deste campo:

• Máximo de 180 caracteres.

Sanitização aplicada ao salvar o campo nome no banco:

• Remoção automática de espaços no início, meio e fim (trim/strip).
• Remoção de espaços duplicados.
• Normaliza o texto em Unicode NFC (Canonical Normalization), garantindo consistência entre diferentes representações de caracteres acentuados.

Campo email

Regras obrigatórias deste campo:

• Máximo de 180 caracteres.
• Remoção de espaços no início e fim do texto (trim/strip).
• Validação de formato por RegExp de e-mail, conforme detalhado abaixo:
  • Deve conter uma arroba (@) e somente uma.
  • A parte antes da arroba (@), chamada de “local part”:
    • Deve conter somente:
      • letras latinas sem diacríticos e minúsculas (a-z)
      • números (0-9)
      • os símbolos:
        • ponto (.)
        • hífen (-)
        • sublinhado (_)
        • mais (+)
    • Deve conter pelo menos um caractere, sendo ou letra ou número.
    • Não deve iniciar nem terminar com os símbolos (.-_+).
    • Não deve conter ponto (.) repetidos consecutivos.
    • Pode conter hífen (-) e sublinhado (_) repetidos consecutivos.
    • Pode contar símbolos consecutivos desde que distintos.
    • Pode conter somente um mais (+) e se for o caso, seguido das letras, números e símbolos permitidos (.-_) sem regra de restrição de início, fim e repetições dos símbolos.
  • A parte depois da arroba (@), chamada “domain”:
    • Deve conter somente:
      • letras latinas sem diacríticos e minúsculas (a-z)
      • números (0-9)
      • os símbolos:
        • ponto (.)
        • hífen (-)
    • Não deve iniciar nem terminar com os símbolos.
    • Não deve conter símbolos consecutivos.
    • Deve terminar em ponto (.) seguido por pelo menos 2 letras (a-z).

Sanitização aplicada ao salvar o campo email no banco:

• Convertido automaticamente para minúsculas.
  • Exemplo de entrada: [email protected]
  • Exemplo de como ficará salvo no banco: [email protected]

Exemplos Válidos

• [email protected] ✅
• [email protected]✅
• [email protected] ✅

Exemplos Inválidos

• Usuário Legal@empresa ❌
• usuario@empresa ❌
• usuario@@empresa.com ❌
• [email protected] ❌

Campos de telefone (phone, mobile_phone, personal_phone)

Regras obrigatórias deste campo:

• Deve estar no formato internacional E.164.
  • Formato: +[código do país][código de área][número local]
  • Exemplo: +5511987654321
• O número deve incluir:
  • Código do país - DDI
  • Código de área - DDD (se aplicável)
• Não aceita ramais ou extensões.
• Somente caracteres numéricos.
• Limite máximo de 15 dígitos.
• Recomenda-se o uso de bibliotecas compatíveis, como Google libphonenumber.

Exemplos válidos

• +5511987654321 ✅
• +14155552671 ✅
• +55(11)99999-9999 ⚠️ (número contém caracteres não numéricos e será sanitizado automaticamente)

Exemplos inválidos

• 987654321 ❌ (sem DDI e DDD)
• +553199999999;42 ❌ (contém ramal)