Configuración

Enriquecimiento de datos (conector genérico)

Apunta a tu proveedor de enriquecimiento (Clearbit, Apollo, Hunter, People Data Labs, el que prefieras) y completa automáticamente los campos vacíos de empresas y contactos.

El enriquecimiento de datos es un conector genérico y neutral: usas la cuenta del proveedor de enriquecimiento que prefieras (Clearbit, Apollo, Hunter, People Data Labs, entre otros). Indicas la dirección del proveedor, cómo autenticar y un mapeo de campos; el CRM consulta al proveedor y completa solo los campos vacíos del registro. No hay ningún costo de nuestra parte: la cuenta y el cobro son del proveedor que elijas.

El conector nace inerte: no ocurre nada hasta que lo configures. La API key que indicas se guarda cifrada y nunca se muestra de vuelta.

Requisitos previos

Una cuenta en un proveedor de enriquecimiento (Clearbit, Apollo, Hunter, People Data Labs u otro) con una API key activa y créditos/plan suficiente.
La documentación de la API de ese proveedor a mano: el endpoint, el header de autenticación (ej.: Authorization: Bearer, o X-Api-Key) y la estructura del JSON de respuesta (para armar el mapeo).
En Sellio, ser administrador para guardar el conector en Configuración → Integraciones.

Paso a paso en el proveedor

Ingresa al panel de tu proveedor de enriquecimiento y localiza el área de API/Developers.
Genera (o copia) una API key.
Anota el endpoint de consulta por dominio y/o correo y el formato exacto del header de autenticación exigido; cada proveedor tiene el suyo.

Cómo configurar

Abre Configuración → Integraciones y ve a la tarjeta "Enriquecimiento de datos".
Endpoint (URL): pega la dirección del proveedor usando los marcadores {domain} y/o {email}. El CRM reemplaza {domain} por el dominio del registro (del sitio/dominio o del dominio del correo) y {email} por el correo del registro.
Header de autenticación y Prefijo: indica el nombre del header (ej.: Authorization) y el prefijo del valor (ej.: "Bearer " con un espacio). Algunos proveedores usan un header propio, como X-Api-Key, sin prefijo.
API key: pega tu clave del proveedor. Se guarda cifrada.
Mapeo de campos: cada línea vincula una ruta de la respuesta del proveedor (a la izquierda) con un campo del CRM (a la derecha). Agrega tantas líneas como necesites.
Guarda el conector. Luego, en el detalle de una Empresa o Contacto, usa el botón "Enriquecer".

Cómo armar el mapeo

A la izquierda va la ruta del valor dentro de la respuesta JSON del proveedor, usando puntos para bajar niveles (y números para posiciones de lista). A la derecha va el api_name del campo del CRM que recibirá el valor. Solo se completan campos VACÍOS: los datos que ya existen en el registro nunca se sobrescriben.

Ejemplo: Endpoint: https://api.proveedor.com/v1/company?domain={domain} • Header: Authorization • Prefijo: "Bearer " • Mapeo: company.name → name, company.metrics.employees → employee_count, company.location.country → country

💡 Si la respuesta trae una lista, usa el índice: contacts.0.email toma el correo del primer elemento. Los valores que son objetos o listas enteras se ignoran: solo los valores simples (texto, número) caben en un campo.

Para enriquecer, el registro debe tener al menos un sitio/dominio o un correo; de ahí sale el {domain}/{email} de la consulta. Las empresas suelen tener sitio; los contactos y leads, correo.

Sin proveedor propio: modo del sistema y modo simulado

Si no configuras un proveedor propio, el botón "Enriquecer" sigue disponible. Cuando Sellio tiene un proveedor del sistema activo, cada enriquecimiento rellena los campos firmográficos estándar (empleados, ingresos, sector, tecnologías, LinkedIn, país) y consume 1 crédito por registro, cobrado de forma transparente en tu factura. Sin ningún proveedor, el CRM usa datos simulados de ejemplo (sin costo), útiles para probar el flujo. La tarjeta de Integraciones muestra qué modo está activo.

Enriquecimiento masivo y automático

Masivo: selecciona varios registros en la lista de Empresas, Contactos o Leads y haz clic en "Enriquecer" en la barra de acciones. El CRM los enriquece todos a la vez, rellenando solo los campos vacíos.
Automático al crear: en Configuración → Integraciones, activa "Enriquecer automáticamente al crear un registro". Cada nueva empresa, contacto o lead rellena sus campos vacíos en cuanto se crea.
Recuperación diaria: una rutina automática revisa los registros recientes de los tenants con la opción activa y completa lo pendiente, dentro de un límite diario. Reprocesar el mismo registro nunca cobra dos veces.

Cómo probar

Abre una Empresa que tenga sitio/dominio (o un Contacto con correo) y cuyos campos estén parcialmente vacíos.
Haz clic en "Enriquecer".
Verifica que los campos vacíos se completaron según tu mapeo. Compara con la respuesta esperada del proveedor para validar las rutas JSON.

Solución de problemas

401/403 del proveedor: API key incorrecta/vencida o header de autenticación incorrecto. Verifica el nombre del header y el prefijo (ej.: "Bearer " con espacio) y vuelve a pegar la clave.
No se completa nada: verifica que las rutas del mapeo coincidan con el JSON real del proveedor (usa puntos para bajar niveles e índices para listas, ej.: contacts.0.email). Solo valores simples (texto/número) caben en un campo; objetos/listas enteras se ignoran.
No completa aun con datos: el enriquecimiento solo escribe en campos VACÍOS; si el campo ya tenía un valor, se preserva por diseño.
El botón "Enriquecer" no hace nada: confirma que el registro tiene sitio/dominio o correo (la consulta usa {domain}/{email}) y que el endpoint usa esos marcadores.
404/endpoint inválido: revisa la URL del endpoint y si el proveedor espera dominio o correo en la consulta.

Abrir este artículo dentro del sistema →