Skip to main content
A seção Público permite importar contatos que serão utilizados em campanhas. Essa importação é o ponto de partida para campanhas massificadas e garante maior agilidade na preparação de campanhas e na gestão contínua da base de público — um mesmo público pode ser utilizado por mais de uma campanha, se necessário.
Esta página descreve a importação manual feita em Público > Importar público. O layout de arquivo é o mesmo usado na importação automática de campanhas via SFTP — veja Uso de SFTP.
Você pode baixar o arquivo modelo mais atualizado em Público > Importar público > Baixar modelo.

​
Colunas do arquivo de importação

O layout padrão do arquivo de importação possui as seguintes colunas. Se o arquivo do cliente usa nomes de coluna diferentes, um Mapeamento de Layout de Importação pode traduzi-los automaticamente.
* Pelo menos um dos dois (template_code ou template_external_code) deve ser informado — veja as regras abaixo.
Os nomes de coluna abaixo passaram por uma padronização (de português em maiúsculas para inglês em minúsculas). Se você mantém um arquivo de importação de antes dessa mudança, ele continua funcionando sem alteração — um Mapeamento de Layout de Importação legado foi cadastrado automaticamente para cada Ambiente com histórico de importações, traduzindo os nomes antigos para os novos.

​
Campos de Observação

notes_1, notes_2, notes_3, notes_4 (opcionais) são campos livres para informações adicionais. Esses dados:
  • são armazenados no Maestro;
  • podem ser utilizados em relatórios;
  • não interferem na validação ou envio das campanhas.

​
Campo de Referência para o Provedor

broker_account_reference (opcional) é um campo livre para uma referência externa. Quando informado, é armazenado no Maestro e pode ser enviado ao provedor no momento do envio (quando suportado).
Não confunda broker_account_reference com a coluna broker. broker_account_reference é uma referência externa livre, repassada ao provedor; broker define qual provedor fará o envio.

​
Definir o Provedor no Envio (broker)

broker (opcional — apenas SMS e RCS) define o provedor de saída para o registro, informando o nome do provedor exatamente como cadastrado em Configurações > Integração com provedores (ex.: Pontal, Classe A). O valor é sensível a maiúsculas/minúsculas e a espaços.
  • Vazio → mantém o roteamento por segmento atual, conforme configurado na Integração com Provedores.
  • Preenchido e válido → força a utilização do provedor indicado.
  • Nome inválido → o arquivo é rejeitado.
  • Canais diferentes de SMS e RCS ignoram a coluna.

​
Variáveis do Template

Qualquer coluna do arquivo que não corresponda a uma das colunas padrão listadas acima é tratada como uma variável de template, disponível pelo nome literal usado no cabeçalho — não precisa estar numa posição específica do arquivo:
Essas variáveis podem ser utilizadas no template como {{Var1}}, {{Var2}}, {{Var3}} etc. — o nome usado no template precisa ser exatamente o nome da coluna no arquivo.

​
Coluna sms_flash

sms_flash (opcional): valores possíveis SIM ou NÃO. Indica que o contato deve receber um SMS do tipo flash (mensagem em formato de pop-up).
O recurso de SMS Flash também precisa estar contratado/habilitado no provedor Pontal — não basta habilitar apenas no Maestro.

​
Código do Template Externo (template_external_code)

A coluna template_external_code permite a integração com sistemas externos de validação de templates. Como funciona:
  • Representa um identificador externo do template.
  • Pode ser usado como alternativa ao template_code.
  • O sistema prioriza o código externo quando informado.
Regras:
  • Pelo menos um dos campos (template_code ou template_external_code) deve ser informado — se ambos estiverem vazios, ocorre erro.
  • Se o código externo não for encontrado, o sistema procura pelo código de template do Maestro.
  • Se nenhum dos dois for encontrado, ocorre erro.

​
Observações importantes

  • As colunas notes_1 a notes_4 são apenas informativas.
  • O campo broker_account_reference é opcional.
  • A coluna broker é opcional e vale apenas para SMS e RCS.
  • Colunas fora da lista padrão são tratadas como variáveis dinâmicas, independentemente de onde aparecem no arquivo.
Teve o arquivo rejeitado na importação? Veja Troubleshooting.