APP para sistemas Web (jQuery)

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)
DOMÍNIOS: directcallsoft.com, directdial.com.br
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étodo	Parâmetros	Descrição	Exemplo

Método	Parâmetros	Descrição	Exemplo
search_query	busca (string)	Realiza busca no conector setado	$.directcall_app().search_query("nome cliente");
state	largura(int), altura(int)	Seta o tamanho da janela do Directcall App Web	$.directcall_app().state(280,40);
login	login(string), password(string), origem(int)	Realiza o login na plataforma	$.directcall_app().login("client_id", "client_secret", 554199999999);
comando	cmd(string)	Envia um comando ao APP Web	$.directcall_app().comando("1\|chamar\|554199999999\|Cliente");
status	titulo(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:

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âmetros	Tipo	Descrição

Parâmetros	Tipo	Descrição
state	String - "close", "hide"	Seta o estado inicial do APP Web, que pode ser fechado (close) ou minimizado (hide)
login	String	client_id do cliente API
password	String	client_secret do cliente API
origem	String	Numero de origem a ser configurado para o Directcall APP Web
clicktocall	Boolean	Com 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.
image	String	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_chamadas	Boolean	Habilita ou desabilita menu de chamadas
habilitar_menu_sms	Boolean	Habilita ou desabilita menu de envio de SMS
habilitar_menu_mensagem_de_voz	Boolean	Habilita ou desabilita menu de envio de mensagens de voz

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"
      }
   ]
}