Integrações privadas são utilizadas para fazer uma melhoria para apenas uma conta ou para adicionar um recurso que apenas uma empresa/conta necessita (por exemplo, um formulário para um site, integração com o software exclusivo do cliente, etc.).

☝️

Para criar uma integração, você precisa ter direitos de administrador da conta

A integração será atribuída a esta conta. Isso significa que qualquer um dos administradores desta conta poderão gerenciar a integração e terão acesso às suas chaves compartilhadas.

O cliente deve entender até que ponto as integrações dão acesso a dados da conta.

Qualquer integração deve ser registrada em uma conta para receber chaves de autorização, pois não podem existir chamadas de API anônimas.

Conta Kommo

Para desenvolver uma integração privada basta registrar uma conta no nosso site Kommo.com. Você pode usar uma conta teste ou sua própria conta de negócios.

Agora, quando você tem uma conta, vamos ver como uma integração pode afetá-la!

Instrumentos

Integrações privadas podem trabalhar com os seguintes instrumentos:

Instrumentos	Descrição
API do CRM	A capacidade de manipular e gerar dados na Kommo, incluindo contas, usuários, leads, contatos, tarefas, etc.
JS SDK	Conjunto de funções e objetos que facilitam o acesso ao ambiente (informações sobre o widget, o usuário autorizado, etc.).
Salesbot	Uma ferramenta para criar cenários personalizados para automatizar operações com um usuário via mensageiros.
Digital pipeline	Uma poderosa ferramenta de automação que permite configurar reações a diferentes eventos, como e-mails, chamadas ou mensagens recebidas, mudanças de estágio de leads ou visitas ao site.
API do Chat	A capacidade de criar integrações com diferentes mensageiros e permitir que os usuários do Kommo enviem e recebam mensagens através deles.
API do VoIP	Conjunto de métodos API e JS que são úteis para conectar serviços de telefonia com o Kommo.

Criando uma integração privada

Esse tipo de integração pode ser desenvolvido em qualquer tipo de conta. Sinta-se à vontade para usar sua conta de negócios ou uma conta técnica para o desenvolvimento (ou até mesmo uma conta de teste).

👍
Integrações privadas não precisam passar por moderação!

Para criar uma integração, siga estas etapas:

Faça login como um administrador da conta.
Vá para Configurações → Integrações, clique no botão Criar integração e envie o formulário.

Se você usar uma conta técnica, deve escolher Privada para criar uma integração privada.

Após clicar no botão Criar integração você verá um formulário contendo as propriedades da integração.

🚧
Se você for usar um Token de Longa Duração, não digite nada no campo URL de Redirecionamento.

4 mandatory steps to a private integration — Você pode criar uma integração privada com apenas um clique

Propriedades de integração

Propriedade	Requisito?	Descrição
Nome da Integração	✅	O nome da integração (de 3 a 255 caracteres) é exibido no marketplace e em uma janela modal para concessão de acesso. Se você criar uma integração com um clique, o nome da sua integração será Nome da Integração por padrão.
Descrição	✅	A descrição da integração (de 5 a 65.000 caracteres) é exibida na janela modal de integração na conta do usuário. É permitido usar layout em HTML. Se você criar uma integração com um clique, a descrição da sua integração será Descrição por padrão.
Permitir Acesso	✅	Conceder acesso é o conjunto mínimo de permissões necessárias para a integração funcionar. Você pode ler mais sobre permissões nos escopos. Se você criar uma integração com um clique, todas as permissões serão verificadas por padrão.
Ícone da Integração	❌	O ícone da integração (400×272) (jpeg/jpg/png/gif) é exibido na lista de integrações e na janela de solicitação de acesso do usuário.
Redirect URL	❌	A URL de redirecionamento é um link para o seu site que irá gerenciar o trabalho com as chaves. É importante que o domínio esteja protegido por um certificado SSL se você planeja usar a integração em mais de uma conta. Também verificamos a disponibilidade do domínio de tempos em tempos como um pré-requisito para o funcionamento da integração.
Webhook de notificação de acesso revogado	❌	Link para um webhook sobre a desativação da integração. Uma solicitação GET será enviada para esse endereço quando o usuário desativar a integração. A solicitação conterá dois parâmetros: `account_id` e `client_id`.
Controle duplicado	❌	Você precisa marcar esta caixa se sua integração oferecer suporte a controle de duplicidade.
Fontes múltiplas	❌	Você precisa marcar esta caixa se sua integração gerenciar as fontes por conta própria através da API de Fontes. Se a caixa estiver marcada, o Kommo não criará fontes por padrão; a integração mesma terá que criar todas as fontes necessárias.

Como você percebeu, você pode enviar um widget para a integração. Uma integração sem um widget pode ser usada apenas para obter as chaves necessárias para acessar a API, mas o widget é a parte que contém os detalhes de programação.

Agora salve a integração. O Kommo gerará e exibirá as chaves necessárias na aba Chaves e escopos. Você pode usar o Token de Longa Duração e/ou Código de autorização no processo de autorização, Chave Secreta e ID de Integração serão usados independentemente da conta em que será instalada. Se você enviar um widget, um Código Widget também será gerado.