O Conexa não é um software de tarifação telefônica, mas caso você tenha um tarifador ou uma central que tenha tarifação, poderemos importar os registros gerados por sua central na plataforma do Conexa.
A partir das informações recebidas, o Conexa se encarrega de identificar o cliente que efetuou a ligação e gerar as vendas das ligações. Para que o Conexa consiga identificar corretamente os clientes que efetuaram a chamada, é necessário que os ramais sejam devidamente configurados na plataforma do Conexa. Caso contrário, a ligação será importada sem nenhum cliente vinculado. Para saber mais informações sobre o Módulo Interpretador de Tarifação Telefônica clique aqui.
O Conexa possui integração com os principais tarifadores. Porém se o seu tarifador ainda não está integrado e você possui ou deseja desenvolver sua própria solução para importar as ligações do seu tarifador para o Conexa, nós disponibilizamos uma API que receberá essas informações e irá gerar automaticamente as vendas no sistema.
Importando ligações através da API do Conexa
Para utilizar a API, é obrigatório a contratação do MÓDULO INTERPRETADOR DE TARIFAÇÃO TELEFÔNICA. Além disso, para que seja possível realizar requisições para a API, você deverá gerar um token de autenticação no Conexa para o Módulo Interpretador de Tarifação Telefônica. Para saber como gerar um token clique aqui.
Os tópicos a seguir irão detalhar como é realizada uma requisição para API e qual a estrutura da resposta.
Requisição
Para o envio da requisição, é necessário que as informação da tarifação estejam codificadas em um JSON seguindo o formato descrito abaixo. É necessário também o envio de um token de autenticação para o Módulo Interpretador de Tarifação de Telefônica, emitido na plataforma do Conexa. A seguir, temos um exemplo de implementação da requisição utilizando CURL ou clique aqui para visualizar um exemplos de requisições no Postman. Também recomendamos a utilização do Postman para estudo e teste da API.
curl
-H "Content-Type: application/json"
-H "Token:token"
-X POST
-d 'data'
seusubdominio.conexa.app/index.php?r=tarifacaoAutomatica/tarifacaoTelefonia
Onde,
seusubdominio: Seu subdomínio de acesso ao Conexa. Por exemplo, se você acessa a URL open.conexa.app, seu subdomínio será apenas open
token: Token de autenticação gerado na plataforma do Conexa para o Módulo Interpretador de Tarifação de Telefônica
data: JSON no seguinte formato:
Chave | Validação | Descrição | Obrigatório |
src | /[0-9]+/ | Ramal que efetuou a ligação (1) | Sim |
pin | /[0-9]*/ | PIN do cliente que realizou a ligação (2) | Não |
dst | /[0-9]+/ | Número de destino da ligação | Sim |
duration | (h:i:s) | Duração da ligação. Ex: 00:05:24 | Sim |
calldate | (Y-m-d h:i:s) | Data e hora da ligação. Ex: 2019-10-25 14:30:25 | Sim |
price | /[0-9]+\.[0-9]{2}/ | Valor da chamada utilizando "." como separador de centavos. Ex: 0.50, 1000.00, 12.70 | Sim |
(1) Para saber como configurar o ramal do seu cliente do Conexa clique aqui
(2) Caso você deseje utilizar PIN para identificação da ligação, envie um e-mail para [email protected] solicitando a liberação desse recurso.
Exemplo:
[{
"src": "5090", "pin": "1515", "dst": "75998889875", "duration": "00:01:25", "calldate": "2019-10-22 08:00:31", "price": "0.30" }, { "src": "5091", "pin": "1515", "dst": "75998889875", "duration": "00:01:25", "calldate": "2019-10-22 08:00:31", "price": "0.30" }]
Resposta
Ao realizar uma requisição válida para a API, o Conexa irá responder com um JSON com informações acerca do processamento das ligações enviadas
Chave | Valor | Descrição |
|
success | boolean | Informa se a requisição foi processada |
|
receivedRecords | int | Quantidade de registros recebidos na requisição |
|
importedRecords | int | Quantidade de registros importados no Conexa |
|
duplicateRecords | int | Quantidade de registros já inseridos anteriormente no Conexa |
|
errors | list | Lista de erros encontrados nos registros enviados no atributo data da requisição. Cada elemento dessa lista possui 2 chaves:
|
|
Exemplo:
{
"success": true, "receivedRecords": 3, "importedRecords": 2, "duplicateRecords": 0, "errors": [ { "record": { "src": "t15", "dst": "75998889875", "calldate": "2019-10-22 08:00:31", "price": "0.30", "pin": null }, "errors": { "src": "Campo mal formatado. Regex:/^[0-9]+$/", "duration": "Campo obrigatório não informado" } } ]}