Documentation Index

Fetch the complete documentation index at: https://support.kommo.com/llms.txt

Use this file to discover all available pages before exploring further.

Conecte o n8n à Kommo

Prev Next

O que você vai precisar:

  • Uma conta n8n.

  • Qualquer plano Kommo (Básico, Avançado, Empresarial ou teste de 14 dias).

Tenha em mente:

  • Somente as ações listadas na documentação para desenvolvedores da Kommo são suportadas no n8n.

  • Os nodes de solicitação HTTP são necessários para conectar a Kommo ao n8n Cloud (o n8n não inclui um conector Kommo integrado).

Antes de começar, certifique-se de ter uma conta n8n ativa. Você pode conectar a Kommo e o n8n de três maneiras diferentes, dependendo de como planeja executar seus fluxos de trabalho.

Via solicitação HTTP

Para conectar a Kommo ao n8n Cloud via solicitação HTTP:

No n8n:

  1. Faça login na sua conta e crie um novo fluxo de trabalho.

  2. Clique no ícone + para adicionar um node.

  3. Abra a categoria Core.

  4. Selecione HTTP Request.

  5. No campo Authentication, defina o tipo de credencial como Generic credential type.

  6. No campo Generic Auth Type, insira o valor da OAuth2 API.

  7. Abra o menu suspenso do OAuth2 API e clique em Create new credential.

  8. Na janela pop-up, copie o URL de redirecionamento OAuth (1) — você precisará dele ao criar a integração na Kommo.

Insira os seguintes valores:

  • URL de autorização (2).

  • URL do token de acesso (3).

Saiba mais sobre como funciona a URL do token de acesso.

  1. Mantenha esta janela aberta. Você preencherá os campos Client ID (4) e Client Secret (5) posteriormente usando as chaves geradas no Kommo.

Para obter mais informações sobre como funcionam as requisições HTTP, consulte nossa documentação.

Continue na Kommo:

  1. Na sua conta Kommo, acesse Configurações → Central de integrações. Em seguida, clique em + Criar integração.Integration settings page displaying various messaging apps and a highlighted integration button.

  2. Cole o URL de redirecionamento OAuth (1) copiado do n8n.

    Form for creating integration with highlighted URL field and upload options.

  3. Adicione o nome e a descrição da integração.

    Integration setup form with fields for URL, access permissions, and language selection.

  4. Atribua as permissões de acesso necessárias, selecione um idioma e clique em Salvar.

    Integration setup screen with highlighted options and save button for user configuration.

  5. Abra a guia Chaves e escopos. Gere uma Chave secreta (6) e copie seu ID de integração (7).Configuration settings for secret key and integration ID in a user interface.

De volta no n8n:

  1. Insira os seguintes valores na janela de credenciais:

    1. Client ID: seu ID de integração (7).

    2. Client Secret: sua chave secreta (6) da Kommo.

  2. Clique em Save para concluir a configuração.

Por meio de token de longa duração

Para conectar a Kommo ao n8n e autenticar suas solicitações:

Na Kommo:

  1. Na sua conta Kommo, acesse Configurações → Integrações e clique em Criar integração no canto superior direito.

    Integration settings page displaying various messaging apps and a highlighted integration button.

  2. Insira o nome e a descrição da integração.

    Integration setup form with fields for URL, access permissions, and language selection.

  3. Atribua permissões de acesso, escolha um idioma e clique em Salvar.

    Integration setup screen with highlighted options and save button for user configuration.

  4. Abra a aba Chaves e escopos e gere um token de longa duração (8).

    Settings page showing integration ID and option to generate long-term token.

Continue no n8n:

  1. Faça login na sua conta n8n e crie um novo fluxo de trabalho.

  2. Clique no ícone + para adicionar um novo node.

  3. Selecione Core.

  4. Selecione HTTP Request.

  5. Abra a janela de configuração de Requisição HTTP e insira os seguintes valores:

    1. URL: seu domínio Kommo. Para encontrá-lo, copie seu URL da Kommo e remova as partes https:// e .kommo.com/ (por exemplo, se seu URL for https://teste.kommo.com/, seu domínio é teste.)

    2. Authentication: Tipo de credencial genérica.

    3. Generic Auth Type: Autenticação de portador.

    4. Bearer Auth: Conta de autenticação de portador.

  6. Abra a janela da conta Bearer Auth e cole seu token de longa duração (8) da Kommo.

  7. Clique em Save para finalizar.

Saiba mais sobre como funcionam as requisições HTTP.

Via Docker

Para conectar a Kommo ao n8n via Docker, você precisará baixar e instalar o Docker Desktop do site oficial. Em seguida, siga estes passos:

No Docker

  1. Acesse Volumes → Create a volume.

  2. Dê o nome de n8n_data ao volume e clique em Create.

  3. Acesse Images e clique em Search images to run.

  4. Uma janela de pesquisa será aberta. Digite n8n e clique em Pull para baixar a imagem.

  5. Após a conclusão do download, clique em Run para criar o contêiner.

  6. Preencha os campos obrigatórios seguindo a documentação do n8n e clique em Run.

  7. Após a conclusão da instalação, abra seu n8n local e configure a conta de proprietário.

Confira o guia em vídeo do n8n para obter mais informações sobre a instalação.

No n8n

  1. Clique no ícone do seu perfil no canto inferior esquerdo e abra Settings.

  2. Vá em Community nodes e clique em Install a community node.

  3. Digite n8n-nodes-kommo como o nome do pacote npm e aceite a política. Em seguida, clique em Install.

  4. O node da Kommo agora aparecerá na sua lista de nodes. Para conectá-lo ao n8n, crie um fluxo de trabalho e clique no ícone +.

  5. Digite Kommo no campo de pesquisa e selecione-o.

  6. Na lista de Actions, selecione Get list of companies.

  7. Clique em Create new credential.

  8. Selecione a API Kommo OAuth2 e clique em Continue.

  9. Copie o OAuth Redirect URL gerado para usar posteriormente na Kommo e mantenha a janela aberta para concluir a configuração mais tarde no Kommo.

Continue na Kommo

  1. Na sua conta Kommo, acesse Configurações → Integrações e clique em Criar integração.

    Integration settings page displaying various messaging apps and a highlighted integration button.

  2. Preencha os detalhes de integração:

    1. URL de redirecionamento (aquela copiada do n8n).

      Integration setup screen highlighting the redirect URL field for configuration.

    2. Nome da integração.

    3. Descrição.

      Integration setup interface with fields for URL, access permissions, and language selection.

  1. Clique em Salvar.

  2. Abra a aba Chaves e escopos e copie o seguinte:

    1. Chave secreta (6).

    2. ID de integração (7).

      Settings page displaying secret key and integration ID for configuration purposes.

De volta no n8n:

  1. Retorne à janela de credenciais no n8n.

  2. Insira os seguintes valores:

    1. Client ID: seu ID de integração Kommo (7).

    2. Client Secret: sua chave Kommo Secret (6).

    3. Subdomain: seu subdomínio Kommo.

  3. Clique em Save.

Se você ainda precisa de ajuda ou tem outras dúvidas, sinta-se à vontade para entrar em contato com o nosso chat de suporte ou nos contatar via WhatsApp. Você também pode contratar um parceiro Kommo para fazer todo o trabalho pesado para você.

Ainda não é um usuário? Cadastre-se no nosso teste de 14 dias ou agende uma demo pessoal grátis.