Gestão de Público

Um Público é a lista de pessoas que seu Finn vai ligar (campanhas outbound) ou que deverá atender (segmentação inbound). Pense nele como uma lista de contatos — mas com informações extras que ajudam o Finn a personalizar cada ligação.

Antes de começar. Os dois caminhos para importar contatos são upload de CSV (mais rápido para listas pontuais) e sincronização com CRM (melhor quando os contatos mudam constantemente). A maioria dos usuários começa com CSV para testar e depois migra para a sincronização com CRM ao entrar em produção.

Ligações de teste não precisam de um público real. Ao testar um Finn com você mesmo, não é preciso configurar público nenhum — basta usar o botão "Test on Call" na página do Finn. Públicos servem para campanhas reais.

Onde encontrar

Barra lateral → Audience.

A página Audience — todas as listas de contatos que você criou, com contagem de linhas e status de importação.

A página lista todos os públicos que você criou, com contagem de linhas e data da última atualização. Clique em um deles para visualizar, editar ou exportar contatos.

Importação via CSV

A forma mais rápida de trazer contatos.

Cabeçalhos obrigatórios

Seu CSV deve conter estas colunas, com os nomes exatos:

name, phone_number, country_code

• name — o nome de exibição do contato. Usado pelo Finn ("Oi, é a Alice?") e exibido nas análises.
• phone_number — apenas os dígitos locais. Sem código do país, sem formatação.
• country_code — com o + inicial. Exemplos: +1 (EUA/Canadá), +44 (Reino Unido), +91 (Índia), +61 (Austrália).

Cabeçalhos opcionais

Qualquer coluna extra vira um campo personalizado que o Finn pode referenciar durante a ligação. Use isso para passar contexto.

name, phone_number, country_code, account_tier, last_order_date, account_manager
Alice Chen, 5551234567, +1, Enterprise, 2026-03-12, Sam Patel
Bob Singh, 9876543210, +91, SMB, 2026-01-05, Maya Lee

Na instrução ou no workflow do Finn, referencie campos com a sintaxe {{account_tier}}. Exemplo:

Cumprimente o contato pelo nome. Se {{account_tier}} for "Enterprise", mencione que ele tem suporte prioritário.

Armadilhas de formatação do CSV

• Codificação — salve como UTF-8. O Excel às vezes usa ISO-8859-1 por padrão, o que quebra acentos e alfabetos não latinos.
• Aspas — coloque campos com vírgulas entre aspas duplas: "Patel, Sam".
• Células vazias — deixe em branco, não escreva null nem n/a. A plataforma trata esses valores como texto literal.
• Números duplicados — a plataforma remove duplicatas por (country_code, phone_number). A primeira ocorrência prevalece.
• Cabeçalhos — devem estar na linha 1. Não adicione título ou instruções acima da linha de cabeçalho.

Validação

Após o upload, a plataforma valida cada linha e mostra:

• Válido — pronto para ligar.
• Telefone inválido — não foi possível interpretar o número (formato errado, curto demais etc).
• Duplicado — o número já existe neste público.
• Suprimido — o número está na lista global de não perturbe.

Você pode editar linhas inválidas na própria tabela antes de confirmar a importação.

Integração com CRM

Sincronize contatos direto do seu CRM. Sem exportar CSV, sem dados desatualizados.

CRMs suportados

• HubSpot — listas, listas inteligentes, propriedades de contato.
• Salesforce — listas, relatórios, objetos de lead/contato.
• Pipedrive — filtros, entidades de pessoa/negócio.

Conectando

1. Settings → Integrations → clique no seu CRM.
2. Autorize via OAuth (você será redirecionado ao seu CRM e depois de volta).
3. Escolha quais listas/segmentos importar.
4. Defina uma frequência de sincronização (a cada 15 min, por hora, diariamente) ou sincronize sob demanda.

Mapeamento de campos

Após a autorização, mapeie os campos do seu CRM para os campos do Finn:

Os mapeamentos são salvos por conexão de CRM. Altere-os depois em Configurações → Integrações → [CRM] → Mapeamento de campos.

Sincronização bidirecional

Por padrão, a sincronização é unidirecional (CRM → Finn). Para gravar os resultados das chamadas de volta no seu CRM, ative Outcome Sync durante a configuração da conexão. Cada resultado de chamada vira um registro de atividade ou uma atualização de propriedade no CRM.

Cadastro manual

Para contatos avulsos (testes, demonstrações): Audiência → [Audiência] → Adicionar contato. Preencha nome, código do país, telefone e quaisquer campos personalizados.

Segmentação

Dentro de uma audiência, você pode criar segmentos — subconjuntos filtrados com base em qualquer campo personalizado.

Exemplo: em uma audiência de 50.000 linhas marcada com account_tier, crie um segmento Enterprise que filtra account_tier = "Enterprise". Você pode então implantar um Finn diferente apenas para esse segmento.

As definições de segmento são dinâmicas — quando os contatos subjacentes mudam, o segmento é atualizado automaticamente.

Listas de supressão

Suprima globalmente os números que nunca devem ser chamados:

• Configurações → Conformidade → Lista de não perturbe — cole ou envie os números.
• Os números dessa lista são descartados silenciosamente em todas as implantações, independentemente da audiência em que estejam.

Use isso para cancelamentos de inscrição, reclamações, números listados por reguladores e números internos que você não quer discar por acidente.

Exportação

Audiência → Exportar → CSV. Inclui todos os campos personalizados e o timestamp original da importação.

Limites de tamanho da audiência

Atingiu um limite? Consulte Cobrança e planos →.

Padrões comuns

• Lista fria — público único importado de CSV, implantado uma vez, arquivado.
• Pipeline ativo sincronizado com CRM — público com sincronização automática de "leads no estágio X". A implantação é executada continuamente, captando novos leads conforme eles chegam.
• Segmentação por nível — um público grande, vários segmentos, Finns diferentes por segmento.
• Público de teste — um público de 5 linhas com o seu número e o de colegas. Use para todo teste inicial de implantação.

Próximos passos

• Campanhas e implantações → — direcione um Finn para um público.
• Integrações → — referência completa de CRM, calendário e webhook.