Migrar para o Agon
Depois de ler esta página, saberá mover a sua lista de clientes existente para o Agon a partir de uma folha de cálculo ou ficheiro de exportação, verificar como cada coluna foi associada, executar a importação e convidar os clientes importados a configurarem as suas contas.
As ferramentas estão na aplicação de secretária, em Configurações → Migração. Este separador só é visível para os Managers. Não existe um assistente de integração separado: tudo acontece nesse único separador.
Como funciona a migração
O Agon não se liga à sua plataforma antiga e não lhe pede as credenciais de início de sessão. É você que exporta os seus próprios dados a partir da sua plataforma atual e carrega o ficheiro para o Agon. Assim, as suas credenciais mantêm-se seguras e tudo permanece dentro do que a maioria das plataformas permite.
Na aplicação, a migração tem três passos:
- Descarregar um modelo (opcional) — um ficheiro já pronto com os nomes de coluna corretos.
- Carregar um ficheiro — o Agon lê-o e associa as suas colunas aos seus próprios campos.
- Rever a associação de colunas e importar — verifique as associações, corrija as que estiverem erradas e confirme.
Depois de a importação terminar, pode enviar e-mails de convite a todas as pessoas importadas.
O que pode importar neste momento
Apenas importação de clientes. O separador Migração indica: «Por agora, só está disponível a importação de clientes. A importação de subscrições e aulas chegará mais tarde.»
Ainda assim, hoje pode descarregar os modelos de subscrições e aulas para preparar esses ficheiros com antecedência, mas a aplicação ainda não os consegue importar.
Como no Agon tudo depende de os clientes existirem primeiro, importar a sua lista de clientes é, de qualquer forma, o primeiro passo certo. Quando a importação de subscrições e aulas ficar disponível, faça essas a seguir.
Ficheiros suportados
O passo de carregamento aceita:
- CSV (
.csv) - Excel (
.xlsx) - JSON
O tamanho máximo do ficheiro é 10 MB. Se a sua exportação for maior, divida-a em vários ficheiros e importe-os um de cada vez.
Passo 1 — Descarregar um modelo (opcional)
Se preferir construir o seu ficheiro à mão, ou se a exportação da sua plataforma usar nomes de coluna muito diferentes, comece a partir de um modelo do Agon.
- Abra Configurações → Migração.
- Na secção Baixar modelos, clique numa destas opções:
- Baixar modelo de clientes
- Baixar modelo de subscrições
- Baixar modelo de aulas
- Abra o CSV descarregado no Excel ou no Google Sheets, preencha as suas linhas e guarde-o como CSV.
Não é obrigatório usar um modelo. Qualquer ficheiro CSV, Excel ou JSON serve — o passo de associação no Passo 3 permite-lhe alinhar as suas colunas com os campos do Agon.
Colunas do modelo de clientes
| Coluna | Obrigatória? | Notas |
|---|---|---|
full_name | Recomendada | Se uma linha não tiver nome, o e-mail do cliente é usado como nome. |
email | Obrigatória | Uma linha sem e-mail é ignorada. |
phone | Opcional | |
date_of_birth | Opcional | Use YYYY-MM-DD (por exemplo 1990-01-15). |
Para referência, os outros modelos contêm estas colunas (importação ainda não disponível):
- Subscrições:
client_email,membership_type_name,starts_at,expires_at,credits_remaining - Aulas:
class_name,starts_at,ends_at,capacity,instructor_name
Passo 2 — Exportar os seus dados da sua plataforma atual
A maioria das plataformas tem uma exportação de autoatendimento.
- Procure uma opção de exportação ou descarregamento na área de Configurações, Administração ou Dados da sua plataforma atual.
- Os dados dos clientes costumam estar em Clientes, Membros ou Contactos.
- Se não houver uma exportação de autoatendimento, contacte a equipa de suporte da plataforma e solicite uma exportação de portabilidade de dados ao abrigo do artigo 20.º do RGPD. Nos termos do artigo 20.º do RGPD, qualquer plataforma que detenha dados pessoais dos seus clientes tem de os fornecer, mediante pedido, num formato estruturado e legível por máquina.
Consulte o guia do RGPD para saber como redigir esse pedido e o que fazer se a plataforma não cooperar.
Passo 3 — Carregar o ficheiro e rever a associação de colunas
- Abra Configurações → Migração.
- Em Enviar um ficheiro, escolha o seu ficheiro CSV, Excel ou JSON (até 10 MB).
- Clique em Analisar ficheiro.
- O Agon mostra a tabela Rever a associação de colunas. Já associou por si cada coluna do seu ficheiro a um campo do Agon («Associámos cada coluna do seu ficheiro a um campo do Agon»).
- Verifique cada linha:
- Coluna no seu ficheiro — o cabeçalho retirado do seu ficheiro.
- Campo do Agon — uma lista pendente. As opções são Nome completo, E-mail, Telefone, Data de nascimento e — não importar —.
- Uma coluna que o Agon não conseguiu associar mostra um selo não associada. É ignorada, a menos que escolha um campo para ela.
- Corrija qualquer associação errada escolhendo o campo correto na lista pendente. Defina uma coluna como — não importar — para a ignorar de propósito.
- Quando a tabela estiver correta, clique em Confirmar importação.
Não há um indicador de confiança com cores nem uma pré-visualização linha a linha — o Agon executa a importação assim que confirmar.
Para mais detalhes sobre como a associação funciona e como a corrigir, consulte Mapeamento de colunas.
Passo 4 — Importação concluída
Quando a importação termina, o separador mostra:
- N importados — clientes adicionados ao Agon.
- N ignorados — linhas que não foram importadas.
- Uma lista Linhas ignoradas com um motivo para cada linha ignorada.
Os dois motivos que verá na importação de clientes são:
- Row missing email — a linha não tinha qualquer valor na coluna associada a E-mail, por isso não pôde ser importada.
- Duplicate email skipped — já existe no Agon um cliente com esse endereço de e-mail. O cliente existente não é alterado.
Para trazer uma linha ignorada, corrija-a no seu ficheiro de origem (adicione o e-mail em falta ou remova o duplicado) e execute a importação novamente com o ficheiro corrigido.
Passo 5 — Convidar os clientes importados
As palavras-passe dos clientes nunca saem da sua plataforma antiga — são guardadas como hashes irreversíveis — por isso os clientes importados precisam de um convite para definirem a sua própria palavra-passe do Agon.
Depois da importação, estão disponíveis duas ações:
- Enviar convites por e-mail — envia a cada cliente importado neste processo uma ligação de inscrição pessoal.
- Baixar lista de convites (CSV) — um ficheiro com o endereço de e-mail e a ligação de convite pessoal de cada cliente, para que possa enviar os convites com a sua própria ferramenta de e-mail.
As ligações de convite expiram 7 dias após serem criadas. Se uma ligação expirar antes de o cliente a usar, execute a importação novamente para esse cliente (ou use uma nova lista de convites) para gerar uma nova.
Não existe um ecrã de histórico de convites nem um botão de reenvio por cliente.
Retomar uma migração
O separador Migração lembra-se de onde ficou:
- Se analisou um ficheiro mas não o importou, volte a carregar o mesmo ficheiro para regressar à tabela Rever a associação de colunas e concluir.
- Se uma importação já foi concluída, o separador abre no passo Importação concluída para que possa enviar os convites.
O que fazer se algo correr mal?
A minha plataforma antiga não me dá uma exportação de dados Nos termos do artigo 20.º do RGPD (direito à portabilidade dos dados), qualquer plataforma que detenha dados pessoais sobre os seus clientes tem de fornecer esses dados, mediante pedido, num formato estruturado e legível por máquina. Envie um pedido escrito à respetiva equipa de suporte. Se recusarem ou não responderem no prazo de 30 dias, pode reclamar junto da sua autoridade nacional de proteção de dados. Consulte o guia do RGPD.
As associações de colunas estão erradas
Corrija-as na tabela Rever a associação de colunas usando a lista pendente na coluna Campo do Agon. Também pode renomear os cabeçalhos do seu ficheiro para full_name, email, phone e date_of_birth e voltar a carregá-lo. Consulte Mapeamento de colunas.
Algumas linhas foram ignoradas Abra a lista Linhas ignoradas e leia o motivo. «Row missing email» significa que a linha não tinha e-mail; «Duplicate email skipped» significa que esse cliente já existe no Agon. Corrija o ficheiro de origem e importe-o novamente.
Um cliente não recebeu o convite, ou a ligação dele expirou Peça ao cliente para verificar a pasta de spam. As ligações de convite duram 7 dias; para emitir uma nova, execute a importação novamente para esse cliente ou envie uma nova lista de convites. Não há botão de reenvio.
Não consigo ver o separador Migração Só é mostrado aos Managers. Peça a um Manager do seu estúdio para executar a migração ou para alterar a sua função.
Preciso de importar subscrições ou aulas Por agora, só está disponível a importação de clientes. Importe os seus clientes hoje; as subscrições e as aulas poderão ser importadas numa versão posterior.