Integracoes

Importar do Planilhas Google para o Kommo

O widget permite carregar automaticamente dados do Planilhas Google no Kommo e mantê-los atualizados. Crie novos contatos, empresas e negócios. As alterações são importadas um minuto após as alterações na tabela ao configurar um gatilho do Apps Script.

Recursos

Baixar dados automaticamente do Planilhas Google
Crie contatos, empresas e negócios
Importe dentro de um minuto após a alteração da tabela (via Apps Script)
Modo de sincronização periódica de backup (a cada 10 minutos)
Cenários flexíveis de processamento de duplicatas
Configurando horário de trabalho para importação
Tags automáticas para negócios
Sincronização bidirecional com widget de upload
Personalização fácil do formato da tabela

Guia de instalacao e configuracao

Guia detalhado para trabalhar com o widget "Importar do Planilhas Google para o Kommo"

CONTEUDO

  1. Configurações básicas
  2. O processamento leva
  3. Configurando uma tabela para importação
  4. Configurando o Apps Script para importação instantânea
  5. Colabore com o widget "Fazer upload para planilha do Google"
  6. Configurando a importação (etapa final)
  7. Informações de transferência de dados

Configurações básicas

  • Após instalar o widget, vá em Configurações e clique no botão +Adicionar.

Em seguida, configure os parâmetros de importação:
Link da tabela — cole o link da sua Google Sheet.
Funil e etapa — selecione o funil e a etapa para onde os negócios serão importados.
Horário de trabalho — informe o intervalo de tempo para a importação.
Tag para os negócios — informe a tag que será adicionada automaticamente aos negócios durante a importação.

  • Exemplo de configurações de horário: se você precisar configurar a importação das 23h às 10h, adicione dois intervalos:
  • 23h00–23h59
  • 00h00–10h00
  • Caso precise adicionar outra tabela para importação, clique em +Adicionar e configure-a seguindo o mesmo princípio.
  • Todas as tabelas serão consideradas simultaneamente.
  • Após concluir as configurações, clique em Salvar.

O processamento leva

A função Script for takes está disponível nas configurações:

  1. Se o funil e o título corresponderem (padrão) - o negócio será atualizado se o funil (estágio não importa) e o nome do negócio corresponderem.
  2. Quando um funil corresponde - a transação é atualizada quando apenas o funil corresponde.
  3. Sempre crie novos - cada importação cria um novo negócio. Ao escolher este cenário, você deve excluir o Hash e o ID da transação da tabela.
  4. Qualquer negócio encontrado: o negócio será atualizado se o contato ou empresa já tiver pelo menos um negócio.

Configurando uma tabela para importação

Importante: nas configurações de acesso da tabela, indique “Qualquer pessoa com o link pode editar” ou conceda acesso ao nosso e-mail: [email protected]

  • Na primeira linha da tabela são indicados os nomes das colunas
  • Formato: Entity.Field name (por exemplo: Deal.Name, Contact.Phone)
  • Para mais detalhes, consulte o link

Configurando o Apps Script para importação instantânea

Para importar dados automaticamente ao alterar uma tabela, você precisa instalar um Apps Script especial em sua Planilha Google. Isso garantirá que as alterações sejam processadas rapidamente (dentro de um minuto). A configuração leva apenas 2 minutos - basta colar o código e executar uma função!

⚡ A importação Sem Apps Script funcionará no modo de verificação periódica (a cada 10 minutos), o que retarda significativamente a sincronização de dados.

Vantagens de configurar um gatilho:

  • ⚡ Processamento rápido – as alterações são importadas em um minuto
  • 🔄 Automação – não há necessidade de esperar pela sincronização periódica
  • 💪 Relevância dos dados – as informações no Kommo sempre correspondem à tabela

💡Onde posso encontrar o ID da conta? No Kommo, clique no seu avatar no canto superior esquerdo → Seu número de cliente. Este é o seu account_id.

Instruções passo a passo:

  1. Abra sua Planilha Google
  2. No menu, selecione: Extensões → Apps Script
  3. Copie o código abaixo e cole-o em seu editor (substituindo todo o código existente)
  4. Execute a função setup (selecione na lista suspensa e pressione ▶️)
  5. Retorne à planilha (localizada na próxima aba) na janela que aparece, insira seu account_id (no Kommo: clique no avatar no canto superior esquerdo → Seu número de cliente)
  6. Preparar! Agora as alterações na tabela serão importadas automaticamente
// 🚀 Функция для первоначальной настройки - запустите её один раз!
function setup() {
  var ui = SpreadsheetApp.getUi();
  
  // Запрашиваем account_id у пользователя
  var response = ui.prompt(
    '⚙️ Настройка автоматического импорта',
    'Введите ваш Account ID (в amoCRM: аватар слева вверху → Ваш номер клиента):',
    ui.ButtonSet.OK_CANCEL
  );
  
  if (response.getSelectedButton() !== ui.Button.OK) {
    ui.alert('❌ Настройка отменена');
    return;
  }
  
  var accountId = response.getResponseText().trim();
  if (!accountId) {
    ui.alert('❌ Account ID не может быть пустым');
    return;
  }
  
  // Сохраняем account_id
  PropertiesService.getScriptProperties().setProperty('account_id', accountId);
  
  // Удаляем старые триггеры
  var triggers = ScriptApp.getProjectTriggers();
  for (var i = 0; i < triggers.length; i++) {
    if (triggers[i].getHandlerFunction() === 'onEdit') {
      ScriptApp.deleteTrigger(triggers[i]);
    }
  }
  
  // Создаём новый триггер
  ScriptApp.newTrigger('onEdit')
    .forSpreadsheet(SpreadsheetApp.getActive())
    .onEdit()
    .create();
  
  ui.alert(
    '✅ Настройка завершена!',
    'Account ID: ' + accountId + '\n\n' +
    'Теперь при изменении таблицы данные будут автоматически ' +
    'импортироваться в amoCRM в течение минуты.',
    ui.ButtonSet.OK
  );
}

// ⚙️ Функция для получения account_id из настроек
function getAccountIdFromProperties() {
  return PropertiesService.getScriptProperties().getProperty('account_id');
}

// 🔄 Основная функция - срабатывает автоматически при редактировании таблицы
function onEdit(e) {
  var accountId = getAccountIdFromProperties();
  
  if (!accountId) {
    Logger.log("❌ Account ID не настроен. Запустите функцию setup()");
    return;
  }
  
  var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  var activeSheet = e.source.getActiveSheet();
  var sheetId = activeSheet.getSheetId();
  var baseUrl = spreadsheet.getUrl();
  var fullUrl = baseUrl + "?gid=" + sheetId + "#gid=" + sheetId;
  
  var url = "https://qp1-nova.ru/api/events/gimport_market/" + accountId;
  var payload = {
    url: fullUrl,
    timestamp: new Date().getTime(),
    sheet_name: activeSheet.getName(),
    spreadsheet_id: spreadsheet.getId()
  };
  
  var options = {
    method: "post",
    contentType: "application/json",
    payload: JSON.stringify(payload),
    muteHttpExceptions: true
  };
  
  try {
    UrlFetchApp.fetch(url, options);
    Logger.log("✅ Импорт запущен для листа: " + activeSheet.getName());
  } catch (error) {
    Logger.log("❌ Ошибка отправки: " + error.toString());
  }
}

💡 Importante: a instalação do Apps Script é recomendada para todos os usuários do widget. Isso garante a velocidade ideal de sincronização de dados entre o Planilhas Google e o Kommo. Se você tiver alguma dúvida sobre a configuração, entre em contato com o suporte técnico.

Colabore com o widget "Fazer upload para planilha do Google"

Para sincronização bidirecional, use juntos os widgets de Importação e Exportação. Nesse caso, qualquer alteração será sincronizada automaticamente.

Configuração:
1. Instale ambos os widgets na conta.
2. Crie uma única tabela para exportação e importação.

  • alterou um campo no Kommo → foi atualizado na tabela,
  • alterou um campo da tabela → foi atualizado no Kommo.
  • Depois disso, quando um negócio atinge o estágio de acionamento, os dados são carregados na tabela

Configurando a importação (etapa final)

  • Adicione um link para a mesma tabela nas configurações do widget Importar.
  • Selecione um estágio (qualquer um - o widget atualizará o negócio, independentemente do estágio).
  • As alterações na tabela e nas transações agora serão sincronizadas automaticamente
  • Após conectar-se à tabela, uma coluna de serviço Change Hash será adicionada - é necessário rastrear a exatidão da sincronização
  • Assim, você obtém sincronização total das transações entre Kommo e Planilhas Google em ambas as direções.

Informações de transferência de dados

ℹ️Os servidores deste serviço (Planilhas Google) estão localizados fora da Federação Russa. Se você processa dados pessoais de cidadãos da Federação Russa, recomendamos que garanta a conformidade com os requisitos da Lei Federal nº 152-FZ “Sobre Dados Pessoais” em relação à transferência transfronteiriça de dados.