Click-to-call

A Kommo permite aos gerentes fazer chamadas à partir de qualquer cartão de contato, empresa ou lead simplesmente clicando no número de telefone exibido no cartão.

Essa funcionalidade é implementada usando a função add_action(type, action):

ParâmetroTipo de dadoDescrição
typestringO tip do parâmetro passado (email ou phone)
actionfunctionA função que será chamada ao clicar em um número de telefone ou endereço de email

Por exemplo, você pode usar a função add_action(type, action) dentro da função de callback init, que é parte da estrutura do script.js.

init: function(self){
 /*
 * adiciona um call_to_action
 * tipo: phone
 * Valor do campo phone
 */
 self.add_action('phone', function(data){
  self.crm_post (
   /* Envie a requisição para o seu serviço de VoIP
   * pra realizar a discagem do número
   * O método crm_post (url, data, callback, type, error)
   */
   'http://yourservice.com/dealmethod.php',
  {
   call_to: data.value
  },
  function(msg){
   alert('Call is performed');
  },
  'text',
  function(){
    alert ('Error');
  }
  );
 });
}
📘

É necessário declarar as localizações do widget no manifest.json para que a função add_action(type, action) seja executada. Você deve definir essas localizações onde números de telefone são exibidos.

O exemplo a seguir especifica todas as localizações do widget em que os números de telefone podem ser encontrados:

{
  ...
    "locations": [
        "ccard-1",
        "clist-1",
        "lcard-1",
        "llist-1",
        "comcard-1",
        "everywhere"
    ],
  ...
}

Se você quiser alterar o rótulo exibido no botão que aparece ao clicar em números de telefone ou endereços de e-mail, será necessário fazer as alterações apropriadas no arquivo de localização .json localizado no diretório i8n da estrutura do seu widget.

Arquivos i18n

{
    "widget": {
        "call_action": "Chamar"
    }
}

Se o parâmetro call_action não for especificado, o rótulo do botão utilizará por padrão o nome do seu widget, que é um parâmetro obrigatório no manifest.json . O valor de call_action será inserido automaticamente no botão quando o widget for inicializado.