...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

Callback de status de chamada

Esta API foi desenvolvida para:

1) Alertar o sistema do cliente sobre o STATUS de chamadas realizadas e sobre a mudança de STATUS (atendeu, ocupado, desligou, etc.), sem que o sistema do cliente precise consultar de maneira proativa os servidores da Directcall.

2) Alertar o sistema do cliente sobre a chegada de CHAMADAS RECEBIDAS e sobre o STATUS de chamadas recebidas.

NOTA: Para receber estas informações em seu sistema, será necessário registrar uma URL de notificação.

Registrando um URL de notificação

...

...

DESCRIÇÃO	Com este método, podemos registrar uma URL para receber avisos de ligações recebidas e avisos de mudança no status de ligações realizadas
ESTRUTURA DA URL	https://api.directcallsoft.com/voz/add-callback
VERSÃO	1
MÉTODO	POST
PARÂMETROS	access_token obrigatório Chave de acesso ao método, para saber como obter clique aqui url obrigatório (String) URL que recebera o status das chamadas  pin opcional (String) Cadastra a URL para um pin especifico IMPORTANTE: Você pode evitar que a sua URL fique exposta utilizando autenticação por HTTP Basic Auth, basta adicionar ao inicio da URL usuário e senha: Por exemplo: https://usuario:senha@dominiodocliente.com.br  format opcional Opção de retorno da API podendo ser JSON ou XML

,

(se não informado JSON será o padrão)
RETORNO	api Origem API que esta sendo usada modulo Módulo que está sendo chamado status Mensagem de status codigo Código de retorno - Clique aqui para listar os códigos e suas descrições code Identificador

unico

único da URL registrada

 

Exemplo de resposta em JSON

{

Bloco de código { "api":"sms",

"modulo":"add-callback-status-chamada",

"status":"ok",

"codigo":"001",

"msg":"URL de Callback cadastrada com sucesso.",

"code":"7cfa08f1bdc011d524d8ec8bbceb7d06df237a14"

}

 

Removendo URL registrada para callback

...

...

DESCRIÇÃO	Com este método podemos remover uma URL registrada para recebimento de callback

de SMS enviado

ESTRUTURA DA URL	https://api.directcallsoft.com/

sms

voz/remove-callback
VERSÃO	1
MÉTODO	POST
PARÂMETROS	access_token obrigatório Chave de acesso ao método, para saber como obter clique aqui code obrigatório (String) Identificador único da URL registrada a ser removida format opcional Opção de retorno da API podendo ser JSON ou XML, se não informado JSON será o padrão
RETORNO	api Origem API que esta sendo usada modulo Módulo que está sendo chamado status Mensagem de status codigo Código de retorno - Clique aqui para listar os códigos e suas descrições Exemplo de resposta em JSON Bloco de código {

"api":"sms",

"modulo":"remove-callback",

"status":"ok",

"codigo":"001",

"msg":"URL de Callback removida com sucesso."

}

 

...

}

Listando URLs registradas para callback

{
  "api": "sms",
  "modulo": "list-callback",
  "status": "ok",
  "codigo": "001", 
  "msg": [ ],
  "total": 1,
  "rows": [
         { 
            "code": "3c46e55e6669ec53d075bec8701745d38752a747",
            "url": "https://recebimentodecallback.com.br/status"
          }
     ]
}

Como vou receber e quais dados vou receber pelo sistema de callback?
 - Nosso sistema vai realizar um POST HTTP para a sua URL e os dados da mensagem serão encaminhados no formato JSON 

Dados recebidos vindo do Callback

{
	"origem": "554130160300",
	"destino": "554130160300",
	"uuid-origem": "0d87cc44-3142-11e5-ab4e-8326f25suj27519",
	"origem-status": "ANSWERED", // CREATED | ANSWERED | DESTROYED  
	"destino-status": "ANSWERED",
	"status-times":
		{
			"origem":{
				"chamada": "2015-01-01 00:00:00", // Data de chamada
				"atendida": "2015-01-01 00:00:00", // Data de atendida
				"finalizada": "2015-01-01 00:00:00", // Data de desligamento
			},
			"destino":{
				"chamada": "2015-01-01 00:00:00",
				"atendida": "2015-01-01 00:00:00",
				"finalizada": "2015-01-01 00:00:00",
			}
		}
}

...

<?php

$dados_recebidos_directcall = json_decode($_POST['data'], true);

echo '<pre>';

print_r($dados_recebidos_directcall);

echo '</pre>'; 

?>

...