Botinfy

Appearance

Campos de Usuario ​

Los campos de usuario (campos personalizados) en la plataforma de Botinfy te permiten almacenar información adicional sobre tus contactos más allá de los campos estándar como nombre, teléfono y email. Esto te da flexibilidad para adaptar la plataforma a las necesidades específicas de tu negocio.

¿Qué son los Campos de Usuario? ​

Los campos personalizados son variables adicionales que puedes definir para almacenar información específica sobre tus contactos. Pueden ser de diferentes tipos: texto, número, fecha, booleano, JSON, etc.

Crear Campos Personalizados ​

Paso 1: Acceder a la Configuración ​

  1. Ve a Settings (Configuración) en el menú lateral.
  2. Busca y selecciona Custom Fields (Campos Personalizados) o Campos de Usuario.

Paso 2: Crear un Nuevo Campo ​

  1. Haz clic en + Nuevo Campo o + Crear Campo Personalizado.

  2. Configuración Básica:

    • Nombre del Campo: Asigna un nombre descriptivo (ej: "Ciudad", "Fecha de Nacimiento", "Producto de Interés").
    • Etiqueta: El texto que se mostrará en los formularios (puede ser diferente al nombre).
    • Tipo de Campo: Selecciona el tipo de dato que almacenará.

  3. Seleccionar el Tipo de Campo:

    • Texto: Para valores de texto simple.
    • Número: Para valores numéricos.
    • Fecha: Para fechas.
    • Booleano: Para valores verdadero/falso.
    • Lista Desplegable: Para seleccionar de una lista predefinida.
    • JSON: Para almacenar datos estructurados complejos.

  4. Configuraciones Adicionales:

    • Requerido: Marca si el campo es obligatorio.
    • Valor por Defecto: Define un valor predeterminado.
    • Validación: Añade reglas de validación si aplica.

  5. Guardar: Haz clic en Guardar para crear el campo.

Tipos de Campos Especiales ​

Campo de Tipo JSON: message ​

Para almacenar mensajes estructurados:

  1. Crear Campo JSON:

    • Tipo: JSON o Texto (JSON)
    • Nombre: message o el nombre que prefieras

  2. Estructura del JSON:

    json
    {
  "text": "Contenido del mensaje",
  "timestamp": "2024-01-15T10:30:00Z",
  "type": "text",
  "metadata": {
    "source": "whatsapp",
    "read": true
  }
}

  3. Usar en Flujos:

    • Puedes asignar valores JSON desde bloques de acción.
    • Usar Variables: Arrastra las variables desde el panel de variables del editor para acceder al valor del campo.

Campo de Tipo JSON: images_url ​

Para almacenar URLs de imágenes:

  1. Crear Campo JSON:

    • Tipo: JSON
    • Nombre: images_url

  2. Usar en Flujos:

    • Asigna un array de URLs desde un bloque de acción.
    • Usar Variables: Arrastra la variable "images_url" desde el panel de variables del editor para acceder al array de URLs de imágenes.

Campo de Tipo JSON: pdfs ​

Para almacenar información sobre PDFs:

  1. Crear Campo JSON:

    • Tipo: JSON
    • Nombre: pdfs

  2. Estructura del JSON:

    json
    [
  {
    "url": "https://ejemplo.com/documento1.pdf",
    "name": "Catálogo 2024",
    "uploaded_at": "2024-01-15T10:30:00Z",
    "size": 2048576
  },
  {
    "url": "https://ejemplo.com/documento2.pdf",
    "name": "Manual de Usuario",
    "uploaded_at": "2024-01-16T14:20:00Z",
    "size": 1536000
  }
]

  3. Usar en Flujos:

    • Asigna el array de objetos PDF desde bloques de acción.
    • Usar Variables: Arrastra la variable "pdfs" desde el panel de variables del editor para obtener la lista completa de PDFs.

Asignar Valores a Campos Personalizados ​

Desde el Panel de Contacto ​

  1. Abre el contacto desde Contacts.
  2. Busca la sección Campos Personalizados.
  3. Haz clic en el campo que deseas editar.
  4. Ingresa o selecciona el valor.
  5. Guarda los cambios.

Mediante Flujos (Automático) ​

  1. Añadir Bloque de Acción: En tu flujo, arrastra un bloque Action.

  2. Seleccionar Actualizar Campo:

    • Busca Update Custom Field (Actualizar Campo Personalizado) o Set Field.
    • Selecciona el campo que deseas actualizar.

  3. Asignar Valor:

    • Valor Estático: Escribe un valor fijo.
    • Valor Dinámico: Arrastra las variables desde el panel de variables que aparece en el lado derecho del editor. Las variables disponibles incluyen:
      • Texto del mensaje actual
      • Información del contacto (nombre, teléfono, email, etc.)
      • Variables del flujo
      • Cualquier campo personalizado

    Simplemente busca la variable que necesitas en el panel y arrástrala al campo de valor. La plataforma insertará automáticamente la variable en el formato correcto.

    • Para campos JSON, puedes construir el objeto/array completo arrastrando múltiples variables o combinando valores estáticos con variables.

  4. Ejemplo para Campo JSON:

    Campo: images_url
Valor: ["https://ejemplo.com/img1.jpg", "https://ejemplo.com/img2.jpg"]

    O usando variables:

    Campo: images_url
Valor: [Arrastra: URL de imagen 1, Arrastra: URL de imagen 2]

Usar Campos Personalizados en Mensajes ​

Puedes usar campos personalizados en tus mensajes arrastrando las variables desde el panel de variables del editor:

  • Campos Personalizados: Busca el nombre del campo personalizado en el panel de variables y arrástralo al campo de mensaje.
  • Para campos JSON, puedes arrastrar propiedades específicas si están disponibles en el panel de variables.

Ejemplo en Mensaje ​

text
Hola [Variable: Nombre del contacto], 

Veo que estás interesado en [Variable: Producto de interés].

Aquí tienes el catálogo que solicitaste: [Variable: URL del PDF del catálogo]

Nota: Arrastra cada variable desde el panel de variables al campo de texto. La plataforma reemplazará automáticamente cada variable con su valor correspondiente cuando se envíe el mensaje.

Validación y Formato ​

Validación de Campos JSON ​

Cuando uses campos JSON, asegúrate de:

  1. Formato Correcto: El JSON debe ser válido.
  2. Estructura Consistente: Mantén la misma estructura para todos los registros.
  3. Validación en Flujos: Valida el JSON antes de asignarlo.

Ejemplo de Validación en Flujo ​

Condición: Si el campo message es válido
  → Continuar con el flujo
Sino
  → Mostrar error y solicitar corrección

Importar Datos a Campos Personalizados ​

Al importar contactos:

  1. Prepara tu archivo CSV/Excel con columnas para cada campo personalizado.
  2. Durante la importación, mapea las columnas a los campos correspondientes.
  3. Para campos JSON, asegúrate de que los valores estén en formato JSON válido.

Exportar Campos Personalizados ​

Al exportar contactos:

  • Todos los campos personalizados se incluyen en la exportación.
  • Los campos JSON se exportan como texto JSON.

Mejores Prácticas ​

  • Nomenclatura Clara: Usa nombres descriptivos para tus campos.
  • Tipos Apropiados: Selecciona el tipo de dato correcto para cada campo.
  • Documentación: Documenta la estructura de campos JSON complejos.
  • Validación: Implementa validación para asegurar la integridad de los datos.
  • No Duplicar: Evita crear campos que dupliquen información ya disponible.
  • Organización: Agrupa campos relacionados usando prefijos o categorías.
  • Limpieza: Revisa periódicamente campos no utilizados y elimínalos si es necesario.

Casos de Uso Comunes ​

Almacenar Preferencias del Usuario ​

Campo: preferences (JSON)
Valor: {
  "language": "es",
  "notifications": true,
  "theme": "dark"
}

Historial de Productos Vistos ​

Campo: viewed_products (JSON)
Valor: [
  {"product_id": "123", "viewed_at": "2024-01-15"},
  {"product_id": "456", "viewed_at": "2024-01-16"}
]

Información de Lead Scoring ​

Campo: lead_score (Número)
Valor: 85

Notas Estructuradas ​

Campo: internal_notes (JSON)
Valor: [
  {
    "date": "2024-01-15",
    "agent": "Juan Pérez",
    "note": "Cliente interesado en producto premium"
  }
]

Documentación de Botinfy

Copyright © 2026 Botinfy