For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/features/integrations/import-from-zoho.md.
  • Português
  • 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.

    1. Abra api-console.zoho.com e entre com o usuário do Zoho CRM.
    2. Escolha Self Client, clique em CREATE NOW e confirme.
    3. Na aba Client Secret, copie o Client ID e o Client Secret.
    4. 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
    5. Em Time Duration, escolha a maior duração (por exemplo, 10 minutes). Escreva qualquer descrição e clique em CREATE.
    6. Escolha Zoho CRM e a organização que você quer importar e clique em CREATE.
    7. Copie o código que aparece.

    Conectar na Clickmax

    1. Em Conectar sua conta, escolha o Data center da conta. O padrão é Estados Unidos (zoho.com).
    2. Cole o Client ID, o Client Secret e, em Código gerado, o código do passo anterior.
    3. 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:

    1. 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.
    2. 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).
    3. 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.
    4. 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.
    5. 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

    No Zoho CRMNa Clickmax
    Contato (módulo Contacts)Contato com a tag Contato, ligado à empresa dele
    Lead não convertido (módulo Leads)Contato com a tag Lead
    Tag de contato ou leadTag com o mesmo nome
    Conta (módulo Accounts)Empresa
    Negócio (módulo Deals)Oportunidade, ligada ao contato e à empresa, na mesma etapa. A situação de ganho ou perda vem da previsão da etapa no Zoho (Closed Won ou Closed Lost), e os perdidos trazem o motivo da perda. Se uma etapa tiver uma previsão diferente de Open, Closed Won ou Closed Lost, a prévia e a importação param com erro; ajuste a previsão da etapa no Zoho e tente de novo.
    Pipeline e etapasPipeline com as mesmas etapas
    UsuárioResponsável, conforme o passo Responsáveis
    Campo personalizadoCampo, conforme o passo Campos
    TarefaTarefa, concluída se está como concluída no Zoho. Um status que não é do Zoho padrão deixa a tarefa aberta e vai para o fim da descrição como "Status no Zoho"
    Chamada e reuniãoLinha do tempo do contato, marcada como Importado do Zoho CRM
    Nota (só com administrador)Nota na linha do tempo do contato, da empresa ou da oportunidade, marcada como Importado do Zoho CRM

    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).

    SituaçãoO que significa
    Lendo os dados do Zoho CRM...A Clickmax está lendo o Zoho CRM.
    Pronto para importarA leitura terminou.
    Importando para a Clickmax...Os dados estão entrando.
    O Zoho CRM limitou as chamadas. A importação volta às …Não precisa fazer nada. A importação continua sozinha no horário mostrado.
    A chave do Zoho CRM parou de funcionar…Clique em Reconectar o Zoho CRM, gere um novo código, conecte de novo e clique em Continuar importação. Ela segue de onde parou.
    Importação concluída.Terminou.
    A importação falhou.Veja Erros comuns.
    Importação parada.Você parou a importação.
    • 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.csv lista 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

    MensagemO que fazer
    O Zoho recusou o código: ele expira em poucos minutos e vale uma vez só. Gere um novo código e cole logo em seguida.Gere um novo código na aba Generate Code e conecte em seguida.
    O Zoho não encontrou este Client ID no data center escolhido. Confira o data center e o Client ID.Confira o final do endereço do Zoho no navegador e o Client ID da aba Client Secret. Depois gere um novo código.
    O Zoho recusou o Client Secret. Copie de novo o Client Secret do Self Client.Copie o Client Secret de novo, gere um novo código e conecte.
    A conta Zoho é de outro data center. Escolha o data center que aparece no endereço do Zoho (zoho.com, zoho.eu, zoho.in...).Escolha o data center certo e gere um novo código.
    Faltam permissões no código. Gere um novo código colando a lista de escopos inteira.Cole a lista de Escopos inteira no campo Scope e gere um novo código.
    O Zoho está limitando as chamadas desta conta. Espere alguns minutos e gere um novo código.Espere alguns minutos e tente de novo com um código novo.
    Já existe uma importação em andamento. Aguarde ou cancele antes.Acompanhe a importação atual ou clique em Parar importação.
    Não foi possível falar com o Zoho agora. Gere um novo código e tente de novo em alguns minutos.Indisponibilidade do lado do Zoho. Tente de novo mais tarde.
    O Zoho CRM recusou a extração: Zoho Contacts has more than 100,000 records… (com o nome do módulo)O módulo passa do limite de 100.000 registros. Desligue esse tipo de dado na importação, ou exclua ou mescle registros no Zoho até caber, e importe de novo.

    Se a importação terminou sem as notas, confira se quem conectou é administrador do Zoho CRM.

    Relacionados