Skip to main content
Configurações gerais do job de importação:
  • Tipo: Job recorrente para processamento automático
  • Frequência: A cada 2 minutos
  • IPs de saída: 191.233.248.49 e 104.41.0.210 — libere-os no firewall se usar servidor FTP/SFTP próprio

Configurar Conexão FTP

Conexão com Servidor Próprio

Caminho: Invenio Center > Configurações > FTP
Acesso direto: Configurações
1

Acessar configurações FTP

Acesse: Invenio Center > Configurações > FTP
2

Preencher os parâmetros de conexão

CampoValor / Observação
ServidorEndereço do servidor (ex: ftp.robbu.com.br) — sem https://
UsuárioNome de usuário para autenticação
SenhaSenha de acesso
PortaFTP → 21 · SFTP → 22
Modo de criptografiaDepende do servidor — o mais comum é Use Explícito
3

Validar a conexão

Após salvar, o sistema exibe imediatamente se a conexão foi bem-sucedida.
Para validação extra, use FileZilla ou WinSCP enviando um arquivo de teste.
Regras de preenchimento do servidor:
  • ❌ Não inclua https:// no início — informe apenas o endereço (ex: ftp.seudominio.com)
  • ❌ Não utilize IPs privados como host:
    • 10.x.x.x
    • 172.16.x.x até 172.31.x.x
    • 192.168.x.x

Nomenclatura dos Arquivos

Os arquivos devem seguir o padrão de nomenclatura abaixo para serem processados corretamente. A ordem dos parâmetros importa. Formato base: mailing_DDMMYY_999[_parâmetros].csv
ParâmetroDescrição
mailingObrigatório — todo arquivo deve começar com mailing
_DDMMYYData da geração do arquivo — o sistema importa apenas arquivos com a data do dia corrente
_999Sequência do arquivo no dia — não pode haver dois arquivos com mesma sequência no mesmo dia
_cXXXXXXXXCódigo da carteira — se omitido, o arquivo deve estar numa pasta com o nome da carteira
_dDESCRICAODescrição do mailing — se omitido, usa o nome do arquivo. Não pode conter _ (underline)
_hHigienização dos contatos durante a importação
_smslongCampanha SMS via longcode
_smsshortCampanha SMS via shortcode
_whatsappexclusivoCampanha WhatsApp Oficial com número exclusivo
_whatsappcompartilhadoCampanha WhatsApp Oficial com número compartilhado
_nw99999999999Número de WhatsApp exclusivo para a campanha
_ntNOME_TEMPLATENome do template WhatsApp a ser utilizado
_emailCampanha de E-mail para o mailing
_ceEMAIL@DOMINIOConta de e-mail remetente — padrão: conta ativa do cliente
_teTITULOAssunto/título do e-mail da campanha
_iDDMMYYHHMMData e hora de início da campanha (ex: _i0102180820 = 01/02/18 às 08:20)
_q88999Envio parcelado: 88% por lote · 999 minutos de intervalo
_x999Descarta contatos com interação nas últimas 999 horas — posicionar antes de _nt
_limpartagSubstitui todas as tags dos contatos pela nova tag do arquivo
_removercarteirasRemove o contato das demais carteiras, mantendo apenas a do arquivo
_LEddMMyyHHmmData/hora limite de envio — evita disparos fora do horário desejado
_whatsappprospectCampanha via WhatsApp Prospect — usar apenas quando houver números prospects
_whatsappprospect deve ser usado somente quando houver números prospects no arquivo. Caso contrário, use _whatsappexclusivo com _nw para especificar o número. O uso incorreto causa falha na importação.

Exemplos de Nomenclatura

Ação: Importa sem especificar carteira.O arquivo deve estar em uma pasta cujo nome é o código da carteira.
Ação: Importa na carteira 123 com a descrição Régua 60 dias.
Ação: Importa na carteira 123 e executa higienização dos contatos.
Ação: Importa na carteira ALTORISCO3 e cria campanha de SMS Longcode com início em 01/02/18 às 08:20.
Ação: Importa na carteira BRAD e cria campanha de SMS Shortcode com início imediato, enviando 15% da base a cada 20 minutos.
Ação: Importa na carteira MAIOR30, cria campanha de WhatsApp Oficial (número exclusivo 11998877665, template TEMPLATE HOMOLOGADO ITAU) com início imediato, descartando contatos com interação nas últimas 36 horas.
Ação: Importa na carteira 123 e cria campanha de E-mail com assunto Aportunidade!!! usando a conta AVISO@COMUNICADO.COM.BR.


⁉️ Perguntas Frequentes (FAQ)

O job de importação roda a cada 2 minutos, garantindo ingestão contínua dos arquivos válidos no servidor.
Se você usa servidor FTP/SFTP próprio, libere:
  • 191.233.248.49
  • 104.41.0.210
Sem essa liberação, a conexão pode falhar silenciosamente.
Caminho: Invenio Center > Configurações > Conta > Gerenciar > FTP > Habilitar transferência de arquivosUse o endpoint fornecido com prefixo sftp:// e porta 22.
Erro comumCorreto
Incluir https:// na URLApenas o endereço: ftp.dominio.com
Usar IP privado como hostUsar domínio ou IP público
Porta erradaFTP = 21 · SFTP = 22
Use FileZilla ou WinSCP para validar antes de configurar na plataforma.
Sempre a data do dia corrente no formato _DDMMYY. O sistema ignora arquivos com datas diferentes do dia de processamento.
Representa a ordem do arquivo no dia. Não pode haver dois arquivos com a mesma sequência no mesmo dia — isso causaria conflito de importação.
Coloque o arquivo em uma pasta cujo nome é o código da carteira. O sistema lerá o nome da pasta como identificador da carteira.
Use _q88999 onde:
  • 88 = percentual da base enviado por lote
  • 999 = intervalo em minutos entre lotes
Exemplo: _q15020 → 15% por lote, a cada 20 minutos.
Use _x999 para descartar contatos com interação nas últimas 999 horas.⚠️ Atenção: O parâmetro _x deve vir antes de _nt (nome do template) no nome do arquivo.
Combine os parâmetros conforme o tipo de número:
  • Número exclusivo: _whatsappexclusivo + _nw11999000000 + _ntNOME_TEMPLATE
  • Número compartilhado: _whatsappcompartilhado + _ntNOME_TEMPLATE
  • Prospect: _whatsappprospect + _ntNOME_TEMPLATE (somente se houver números prospects)