Integração Via Arquivo Texto/CSV FTP/SFTP

O processo de carga de mailing via arquivo texto é um processo alternativo aos processos de
integração via "Stored Procedures" e integração via "Web Services".
Oferece vantagens na facilidade de rastreabilidade e depuração dos dados de integração.

Resumo do processo:

- O cliente cria e disponibiliza os dados do servidor FTP/SFTP para a operação Callflex.
- A operação Callflex configura os daemons e as campanhas que irão usar a integração.
- O cliente disponibiliza o arquivo texto gerado pelo CRM na pasta "IMPORTAR".
- O sistema MGE baixa e processa os arquivos disponíveis na pasta "IMPORTAR".
- O sistema MGE insere/atualiza/remove as fichas e telefones da campanha conforme o tipo de arquivo.
- Para arquivos do tipo INCREMENTAL as fichas e telefones são inseridas ou atualizadas.
- Para arquivos do tipo BAIXA as fichas e telefones são removidos da campanha.
- Para arquivos do tipo BOLETO as fichas as fichas são enriquecidas com os dados de fatura do cliente.

A movimentação dos arquivos feita pelo MGE vai ocorrer como segue:
- O MGE vai ler a pasta "IMPORTAR" de tempos em tempos (conforme configurado) e vai baixar e processar os arquivos encontrados.
- Arquivos importados que já tenham sido processados serão movidos para pasta de "DUPLICADOS".
- Arquivos que contenham qualquer erro de nomenclatura ou de conteúdo serão movidos para pasta de "PENDENTES".
  No caso de arquivos com erro um arquivo de log será gerado e disponibilizado na pasta "PENDENTES".
- Arquivos processados corretamente serão movidos para pasta "PROCESSADOS".

IMPORTANTE: Para que o MGE possa ler o arquivo corretamente, o arquivo deve seguir a nomenclatura a risca.
O sistema do cliente deve garantir que o arquivo só será disponibilizado na pasta "IMPORTAR" quando estiver 100% carregado.
Existem duas formas de fazer isso. A primeira é fazer o upload do arquivo com a extensão ".tmp", e após o arquivo estar completo trocar para extensão correta (TXT ou CSV).
O MGE está preparado para ignorar arquivos com a extensão ".tmp".
Outra forma de fazer isso, é fazer o carregamento do arquivo em uma pasta de temporários de escolha do cliente, e só após o arquivo estar completo, mover para a pasta de importação.
Ambos procedimentos devem garantir que o MGE não vai ler um arquivo que ainda não foi totalmente carregado.

Especificações do arquivo:

Nomenclatura do arquivo: DATA_HORA_IDCAMPANHA_TIPO.EXT

DATA : Data da geração do arquivo no formato: AAAAMMDD

HORA : Hora da geração do arquivo no formato: HHMMSS

IDCAMPANHA : ID da campanha no MGE ou ID da Campanha no CRM (a parametrizar)

TIPO: INCREMENTAL (fichas são incluídas ou alteradas), BAIXA (fichas são removidas), BOLETO (é feito um enriquecimento com os dados de fatura do cliente)

EXT: TMP durante a gravação do arquivo, renomear para CSV ou TXT após a gravação do arquivo

Formatação do arquivo

CODIFICAÇÃO: : ANSI ou UTF8

FORMATO : Delimitado por "ponto e vírgula" (;) ou conforme configurado no daemon

CABEÇALHO : Primeira linha com os nomes dos campos separadas por "ponto e vírgula" (;) ou conforme configurado no daemon

CAMPOS OBRIGATÓRIOS: MAILING (nome do mailing no MGE), ID_CRM (ID do cliente no CRM), TELEFONE (no mínimo um telefone)

MÁXIMO DE LINHAS: O arquivo deve conter no máximo 2.000.000 de linhas. Exceto aos domingos onde é possivel processar arquivos com até 8.000.000 de linhas.

Layout do arquivo

Os arquivos de carga de mailing podem ser enviados em dois tipos de layout: VERTICAL ou HORIZONTAL.

VERTICAL : No tipo VERTICAL cada linha do arquivo contém um único telefone.
Exemplo de 2 telefones no layout VERTICAL:
IDCRM;CPFCGC_PES;NOME_DEV;DATA_NASCIMENTO;TIPO_PES;COD_TIT;UF;CEP;FONE_DEV1;DDD1;STATUS_TEL1;DESC_TEL1;TIPO_TEL1
10011001;31299155833;JOSÉ DA SILVA;31/12/1982;F;26248023;SP;09400-000;11945451515;11;1;CELULAR;1
10011001;31299155833;JOSÉ DA SILVA;31/12/1982;F;26248023;SP;09400-000;1155551515;11;2;FIXO;2

HORIZONTAL : No tipo HORIZONTAL cada linha do arquivo pode conter até 20 telefones.
Exemplo de 2 telefones no layout HORIZONTAL:
IDCRM;CPFCGC_PES;NOME_DEV;DATA_NASCIMENTO;TIPO_PES;COD_TIT;UF;CEP;FONE_DEV1;FONE_DEV2;DDD1;DDD2;STATUS_TEL1;STATUS_TEL2;DESC_TEL1;DESC_TEL2;TIPO_TEL1;TIPO_TEL2
10011001;31299155833;JOSÉ DA SILVA;31/12/1982;F;26248023;SP;09400-000;11945451515;1155551515;11;12;1;2;CELULAR;FIXO;1;2

Compartilhamento do arquivo:

Configurações de FTP/SFTP

TIPO: : FTP com autenticação normal ou SFTP com SSL

PERMISSÕES : Criar, Renomear, Mover e Excluir nas pastas acima citadas para as credenciais do FTP/SFTP

Estrutura de pastas

- callflex: Pasta raiz da integração.
- duplicados: Pasta com os arquivos duplicados e não processados pelo MGE.
- importar: Pasta com os arquivos novos gerados pelo CRM prontos para ser processados.
- pendentes: Pasta com os arquivos com erro não processados pelo MGE.
- processados: Pasta com os arquivos que já foram processados.

Exemplo de estrutura de pastas no FTP/SFTP:

Configuração do daemon (Somente Callflex):

Existem 4 daemons que podem ser usados para processar arquivos de campanhas diferentes simultaneamente.
A configuração de cada daemon segue o padrão do MGE e pode ser encontrada no menu Estratégia -> Configurações -> Daemons
A configuração do FTP/SFTP fica na configuração adicional do daemon que é no padrão JSON.

Exemplo de configuração do daemon:

Configuração da campanha (Somente Callflex/Configurável):

É possível selecionar qual dos 4 daemons vai processar a campanha.
A configuração do daemon que vai processar a campanha pode ser encontrada no menu Estratégia -> Gerenciamento do MGE -> Editar Campanha

Exemplo de configuração da campanha:

Logs da integração:

Na tela de consulta de logs da integração é possivel ver por data a ordem em que os eventos ocorreram.
O log pode ser encontrada no menu Estratégia -> Log de Integrações via Arquivo

Exemplo da tela de log filtrado por campanha e data:

Arquivo de log de erro:

Em caso de arquivos com erro alem da tela de log será gerado um arquivo texto com o erro.
Esse arquivo será colocado na pasta "pendentes" junto com o arquivo original.
O nome do arquivo de log de erro será o mesmo, mudando somente a extensão para ".log".

Conteúdo do arquivo INCREMENTAL:

O os arquivos do tipo INCREMENTAL devem conter todas as colunas configuradas no de/para divididas pelo separados configurado.
Exemplo do conteúdo:

Conteúdo do arquivo de BAIXA:

Para os arquivos do tipo BAIXA só é necessária a coluna com o ID do CRM configurada no de/para.
Exemplo do conteúdo: