Configuração

Enriquecimento de dados (conector genérico)

Aponte o seu provedor de enriquecimento (Clearbit, Apollo, Hunter, People Data Labs, o que preferir) e preencha automaticamente os campos vazios de empresas e contatos.

O enriquecimento de dados é um conector genérico e neutro: você usa a conta do provedor de enriquecimento que preferir (Clearbit, Apollo, Hunter, People Data Labs, entre outros). Você informa o endereço do provedor, como autenticar e um mapeamento de campos; o CRM consulta o provedor e preenche apenas os campos vazios do registro. Não há nenhum custo nosso: a conta e a cobrança são do provedor que você escolher.

O conector nasce inerte: nada acontece até você configurá-lo. A API key que você informa fica cifrada e nunca é exibida de volta.

Pré-requisitos

Uma conta em um provedor de enriquecimento (Clearbit, Apollo, Hunter, People Data Labs ou outro) com uma API key ativa e créditos/plano suficiente.
A documentação da API desse provedor à mão: o endpoint, o header de autenticação (ex.: Authorization: Bearer, ou X-Api-Key) e a estrutura do JSON de resposta (para montar o mapeamento).
No Sellio, ser administrador para salvar o conector em Configurações → Integrações.

Passo a passo no provedor

Entre no painel do seu provedor de enriquecimento e localize a área de API/Developers.
Gere (ou copie) uma API key.
Anote o endpoint de consulta por domínio e/ou e-mail e o formato exato do header de autenticação exigido; cada provedor tem o seu.

Como configurar

Abra Configurações → Integrações e vá ao cartão "Enriquecimento de dados".
Endpoint (URL): cole o endereço do provedor usando os marcadores {domain} e/ou {email}. O CRM substitui {domain} pelo domínio do registro (do site/domínio ou do domínio do e-mail) e {email} pelo e-mail do registro.
Header de autenticação e Prefixo: informe o nome do header (ex.: Authorization) e o prefixo do valor (ex.: "Bearer " com um espaço). Alguns provedores usam um header próprio, como X-Api-Key, sem prefixo.
API key: cole a sua chave do provedor. Ela é guardada cifrada.
Mapeamento de campos: cada linha liga um caminho da resposta do provedor (à esquerda) a um campo do CRM (à direita). Adicione quantas linhas precisar.
Salve o conector. Depois, no detalhe de uma Empresa ou Contato, use o botão "Enriquecer".

Como montar o mapeamento

À esquerda vai o caminho do valor dentro da resposta JSON do provedor, usando pontos para descer níveis (e números para posições de lista). À direita vai o api_name do campo do CRM que receberá o valor. Só campos VAZIOS são preenchidos: dados que já existem no registro nunca são sobrescritos.

Exemplo: Endpoint: https://api.provedor.com/v1/company?domain={domain} • Header: Authorization • Prefixo: "Bearer " • Mapeamento: company.name → name, company.metrics.employees → employee_count, company.location.country → country

💡 Se a resposta trouxer uma lista, use o índice: contacts.0.email pega o e-mail do primeiro item. Valores que são objetos ou listas inteiras são ignorados; só valores simples (texto, número) cabem num campo.

Para enriquecer, o registro precisa ter ao menos um site/domínio ou um e-mail: é dele que sai o {domain}/{email} da consulta. Empresas costumam ter site; contatos e leads, e-mail.

Sem provedor próprio: modo do sistema e modo simulado

Se você não configurar um provedor próprio, o botão "Enriquecer" continua disponível. Quando o Sellio tem um provedor do sistema ligado, cada enriquecimento preenche os campos firmográficos padrão (funcionários, receita, setor, tecnologias, LinkedIn, país) e consome 1 crédito por registro, cobrado de forma transparente na sua fatura. Sem nenhum provedor, o CRM usa dados simulados de exemplo (sem custo), úteis para experimentar o fluxo. O cartão de Integrações mostra qual modo está ativo.

Enriquecimento em massa e automático

Em massa: selecione vários registros na lista de Empresas, Contatos ou Leads e clique em "Enriquecer" na barra de ações. O CRM enriquece todos de uma vez, preenchendo só os campos vazios.
Automático ao criar: em Configurações → Integrações, ligue "Enriquecer automaticamente ao criar registro". Toda nova empresa, contato ou lead passa a ter os campos vazios preenchidos assim que é criado.
Recuperação diária: uma rotina automática revisa os registros recentes dos tenants com a opção ligada e completa o que ficou pendente, respeitando um limite por dia. Reprocessar o mesmo registro nunca cobra duas vezes.

Como testar

Abra uma Empresa que tenha site/domínio (ou um Contato com e-mail) e cujos campos estejam parcialmente vazios.
Clique em "Enriquecer".
Confira se os campos vazios foram preenchidos conforme o seu mapeamento. Compare com a resposta esperada do provedor para validar os caminhos JSON.

Solução de problemas

401/403 do provedor: API key errada/expirada ou header de autenticação incorreto. Confira o nome do header e o prefixo (ex.: "Bearer " com espaço) e recole a chave.
Nada é preenchido: verifique se os caminhos do mapeamento batem com o JSON real do provedor (use pontos para descer níveis e índices para listas, ex.: contacts.0.email). Só valores simples (texto/número) cabem num campo; objetos/listas inteiras são ignorados.
Não preenche mesmo com dados: o enriquecimento só grava em campos VAZIOS; se o campo já tinha valor, ele é preservado por design.
Botão "Enriquecer" não faz nada: confirme que o registro tem site/domínio ou e-mail (a consulta usa {domain}/{email}) e que o endpoint usa esses marcadores.
404/endpoint inválido: revise a URL do endpoint e se o provedor espera domínio ou e-mail na consulta.

Abrir este artigo dentro do sistema →