Uso de SFTP

​

Configuração

• Nome da conta
• Conta ativa — contas inativas não são lidas pelas rotinas de importação
• Serviços vinculados — as importações que a conta atende, cada uma com a sua pasta (veja Serviços e pastas, abaixo)

​

SFTP Robbu

​

SFTP Próprio

​

Segurança

• Mantenha as credenciais em segurança.
• Garanta o uso correto de porta e endereço do servidor.
• A proteção desses dados garante a integridade dos arquivos durante as transferências.

​

Serviços e pastas

• processed — arquivos importados com sucesso
• error — importações que falharam, com sinalização do erro encontrado

​

Importar campanhas

​

Nome do arquivo

​

Colunas do arquivo

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,Var1,Var2
+5511988887777,whatsapp,W0003,,Varejo,12345678900,CT-98765,+5511999998888,2025-09-01 14:56:00,João Silva,,,,,,,,NÃO,Promoção de Inverno,10%
cliente@dominio.com,email,E0001,BR001,Financeiro,98765432100,CT-12345,,2025-09-01 15:10:00,Maria Souza,Fatura_Maria_Souza_07_2025.pdf,,,,,,NÃO,Fatura 07/2025,R$350
+5511977776666,sms,S0002,BR002,Atacado,11223344556,CT-45678,,2025-09-01 15:30:00,Carlos Lima,,,,,,Pontal,SIM,Código 123456,Validade 5min

​

Fluxo de processamento

1. Faça upload do arquivo .csv na pasta configurada para o serviço Campanhas.
2. Um serviço rotineiro roda a cada 10 minutos: cria as subpastas processed, processing e error na pasta de Campanhas, se não existirem, e busca arquivos .csv ainda não importados.
3. Durante a importação, são validados: se cada linha cumpre as regras do ambiente (segmento existe e a empresa tem acesso; templates publicados — no WhatsApp sem provedor configurado, também aprovados; horários de saída válidos; se a coluna broker for informada, se o provedor existe e é compatível com o segmento — nome inválido ou provedor sem perfil rejeita o arquivo inteiro).
4. Arquivos de anexo (PDF), se houver, são removidos do SFTP durante a importação.
5. Se a importação der certo, a subpasta processed recebe {nome original}_validated.csv, com os contatos válidos, e {nome original}_errors.csv, com as linhas que não serão enviadas — inclusive contatos de um canal sem provedor configurado — e a coluna adicional Motivo falha.
6. Se o arquivo inteiro falhar, a subpasta error recebe {nome original}_errorDetail.txt, com o motivo, e {nome original}_exceptions.csv, com as linhas e a coluna Motivo falha.

​

Importar templates

​

Nome do arquivo

{nome do segmento}_{canal}_[{nome da WABA}]_{data}.csv

• nome do segmento: nome exato do segmento configurado (Segmentos).
• canal: email | sms | whatsapp | rcs (case-insensitive).
• nome da WABA (opcional, apenas WhatsApp): descrição da WABA.
• data: formato yyyyMMdd (ex.: 20250531).

​

Colunas do arquivo, por canal

template_name,language,category,header_text,body_text,footer_text,reply_button_1,reply_button_2,reply_button_3,
url_button,url_button_text,template_status,reasons,template_code,external_code

template_name,subject,body_html,template_status,reasons,template_code,external_code

template_name,text_body,template_status,reasons,template_code,external_code

template_name;message_type;message;title;fallback;suggestion_1_title;suggestion_1_type;suggestion_1_value;
suggestion_2_title;suggestion_2_type;suggestion_2_value;suggestion_3_title;suggestion_3_type;suggestion_3_value;
suggestion_4_title;suggestion_4_type;suggestion_4_value;template_status;reasons;template_code;external_code

​

Fluxo de processamento

1. Faça upload do .csv na pasta configurada para o serviço Templates.
2. Um serviço rotineiro roda a cada 10 minutos: cria as subpastas processed e error na pasta de Templates, se não existirem, e busca arquivos ainda não importados.
3. Validações: nome do arquivo segue o padrão, segmento existe e a empresa tem acesso, campos obrigatórios do cenário estão presentes.
4. O comportamento da importação varia conforme os campos informados — veja Fluxos.
5. O arquivo é movido para a subpasta processed (sucesso) ou error (falha), gerando {nome do arquivo original}_errorDetail.txt em caso de erro.

​

Fluxos

​

Regras

• template_status aceita apenas APROVADO ou REJEITADO.
• reasons é obrigatório quando template_status=REJEITADO; motivos múltiplos separados por |, cada um previamente cadastrado no Maestro.
• O template existente deve estar com status Em Revisão para ser revisado.
• external_code deve ser único por empresa.
• Se qualquer linha do arquivo contiver erro, nenhuma linha é processada.

​

FAQ