> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maestro.robbu.global/llms.txt
> Use this file to discover all available pages before exploring further.

# Público

> Importação e gestão de contatos para uso em campanhas.

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.

<Note>
  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](/integracoes/uso-de-sftp).
</Note>

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](/integracoes/mapeamento-de-layouts) pode traduzi-los automaticamente.

```
destination_value, channel, template_code, template_external_code, segment,
document_number, contract_code, sender, dispatch_at, customer_name, attachment_file_name,
notes_1, notes_2, notes_3, notes_4, broker_account_reference, broker, sms_flash
```

| Coluna                   | Obrigatório | Descrição                                                                                           |
| ------------------------ | ----------- | --------------------------------------------------------------------------------------------------- |
| `destination_value`      | ✅           | Registro do destinatário: número de telefone com DDD ou e-mail.                                     |
| `channel`                | ✅           | Canal de envio: `whatsapp`, `sms`, `email` ou `rcs`. Uma mesma pessoa pode ter uma linha por canal. |
| `template_code`          | ✅\*         | Código do template a ser usado.                                                                     |
| `template_external_code` | ✅\*         | Código externo do template (ver seção "Código do Template Externo" abaixo).                         |
| `segment`                | Opcional    | Segmento associado à campanha.                                                                      |
| `document_number`        | Opcional    | Documento do cliente (evita homônimos, permite integrações externas).                               |
| `contract_code`          | Opcional    | Identificador interno da empresa (ex.: número de contrato).                                         |
| `sender`                 | Opcional    | Número ou identificador do remetente (ex.: número de envio no WhatsApp).                            |
| `dispatch_at`            | Opcional    | Data e hora para envio da mensagem.                                                                 |
| `customer_name`          | Opcional    | Recomendado para facilitar localização e interação.                                                 |
| `attachment_file_name`   | Opcional    | Nome do arquivo de anexo.                                                                           |

\* Pelo menos um dos dois (`template_code` ou `template_external_code`) deve ser informado — veja as regras abaixo.

<Warning>
  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](/integracoes/mapeamento-de-layouts) legado foi cadastrado automaticamente para cada Ambiente com histórico de importações, traduzindo os nomes antigos para os novos.
</Warning>

## 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).

<Warning>
  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.
</Warning>

## 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](/integracoes/integracao-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:

```
...;notes_1;notes_2;notes_3;notes_4;broker_account_reference;broker;Var1;Var2;Var3
```

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).

<Warning>
  O recurso de SMS Flash também precisa estar contratado/habilitado no provedor Pontal — não basta habilitar apenas no Maestro.
</Warning>

## 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](/central-de-suporte/troubleshooting).