Page tree
Skip to end of metadata
Go to start of metadata


Vantagens de integrar e utilizar o Directcall APP:

A versão Web da Directcall APP permite a implementação rápida de recursos avançados de telefonia cloud em qualquer aplicação web, basta adicionar o nosso plugin jQuery e começar a utilizar.

  • Você não precisa ser especialista na área de telefonia, nós facilitamos isto para você.
  • Sem o uso obrigatório de infraestrutura VoIP e de banda larga ideal para voz.
    • Isso agiliza a implantação e a adesão em múltiplos ambientes.

Sugerimos que você comece por aqui:

Instale o plugin da Directcall APP versão Desktop em seu computador, isso pode parecer contraditório se você deseja avaliar a nossa APP para sistemas Web, mas vai facilitar a avaliação imediata dos principais recursos de telefonia que poderão ser utilizados na sua aplicação Web, antes mesmo do desenvolvedor alterar o código de seu sistema para que você consiga ligar num clique, enviar SMS, gravar e ouvir ligações telefônicas, etc.

Como instalar a Directcall APP em aplicações Web:

Directcall APP Web
<script src="https://www.directcallsoft.com/api/app/novo/app/directcall-app-web.js"></script>

Observação: O uso da biblioteca jQuery é obrigatório.

Domínios, IP e portas para liberação:

  • IPS: Liberar entrada e saída 189.84.133.71, 189.84.129.12, 189.84.133.135, 189.84.135.200 (TCP E UDP)
  • PORTAS: 443,80,53,1025 a 65535

  • HTTPS: Obrigatório para chamadas via Navegador Google Chrome.

Caso seu Firewall seja SonicWall é necessário liberar o NAT.

https://www.sonicwall.com/en-us/support/knowledge-base/170504967157192


Métodos do plugin:

MétodoParâmetrosDescriçãoExemplo
search_querybusca (string)Realiza busca no conector setado$.directcall_app().search_query("nome cliente");
statelargura(int), altura(int)Seta o tamanho da janela do Directcall App Web$.directcall_app().state(280,40);
loginlogin(string), password(string), origem(int)Realiza o login na plataforma$.directcall_app().login("client_id", "client_secret", 554199999999);
comandocmd(string)Envia um comando ao APP Web$.directcall_app().comando("1|chamar|554199999999|Cliente");
statustitulo(String), mensagem(string)Envia a mensagem de alerta$.directcall_app().status("Titulo", "Minha mensagem");

Dicas importantes:

Você pode alimentar os extratos da Directcall com informações importantes da sua aplicação nas chamadas e mensagens realizadas ou recebidas.

Ex.: Assunto relacionado a ligação ou mensagem, nome do cliente, código do cliente, protocolo ou ticket de atendimento, tarefas, etc.

Isso facilita:
Para o usuário da sua aplicação buscar nos extratos assuntos de interesse, clientes, protocolos de atendimento, tarefas, etc., associado a cada ligação recebida, realizada, gravada, SMS recebido, enviado, etc. – A partir da Directcall APP.
Para o desenvolvedor listar de maneira proativa nas janelas da sua aplicação (ex. no cadastro de cliente), o histórico de ligações recebidas, realizadas, gravadas, SMS, etc., relacionados com um cliente,  tarefa, protocolo de atendimento, etc. – A partir das APIs de extratos da Directcall.

Exemplo de como enviar estas informações por um link html:

Exemplo HTML com JS
<a href="javascript:void(0)" onclick="$.directcall_app().comando('1|chamar|NUMERO_A_CHAMAR|ID_DO_CLIENTE|NOME_CLIENTE|ORIGEM|ID_OBJETO_2|NOME_OBJETO_2');">(41) 3016-0300</a>
 
OU
 
<a href="javascript:void(0)" onclick="$.directcall_app().commandObject({"position":"1","action":"chamar","number":"NUMERO A SER CHAMADO","name":"Nome do cliente", "idObjectTwo":"ID_OBJETO_2", "nameObjectTwo": "NOME_OBJETO_2"});">(41) 3016-0300</a>

Observações: Os itens "id_objeto_2" e "nome_objeto_2" são opcionais, mas se enviados, um complementa o outro, sendo um a KEY e o outro o VALUE do campo.

 

Parâmetros do plugin:

ParâmetrosTipoDescrição
stateString - "close", "hide"Seta o estado inicial do APP Web, que pode ser fechado (close) ou minimizado (hide)
loginStringclient_id do cliente API
passwordStringclient_secret do cliente API
origemStringNumero de origem a ser configurado para o Directcall APP Web
clicktocallBooleanCom esta opção habilitada, o APP Web busca todos os números de telefone na pagina e adiciona a ação de chamar com clique.
imageString

Tipos: "default" 25x25 pixels, "default@1x" 19x19 pixels "default@2x" 13x13 pixels

Ou você pode indicar a URL da imagem que deseja usar.

habilitar_menu_chamadasBooleanHabilita ou desabilita menu de chamadas
habilitar_menu_smsBooleanHabilita ou desabilita menu de envio de SMS
habilitar_menu_mensagem_de_vozBooleanHabilita ou desabilita menu de envio de mensagens de voz


Exemplo de implementação:

Exemplo de implementação
...
 
<script>
$(document).ready(function(){
	$.directcall_app({
		state:"hide",
		login: "nome_do_usuario",
		password: "senha_do_usuario",
		origem: "numero_de_origem",
		clicktocall: true,
		image: "default@1x"
	});
});
</script> 
</body>
</html>

Como conecto a Directcall APP Web na minha base?

O Directcall APP Web realiza busca através do parâmetro configurado no "conector" que deve retorna um JSON no formato abaixo:

EXEMPLO
{
   "contatos":[
      {
         "nome":"NOME DO CLIENTE AQUI",
         "ddi":"",
         "ddd":"",
         "numero":"554130160300"
      },
      {
         "nome":"NOME DO CLIENTE AQUI",
         "ddi":"",
         "ddd":"",
         "numero":"554130169062"
      },
      {
         "nome":"NOME DO CLIENTE AQUI",
         "ddi":"",
         "ddd":"",
         "numero":"554130169062"
      },
      {
         "nome":"NOME DO CLIENTE AQUI",
         "ddi":"",
         "ddd":"",
         "numero":"554130169062"
      },
      {
         "nome":"NOME DO CLIENTE AQUI",
         "ddi":"",
         "ddd":"",
         "numero":"554130169062"
      }
   ]
}