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. Para a importação automática de campanhas via SFTP, que usa um layout de arquivo diferente, 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:
* Pelo menos um dos dois (CODIGO_TEMPLATE ou CODIGO_TEMPLATE_EXTERNO) deve ser informado — veja as regras abaixo.

​
Campos de Observação

OBS1, OBS2, OBS3, OBS4 (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_REFERENCE (opcional) é um campo livre para uma referência externa. Quando informado, é armazenado no Maestro e pode ser enviado ao provedor no momento do disparo (quando suportado).
Não confunda BROKER_REFERENCE com a coluna BROKER. BROKER_REFERENCE é uma referência externa livre, repassada ao provedor; BROKER define qual provedor fará o disparo.

​
Definir o Provedor no Disparo (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

As variáveis do template devem ser adicionadas após a última coluna do arquivo — atualmente a coluna BROKER. Tudo que estiver após a última coluna do modelo é tratado como campo adicionado manualmente pelo usuário:
Essas variáveis podem ser utilizadas no template como {{Var1}}, {{Var2}}, {{Var3}} etc.

​
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 (CODIGO_TEMPLATE_EXTERNO)

A coluna CODIGO_TEMPLATE_EXTERNO 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 CODIGO_TEMPLATE.
  • O sistema prioriza o código externo quando informado.
Regras:
  • Pelo menos um dos campos (CODIGO_TEMPLATE ou CODIGO_TEMPLATE_EXTERNO) 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 OBS1 a OBS4 são apenas informativas.
  • O campo BROKER_REFERENCE é opcional.
  • A coluna BROKER é opcional e vale apenas para SMS e RCS.
  • Todas as colunas após BROKER são tratadas como variáveis dinâmicas.
Teve o arquivo rejeitado na importação? Veja Troubleshooting.