Como importar contatos, empresas e oportunidades do Zoho CRM?
Você cria um Self Client no console de API do Zoho, cola na Clickmax o Client ID, o Client Secret e um código gerado lá, escolhe o que trazer e a Clickmax copia os dados. A Clickmax só lê o Zoho CRM: nada muda lá. A importação não dispara automações, disparos nem webhooks, e você pode repetir depois sem duplicar registros.
Antes de começar
- Para importar: papel de workspace Proprietário ou Administrador, ou Membro com cargo que tenha a permissão Importar de outro CRM. Para conectar a conta, o cargo também precisa de acesso a Integrações. Veja papéis e permissões.
- No Zoho CRM: gere o código com um usuário administrador. As notas só vêm quando quem conecta é administrador, e os outros dados vêm com o que esse usuário pode ver.
- Saiba o data center da sua conta Zoho: é o final do endereço do Zoho no navegador (zoho.com, zoho.eu, zoho.in e assim por diante).
- Cada workspace conecta uma organização do Zoho CRM.
- Só pode haver uma importação em andamento por workspace.
Criar o Self Client e gerar o código
Deixe a tela do Zoho CRM aberta na Clickmax (Integrações > Explorar integrações > card Zoho CRM · importar dados) e faça isto no Zoho, em outra aba. O código vale uma vez só e expira em poucos minutos, então cole e conecte logo depois de gerar.
- Abra api-console.zoho.com e entre com o usuário do Zoho CRM.
- Escolha Self Client, clique em CREATE NOW e confirme.
- Na aba Client Secret, copie o Client ID e o Client Secret.
- Na aba Generate Code, cole no campo Scope a lista que aparece em Escopos na tela da Clickmax (use Copiar):
ZohoCRM.modules.READ,ZohoCRM.settings.READ,ZohoCRM.users.READ,ZohoCRM.org.READ - Em Time Duration, escolha a maior duração (por exemplo, 10 minutes). Escreva qualquer descrição e clique em CREATE.
- Escolha Zoho CRM e a organização que você quer importar e clique em CREATE.
- Copie o código que aparece.
Conectar na Clickmax
- Em Conectar sua conta, escolha o Data center da conta. O padrão é Estados Unidos (zoho.com).
- Cole o Client ID, o Client Secret e, em Código gerado, o código do passo anterior.
- Clique em Conectar conta.
A Clickmax troca o código na hora e não guarda o código. Conectada, a tela mostra o selo Conectado, o nome da organização e o e-mail de quem conectou. Se quem conectou não é administrador, a tela avisa que as notas ficam de fora da importação.
Para trocar a conexão, gere um novo código no mesmo Self Client, cole os três valores e clique em Atualizar conexão. Desconectar remove a conexão; o que já foi importado continua na Clickmax. A conexão continua funcionando até você apagar o Self Client no console de API do Zoho ou revogar o acesso dele.
Escolher o que trazer
Clique em Importar dados do Zoho CRM. Também dá para chegar aqui pela lista de contatos: na seta ao lado de Adicionar contato, escolha Importar contatos e, abaixo da área do arquivo, clique em Zoho CRM (no celular, toque antes em +N outros se ele não aparecer). Se a conta já estiver conectada, o chip mostra Conectado e a importação abre ali mesmo, sem sair de Contatos. A janela tem três passos: Mapear, Conferir e Importar.
No passo Mapear:
- Responsáveis: escolha o atendente da Clickmax de cada usuário do Zoho CRM. Quem ficar sem par entra sem responsável, ou com o Responsável padrão se você escolher um. A importação não cria atendentes nem envia convites.
- Pipelines: cada pipeline de negócios do Zoho CRM pode virar um pipeline novo com as mesmas etapas (Criar pipeline novo) ou ficar de fora (Não importar).
- Campos, nas abas Contatos, Empresas e Oportunidades:
- Em contatos e oportunidades, cada campo do Zoho CRM, inclusive os campos personalizados, pode virar um campo novo (Criar campo "…"), ir para um Campo que já existe na Clickmax ou ficar de fora (Não importar). Na aba Contatos aparecem os campos de Contatos e de Leads. Em oportunidades, aparecem só os campos personalizados: nome, valor, etapa, responsável e status vêm sempre.
- Em empresas, o campo vai para um Campo da Clickmax ou fica de fora.
- O que trazer: marque Notas, Tarefas e Ligações, reuniões e e-mails. Listas e Arquivos aparecem desabilitados, com o aviso O Zoho CRM não oferece estes dados pela API. Se quem conectou não é administrador, Notas aparece desabilitado com o aviso A chave não tem permissão para isso.
- Quando o contato já existe na Clickmax:
- Preencher só o que estiver vazio (padrão).
- Trocar pelos dados do Zoho CRM.
- Não mexer no contato.
A Clickmax identifica contatos repetidos por e-mail, telefone ou CPF, com as mesmas regras da importação por planilha. Um lead e um contato do Zoho com o mesmo e-mail viram um contato só.
Clique em Continuar. No passo Conferir, veja quantos usuários e pipelines a conta tem e quantos contatos, campos e pipelines são novos. Contar os outros registros gastaria a cota diária do Zoho, então esses números aparecem como —. Depois clique em Importar.
O que vem e como fica na Clickmax
Registros excluídos no Zoho CRM não vêm.
O que não vem
- Arquivos anexados: o Zoho cobra uma chamada por registro para listá-los, o que gastaria a cota diária.
- Listas (visualizações personalizadas): no Zoho são filtros, não listas de contatos.
- Leads já convertidos: no Zoho eles viram contato, conta e negócio, então chegam pelo contato.
- Notas, quando quem conectou não é administrador do Zoho CRM.
- Produtos das oportunidades.
Limites
- O Zoho CRM tem uma cota diária de chamadas por organização, que depende da edição e do número de licenças. Uma página de leitura traz até 200 registros e gasta uma chamada. Quando a cota acaba ou fica perto do fim, a importação pausa e volta sozinha quando o Zoho libera chamadas. Na edição gratuita, contas grandes podem levar mais de um dia.
- Cada módulo (Contatos, Leads, Contas, Negócios, Tarefas, Chamadas, Reuniões, Notas) tem o limite de 100.000 registros, o máximo que a API do Zoho deixa uma importação ler. Se um módulo passar disso, a importação para com um erro que cita o módulo, em vez de terminar sem os registros que sobraram.
Acompanhar, parar e repetir
Você pode fechar a janela: a importação continua e, ao voltar, você vê o andamento por tipo (Lidos, Criados, Já existiam, Ignorados, Falharam).
- Parar: clique em Parar importação. O que já entrou continua na Clickmax.
- Itens que não entraram: clique em Baixar itens não importados. A planilha
importacao-zoho-pendencias.csvlista o tipo e o motivo de cada item, com a situação falhou, ignorado ou aviso. aviso quer dizer que o item entrou, mas uma associação (por exemplo, a empresa de um contato) ficou de fora. - Repetir: importar de novo não duplica nada. Contatos e empresas são atualizados conforme a opção que você escolher em Quando o contato já existe na Clickmax. Oportunidades e históricos que já vieram não são reescritos. Conecte com a mesma organização do Zoho CRM.
Erros comuns
Se a importação terminou sem as notas, confira se quem conectou é administrador do Zoho CRM.