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

# Agendamento de Relatório via FTP

> Agende relatórios no Invenio Center para envio automático por FTP, SFTP, S3 ou e-mail. Configure servidor, filtros e periodicidade para exportação recorrente em CSV.

O **Agendamento de Relatórios via FTP** automatiza a geração e exportação de relatórios para servidores FTP, SFTP, Amazon S3 ou por e-mail — eliminando processos manuais recorrentes.

<Warning>
  O Invenio permite até **8 agendamentos** simultâneos por conta. Os arquivos são gerados no formato **CSV**.
</Warning>

***

## Criar um Novo Agendamento

**Caminho:** Invenio Center > Analisar > Relatórios > Agendamentos

<Tip>
  **Acesso direto:** [Página de Relatórios e Agendamentos](https://inveniocenter.robbu.global/painel/relatorios)
</Tip>

<Steps>
  <Step title="Acessar a aba de Agendamentos">
    Acesse: **Invenio Center > Analisar > Relatórios > Agendamentos**

    Clique em **"Gerar Relatório"**.

    <Frame caption="Tela de agendamentos com botão Gerar Relatório">
      <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/ftp/relatorioftp2.png" />
    </Frame>
  </Step>

  <Step title="Escolher o modelo de relatório">
    Selecione o **tipo de relatório** que deseja agendar na lista de modelos disponíveis.

    <Frame caption="Seleção do modelo de relatório">
      <img src="https://robbublob.blob.core.windows.net/docs/ftp_2.png" />
    </Frame>
  </Step>

  <Step title="Definir filtros e parâmetros">
    Configure os parâmetros do relatório:

    | Filtro            | Observação                                          |
    | ----------------- | --------------------------------------------------- |
    | **Período**       | Intervalo de datas para o relatório                 |
    | **Carteira**      | Segmento a ser analisado                            |
    | **KPI – Eventos** | Disponível apenas em relatórios do tipo KPI Eventos |
    | **Usuários**      | Operadores incluídos na análise                     |

    <Frame caption="Definição de filtros do relatório">
      <img src="https://robbublob.blob.core.windows.net/docs/ftp_3.png" />
    </Frame>

    <Frame caption="Configuração de período e carteira">
      <img src="https://robbublob.blob.core.windows.net/docs/ftp_4.png" />
    </Frame>
  </Step>

  <Step title="Configurar método de entrega">
    Selecione o método de entrega: **FTP**, **SFTP**, **S3** ou **E-mail** (podem ser combinados).

    <Frame caption="Seleção entre FTP e E-mail como método de entrega">
      <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/ftp/emailouFTP.png" />
    </Frame>

    <Frame caption="Configuração de e-mail para envio do relatório">
      <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/ftp/relagpreenchimentoemail.png" />
    </Frame>

    <Note>
      **Datas do agendamento:**

      * **Data de início** — a partir de quando o relatório será gerado (recomendado preencher)
      * **Data de término** — se houver prazo final; deixe em branco para recorrência indefinida
      * Para pausar sem excluir: desative o toggle **"Agendamento ativo"**
    </Note>
  </Step>

  <Step title="Configurar o servidor de destino">
    Preencha os campos do servidor conforme o protocolo escolhido (veja detalhes na próxima seção).

    <Frame caption="Preenchimento das configurações do servidor FTP">
      <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/ftp/preechimentoftprelatorios.png" />
    </Frame>
  </Step>

  <Step title="Finalizar o agendamento">
    Clique em **"Agendar Relatório"** para concluir.

    <Check>
      O relatório será enviado ao diretório **`relatórios`** do servidor configurado no horário programado.

      Em caso de falha, o arquivo é movido para o diretório **`descartados`**.
    </Check>

    <Frame caption="Diretório 'descartados' para relatórios com falha na geração">
      <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/ftp/descartados.png" />
    </Frame>
  </Step>
</Steps>

***

## Configuração do Servidor de Destino

<Tabs>
  <Tab title="FTP / SFTP" icon="server">
    ### Campos para FTP e SFTP

    Ative a opção **"Enviar relatório por FTP"** e preencha:

    | Campo          | Descrição                                                                                     |
    | -------------- | --------------------------------------------------------------------------------------------- |
    | **Server**     | Host, IP ou endereço do servidor — **sem** `https://` — inclua o diretório raiz se necessário |
    | **User**       | Usuário com permissão de acesso à pasta FTP                                                   |
    | **Password**   | Senha de acesso                                                                               |
    | **Port**       | FTP → `21` · SFTP → `22`                                                                      |
    | **Encryption** | Criptografia do FTP (recomendado: **TLS/Explícito**)                                          |
    | **Protocol**   | Selecione **FTP** ou **SFTP**                                                                 |

    <Warning>
      **Regras de preenchimento do servidor:**

      * ❌ Não inclua `https://` — 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`
      * ✅ Se o protocolo for **SFTP**, verifique se o protocolo correto está selecionado
    </Warning>

    <Tip>
      **Organizar arquivos:** Recomendamos criar um **diretório exclusivo** para relatórios no servidor.

      <Frame caption="Estrutura de diretórios recomendada no servidor FTP">
        <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/ftp/winCsp1.png" />
      </Frame>

      No campo **Server**, inclua o nome do servidor + **diretório raiz**:

      * Exemplo: `ftp.empresa.com/relatorios`
    </Tip>
  </Tab>

  <Tab title="Amazon S3" icon="aws">
    ### Campos para protocolo S3

    | Campo        | Valor                                                |
    | ------------ | ---------------------------------------------------- |
    | **Server**   | Formato: `s3.{REGIÃO}.amazonaws.com/{PASTA_DESTINO}` |
    | **User**     | **Access Key** da conta AWS                          |
    | **Password** | **Secret Key** correspondente                        |
    | **Port**     | `443`                                                |
    | **Protocol** | **S3**                                               |

    <Frame caption="Configuração do protocolo S3 no agendamento">
      <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/ftp/s3.png" />
    </Frame>
  </Tab>

  <Tab title="☁️ SFTP Invenio (sem servidor próprio)" icon="cloud">
    ### Usar SFTP da Invenio

    Se sua empresa não possui servidor FTP/SFTP, utilize o **SFTP fornecido pela Invenio**.

    **Caminho:** Invenio Center > Configurações > Conta > Gerenciar > **FTP** > Habilitar transferência de arquivos

    <Tip>
      **Acesso direto:** [Configurações da conta](https://inveniocenter.robbu.global/painel/configuracoes/conta)
    </Tip>

    <Frame caption="Habilitando SFTP da Invenio nas configurações da conta">
      <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/ftp/ftpconfig.png" />
    </Frame>

    <Frame caption="Toggle para habilitar transferência de arquivos">
      <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/ftp/habilitando FTP.png" />
    </Frame>

    | Campo        | Valor                                                                     |
    | ------------ | ------------------------------------------------------------------------- |
    | **URL**      | `sftp://sarobbuinveniosftp.xyz.core.windows.net` (fornecido pela Invenio) |
    | **Port**     | `22`                                                                      |
    | **Protocol** | **SFTP**                                                                  |
  </Tab>
</Tabs>

***

## Links Relacionados

<CardGroup cols={2}>
  <Card title="Relatórios" icon="chart-line" href="https://docs.robbu.global/docs/center/relatorios">
    Visão geral, geração e agendamentos
  </Card>

  <Card title="Carga FTP" icon="upload" href="https://docs.robbu.global/docs/center/carga-ftp">
    Importação de mailings via FTP
  </Card>

  <Card title="Tipos de KPI" icon="chart-bar" href="https://docs.robbu.global/docs/center/tipos-de-kpi">
    KPIs disponíveis para relatórios
  </Card>
</CardGroup>

***

## ⁉️ Perguntas Frequentes (FAQ)

<AccordionGroup>
  <Accordion title="📍 Como acessar o agendamento de relatórios?">
    **Caminho:** Invenio Center > Analisar > Relatórios > Agendamentos > Gerar Relatório

    **Acesso direto:** [Relatórios](https://inveniocenter.robbu.global/painel/relatorios)
  </Accordion>

  <Accordion title="📧 Posso receber o relatório por e-mail além do FTP?">
    **Sim!** Ao configurar a entrega, habilite a opção **E-mail** junto ao FTP — o arquivo será enviado para a caixa de e-mail configurada **e** ao servidor FTP simultaneamente.
  </Accordion>

  <Accordion title="🔌 Qual protocolo e porta usar?">
    | Protocolo | Porta | Uso                    |
    | --------- | ----- | ---------------------- |
    | **FTP**   | `21`  | Servidores FTP padrão  |
    | **SFTP**  | `22`  | Conexão segura via SSH |
    | **S3**    | `443` | Buckets Amazon AWS     |

    O Invenio também oferece servidor **SFTP próprio** para contas sem servidor externo.
  </Accordion>

  <Accordion title="🌐 Como preencher o campo Server corretamente?">
    | Correto                         | Incorreto                    |
    | ------------------------------- | ---------------------------- |
    | `ftp.seudominio.com/relatorios` | `https://ftp.seudominio.com` |
    | IP público                      | `192.168.x.x` (IP privado)   |

    Inclua o diretório raiz de destino diretamente no campo Server para organizar os arquivos.
  </Accordion>

  <Accordion title="☁️ Minha empresa não tem FTP. Como usar o SFTP da Invenio?">
    **Caminho:** Invenio Center > Configurações > Conta > Gerenciar > FTP > Habilitar transferência de arquivos

    Use o endpoint fornecido com prefixo `sftp://` e porta `22`.
  </Accordion>

  <Accordion title="🔺 Como configurar envio para Amazon S3?">
    Selecione protocolo **S3** e preencha:

    * **Server:** `s3.{REGIÃO}.amazonaws.com/{PASTA_DESTINO}`
    * **User:** Access Key da conta AWS
    * **Password:** Secret Key correspondente
    * **Port:** `443`
  </Accordion>

  <Accordion title="📁 Onde os arquivos ficam salvos? O que acontece em caso de falha?">
    * ✅ **Sucesso:** Arquivo salvo no diretório **`relatórios`** do servidor
    * ❌ **Falha:** Arquivo movido para o diretório **`descartados`**

    Verifique o diretório no servidor e o histórico de agendamentos no Invenio Center em caso de falha.
  </Accordion>

  <Accordion title="🔢 Há limite de agendamentos simultâneos?">
    **Sim.** O Invenio permite até **8 agendamentos** simultâneos por conta. O formato de exportação é sempre **CSV**.
  </Accordion>

  <Accordion title="⏸️ Como pausar um agendamento sem excluí-lo?">
    **Caminho:** Invenio Center > Analisar > Relatórios > Agendamentos > Editar agendamento > Desativar **"Agendamento ativo"**

    O agendamento permanece salvo e pode ser reativado a qualquer momento.
  </Accordion>
</AccordionGroup>