Importar conteúdo por planilha
Como trazer posts, artigos e posts curtos de uma planilha .xlsx ou .csv com a data e o autor originais (arquivo, colunas, opções, prévia, andamento e relatório), o que faz uma linha ser pulada, cada aviso e os limites.
O botão Importar conteúdo traz para a comunidade o histórico que estava em outro lugar (WordPress, Substack, Circle, um grupo antigo, uma planilha): cada linha da planilha vira um post, um artigo ou um post curto, com a data original e, quando dá, o autor original. Você diz para onde vai cada coluna, confere uma prévia e só então importa. Ninguém é notificado.
Para que serve
| Comunidade | Planilha |
|---|---|
| Migrando de um blog ou newsletter | A exportação dos artigos, com título, texto em HTML, data e e-mail do autor |
| Fórum ou grupo antigo | As discussões, cada uma com o e-mail de quem abriu, indo para um espaço de Feed |
| Associação | O arquivo de comunicados dos últimos anos, todos num espaço de Conteúdo |
| Curso | Os recados da turma como posts curtos, na ordem em que saíram |
Como funciona
Onde fica e quem pode
No cabeçalho dos espaços de Conteúdo e de Feed, clique na seta ao lado de Novo Conteúdo (no Feed, Novo Status) e escolha Importar conteúdo. Só o proprietário e o administrador veem essa opção; para os outros papéis ele não aparece, e a API recusa.
Com a entrada da comunidade suspensa pela Memberfy, a importação não começa. Ver Suspensão de entrada e vendas.
Os três tipos
| Tipo | Como entra | Onde pode entrar |
|---|---|---|
| Post | Título e texto | Espaço de Conteúdo ou de Feed |
| Artigo | Título e texto | Espaço de Conteúdo ou de Feed |
| Post curto | Só texto, até 500 caracteres, sem título e sem tags | Só espaço de Feed |
O tipo vale para todas as linhas (opção Tipo) ou vem de uma coluna da planilha, com valores como post, artigo ou curto (também status, blog, newsletter, em português, inglês, espanhol, italiano ou alemão).
O que a importação respeita
- A data original fica. O post entra com a data da planilha como data de publicação, no lugar dessa data no Feed e na lista do espaço, e não no topo.
- Em silêncio. Nada é notificado: nenhum membro recebe aviso nem e-mail, os posts ficam fora dos e-mails de novidades e dos destaques, e ninguém ganha pontos no Ranking. Só quem importou recebe, no fim, um e-mail com o resumo.
- O autor vem pelo e-mail. A coluna de e-mail do autor liga cada linha a uma pessoa da comunidade. Ela precisa ser membro e ter papel abaixo do seu (o proprietário importa em nome de administradores, moderadores, financeiro e membros; o administrador, em nome de moderadores, financeiro e membros). Fora disso, a linha é pulada e o relatório diz por quê. O seu próprio e-mail sempre vale. Quem importou fica registrado nos Logs em cada post feito em nome de outra pessoa.
- Data no futuro ou inválida não entra. A linha é pulada. Data vazia vira a data da importação, e a linha entra com um aviso.
- Nada entra duas vezes. Um post ou artigo com o mesmo título e a mesma data de um que já está na comunidade é pulado; importar de novo a mesma planilha não duplica. Linhas repetidas dentro da própria planilha também entram uma vez só.
- As imagens vêm junto. As imagens dentro do texto são baixadas e hospedadas na Memberfy, com os mesmos limites de uma imagem enviada pelo app; os links do texto continuam como estão. A imagem que não pode ser baixada fica como link para o original, e o relatório avisa.
- Os links viram player ou cartão. Os links do texto de cada post importado viram player ou cartão, até 5 por post, em segundo plano, depois que o post entra.
Limites
| O quê | Limite |
|---|---|
| Arquivo | .xlsx ou .csv, até 5 MB |
| Linhas | Até 5.000 linhas de dados (e 100 colunas) |
| Imagens por linha | 20; as seguintes ficam como link |
| Imagens por importação | 300 ou 500 MB, o que vier primeiro; as seguintes ficam como link |
| Importações ao mesmo tempo | Uma por comunidade; a próxima começa quando a anterior terminar |
Uma planilha cujos textos somados passam de 25 MB é recusada antes de começar: divida em partes menores.
Passo a passo
1. Arquivo
- No espaço de Conteúdo ou de Feed, clique em Importar conteúdo.
- Arraste a planilha ou clique para escolher (.xlsx ou .csv · até 5 MB e 5.000 linhas).
- Confira a leitura:
- Aba: no .xlsx, qual aba ler.
- Linha de cabeçalho: a Memberfy acha sozinha; para trocar, clique em outra linha da tabela.
- Separador (vírgula, ponto e vírgula, tabulação ou barra vertical) e Codificação: no .csv, descobertos sozinhos; dá para trocar.
2. Colunas
Cada coluna aparece com as 3 primeiras linhas e um destino sugerido em Vai para. Ajuste o que precisar; o que ficar em Ignorar não é importado. Cada destino aceita uma coluna só.
| Destino | O que vai nele |
|---|---|
| Título | Obrigatório em post e artigo. Títulos com mais de 300 caracteres são cortados |
| Conteúdo | Texto, Markdown ou HTML. Obrigatório para continuar |
| E-mail do autor | O post fica no nome da pessoa da comunidade com esse e-mail. Sem essa coluna, tudo sai em seu nome |
| Data de publicação | A data original. Data sem fuso usa o fuso da comunidade |
| Space | O id, o endereço ou o nome de um espaço de Conteúdo ou de Feed (maiúsculas e acentos não importam) |
| Tipo | post, artigo ou curto |
| Tags | Várias, separadas por vírgula, ponto e vírgula ou barra vertical (até 20 por post) |
3. Opções
- Space (ou Space padrão, quando há coluna de space): onde os posts entram, ou o espaço usado quando a linha não traz um válido. Nenhum (pular a linha) pula as linhas sem space válido.
- Tipo (ou Tipo padrão): Post, Artigo ou Post curto. Post curto só entra em espaço de Feed.
- Quem vê: Só membros ou Público.
- Ordem das datas, que aparece quando a planilha tem datas como 03/04/2024: Dia/mês/ano ou Mês/dia/ano. A tela mostra um exemplo da planilha ("03/04/2024 será lida como 3 de abril de 2024.") e, quando a planilha tem uma data que só cabe numa ordem (como 25/12/2023), escolhe essa e avisa.
- Fuso: datas sem fuso são lidas no fuso da comunidade, que a tela mostra.
- Autor com e-mail desconhecido, para quando o e-mail da planilha não é de ninguém da comunidade: Pular a linha ou Publicar em meu nome (a linha entra com um aviso).
As datas aceitas: AAAA-MM-DD (com ou sem hora e fuso), DD/MM/AAAA ou MM/DD/AAAA (com /, . ou - e hora opcional), datas com o nome do mês em inglês (15 March 2024, Mar 15, 2024) e números de data Unix. No .xlsx, a célula de data do Excel vale como está.
4. Prévia
A prévia não grava nada. Ela mostra o resumo (linhas na planilha, quantos serão importados, quantos com data original, quantos sem data, linhas puladas, linhas com avisos, imagens a baixar e o tamanho dos textos) e as primeiras 10 linhas como vão ficar: tipo, título, espaço, autor, data e avisos, com as puladas marcadas.
5. Confirmar
Clique em Importar N posts e confirme. A importação roda em segundo plano: pode fechar a janela.
6. Andamento
A tela mostra "120 de 800 linhas". Cancelar importação para as linhas que faltam; os posts que já entraram continuam publicados.
7. Relatório e histórico
No fim, a tela mostra Importados, Pulados, Com falha e Com avisos, as Linhas que não entraram (com o motivo) e as que Entraram com avisos. Baixar relatório gera um CSV com a linha, o resultado, o título e o motivo. Quem importou também recebe o resumo por e-mail.
Importações anteriores, no alto da janela, lista as importações da comunidade, com o estado (Não iniciada, Na fila, Importando, Concluída, Falhou, Cancelada ou Abandonada) e Ver para abrir o relatório. Uma planilha analisada que não é importada em 24 horas fica como Abandonada.
Por que uma linha foi pulada
| No relatório | O que quer dizer | O que fazer |
|---|---|---|
| Sem título | Post ou artigo sem título | Preencha o título ou importe a linha como post curto |
| Sem conteúdo | Post curto sem texto | Preencha o conteúdo |
| Sem space válido | A linha não traz um espaço que aceite esse tipo, e não há espaço padrão que sirva | Escolha um espaço padrão, ou corrija a coluna de space |
| Data inválida | A data não foi entendida, ou não existe (como 31/02) | Corrija a data ou troque a Ordem das datas |
| Data no futuro | A data é depois de agora: a importação não agenda posts | Corrija a data |
| Conteúdo longo demais | Post curto com mais de 500 caracteres | Importe como post ou artigo |
| Repetida na planilha | Mesmo tipo, título, data e começo do texto de uma linha anterior | Nada: a primeira entrou |
| Já existe um post com esse título e data | Um post ou artigo igual já está na comunidade, de uma importação anterior ou feito à mão | Nada: é o que evita duplicar |
| E-mail do autor não é de ninguém da comunidade | O e-mail não é de um membro, e a opção é Pular a linha | Convide a pessoa antes, ou escolha Publicar em meu nome |
| Só dá para publicar em nome de quem tem papel abaixo do seu | O e-mail é de alguém com papel igual ou acima do seu | Peça a um proprietário para importar, ou tire o e-mail da linha |
| Erro ao gravar (resultado Falhou) | Algo deu errado ao gravar aquela linha | Importe a planilha de novo: o que já entrou é pulado |
O que cada aviso quer dizer
A linha com aviso entrou; o aviso diz o que mudou.
| Aviso | O que quer dizer |
|---|---|
| Tipo não reconhecido | O valor da coluna Tipo não é post, artigo nem curto; valeu o tipo das opções |
| Título cortado | O título passava de 300 caracteres e foi cortado |
| Space não encontrado | O espaço da linha não existe na comunidade; valeu o espaço padrão |
| Space de outro tipo | O espaço da linha não aceita esse tipo (por exemplo, post curto num espaço de Conteúdo); valeu o espaço padrão |
| Sem data | A célula de data estava vazia; o post entrou com a data da importação |
| Autor não encontrado | O e-mail não é de ninguém da comunidade; o post saiu em seu nome (opção Publicar em meu nome) |
| Tags ignoradas | Post curto não tem tags |
| Imagem não baixada | Uma imagem do texto não pôde ser baixada; ficou o link para o original |
| Imagem não suportada | O endereço da imagem não é um link da web que dê para baixar; ficou como link |
| Imagens demais no post | O texto tinha mais de 20 imagens; as seguintes ficaram como link |
| Limite de imagens da importação | A importação chegou a 300 imagens ou 500 MB; as seguintes ficaram como link |
Perguntas frequentes
Os membros vão receber uma enxurrada de avisos? Não. Nada da importação notifica membros nem conta pontos, qualquer que seja a data.
Posso importar comentários e curtidas? Não. A importação traz posts, artigos e posts curtos. Para trazer pessoas, use Importar membros por planilha.
Importei e faltou gente como autor. Posso importar de novo? Sim. Convide as pessoas, importe a mesma planilha e as linhas que já entraram são puladas como Já existe um post com esse título e data. Os posts curtos não passam por essa conferência: numa segunda importação, deixe só as linhas que faltaram.
E se eu errar a data de um post? Edite o post e mude a Data de publicação. Ver Data de publicação.
Pelo assistente
O assistente faz a mesma importação em quatro passos: analyze_content_import (lê a planilha), preview_content_import (o resumo, sem gravar), start_content_import (importa depois de mostrar o resumo) e get_content_import (andamento e relatório). Ver Ferramentas · Conteúdo.
Na API
POST /api/import/spreadsheet (sobe o arquivo e devolve a análise), POST /api/import/spreadsheet/{id}/preview (o resumo e as 10 primeiras linhas), POST /api/import/spreadsheet/{id}/start (confirma e põe na fila), GET /api/import/spreadsheet/{id} (andamento e relatório), GET /api/import/spreadsheet (histórico) e DELETE /api/import/{importId} (cancela). Só proprietário e administrador, com o X-CommunityId. Ver Import.