CSV recebido por e-mail para tabela do Excel, sem loop

Em vez de percorrer o arquivo linha por linha, o fluxo entrega o texto inteiro do CSV a um Office Script, que grava tudo na tabela de uma vez. Menos ações, menos risco de 429 e muito mais rápido.

Por Fábio Hage (Hage83) · atualizado em 02/11/2026

O problema

Toda manhã chega um e-mail com um CSV (vendas do dia, estoque, extrato) e alguém copia as linhas para uma planilha. A solução ingênua automatiza isso com um Aplicar a cada: para cada linha do CSV, uma ação Adicionar linha a uma tabela. Funciona com 20 linhas e vira um pesadelo com 5.000: cada linha é uma ação, o fluxo demora, consome o limite de ações e, no pior caso, atinge o erro 429.

A alternativa é entregar o CSV inteiro a um Office Script, um pequeno código que roda dentro do Excel na web e grava todas as linhas em lote. Para o fluxo, é uma única ação.

O que você precisa

• Uma licença Microsoft 365 empresarial com Office Scripts habilitado. Segundo a Microsoft, para usar Office Scripts no Power Automate é preciso uma licença empresarial do Microsoft 365.
• Uma pasta de trabalho do Excel salva no OneDrive for Business ou no SharePoint (não vale arquivo só no seu computador).
• Nessa pasta de trabalho, uma tabela (Inserir > Tabela) chamada TabelaDados, com os cabeçalhos na mesma ordem das colunas do CSV.

Passo 1: crie o script

No Excel na web, abra Automatizar > Novo script > Criar no editor de código, apague o conteúdo e cole o código abaixo. Salve com o nome Gravar CSV na tabela.

function main(
  workbook: ExcelScript.Workbook,
  csv: string,
  tableName: string = "TabelaDados"
): string {
  const table = workbook.getTable(tableName);
  if (!table) {
    throw new Error("Tabela não encontrada: " + tableName);
  }
  const rows = parseCsv(csv);
  if (rows.length < 2) {
    return "O CSV não tem linhas de dados.";
  }
  const columns = table.getColumns().length;
  const data = rows.slice(1).map((r) => normalize(r, columns));
  // Grava em blocos de 500 linhas para ficar longe dos limites de tamanho
  for (let i = 0; i < data.length; i += 500) {
    table.addRows(-1, data.slice(i, i + 500));
  }
  return data.length + " linhas adicionadas.";
}

// ---- leitura do CSV (testada fora do Excel) ----
function normalize(row: string[], size: number): string[] {
  const out = row.slice(0, size);
  while (out.length < size) {
    out.push("");
  }
  return out;
}

function parseCsv(text: string): string[][] {
  const clean = text.replace(/^/, "");
  const firstLine = clean.split(/\r?\n/)[0] || "";
  const counts: { [key: string]: number } = { ",": 0, ";": 0, "\t": 0 };
  let inQuotes = false;
  for (const ch of firstLine) {
    if (ch === '"') {
      inQuotes = !inQuotes;
    } else if (!inQuotes && ch in counts) {
      counts[ch]++;
    }
  }
  let delimiter = ",";
  let best = 0;
  for (const d of [",", ";", "\t"]) {
    if (counts[d] > best) {
      best = counts[d];
      delimiter = d;
    }
  }

  const rows: string[][] = [];
  let row: string[] = [];
  let value = "";
  let quoted = false;
  let fieldStart = true;
  for (let i = 0; i < clean.length; i++) {
    const c = clean[i];
    if (quoted) {
      if (c === '"') {
        if (clean[i + 1] === '"') {
          value += '"';
          i++;
        } else {
          quoted = false;
        }
      } else {
        value += c;
      }
    } else if (c === '"' && fieldStart) {
      quoted = true;
      fieldStart = false;
    } else if (c === delimiter) {
      row.push(value);
      value = "";
      fieldStart = true;
    } else if (c === "\n" || c === "\r") {
      if (c === "\r" && clean[i + 1] === "\n") {
        i++;
      }
      row.push(value);
      rows.push(row);
      row = [];
      value = "";
      fieldStart = true;
    } else {
      value += c;
      fieldStart = false;
    }
  }
  row.push(value);
  rows.push(row);
  return rows.filter((r) => r.some((cell) => cell !== ""));
}

O que o script faz: lê o CSV (detecta sozinho se o separador é vírgula, ponto e vírgula ou Tab), ajusta cada linha ao número de colunas da tabela (completa com vazio ou descarta o excesso) e grava em blocos de 500 linhas.

Passo 2: monte o fluxo

1. Gatilho: Office 365 Outlook, Quando um novo e-mail chegar (V3). Em Opções avançadas, deixe Somente com anexo = Sim e Incluir anexos = Sim. Filtre por remetente ou assunto, para o fluxo não disparar com qualquer e-mail.
2. Filtrar matriz (para ignorar imagens de assinatura e outros anexos): em De, use triggerOutputs()?['body/attachments'] e, na condição avançada, endsWith(item()?['name'], '.csv'). Renomeie a ação para Filtrar_anexos.
3. Executar script (Excel Online (Business)): escolha o arquivo pelo seletor, o script Gravar CSV na tabela e preencha os parâmetros. Em csv, use a expressão:

   base64ToString(first(body('Filtrar_anexos'))?['contentBytes'])

   Em tableName, escreva TabelaDados.
4. Opcional: um e-mail ou uma mensagem no Teams confirmando, com o texto que o script devolve (quantas linhas foram adicionadas).

Limites que você precisa conhecer

Para CSV muito grande, divida o arquivo ou chame o script mais de uma vez com partes menores. O script já grava em blocos para não estourar o limite de tamanho em uma única gravação.

Armadilhas

• Excel interpretando valores: textos que parecem número ou data (como 007 ou 01/02) podem ser convertidos ao serem gravados. Se precisar preservar zeros à esquerda, formate a coluna como Texto antes.
• Tabela não encontrada: o nome do segundo parâmetro precisa ser exatamente o da tabela (Design da tabela > Nome da tabela).
• Parâmetros novos não aparecem na ação: se você mudou o script depois de adicionar a ação, o Power Automate guarda a assinatura antiga. Remova a ação e adicione de novo.
• Vários CSV no mesmo e-mail: este fluxo pega o primeiro. Para vários, será preciso repetir a ação para cada anexo.
• Dados duplicados: se o mesmo e-mail disparar o fluxo duas vezes, as linhas entram duas vezes. Se isso for um risco, grave uma coluna com o identificador do arquivo e confira antes.

Como testar antes de confiar

1. Envie para você mesmo um CSV pequeno (3 linhas), com acentos e uma célula com vírgula entre aspas.
2. Abra a execução no histórico e confira a saída da ação Executar script: deve dizer "3 linhas adicionadas".
3. Abra a tabela no Excel e confira acentos, colunas e valores.
4. Só então teste com um arquivo real, e depois com um grande.

Ferramentas para usar com este guia

Fontes oficiais

• Run Office Scripts with Power Automate (Microsoft Learn)
• Platform limits and requirements with Office Scripts (Microsoft Learn)
• Sample: Convert CSV files to Excel workbooks (Microsoft Learn)
• Sample: Write a large dataset (Microsoft Learn)
• Troubleshoot Office Scripts running in Power Automate (Microsoft Learn)