Esta API é destinada a parceiros da Directcall que desejam oferecer para o mercado equipamentos e aplicativos SIP com o valor agregado de uma Linha Telefônica gratuita para os seus clientes, que permite ligar para telefones fixos e móveis por até 45 dias ou até que sejam consumidos os minutos gratuitos associados a cada linha.
Permite iniciativas como esta no seu website: 
Além do valor agregado para as soluções do parceiro:
- Com esta API o parceiro pode reter as informações geradas por cada solicitação, alimentar automático seus sistemas de clientes..
- Se divulgar apenas o formulário personalizado pela própria Directcall o parceiro recebe por e-mail as informações que chegam na Directcall, cada vez que ele é preenchido. - Com esta API o parceiro pode personalizar o layout do formulário que permite solicitar uma linha telefônica gratuita na Directcall.
- A Directcall costuma configurar apenas a logo do parceiro no formulário que personaliza para cada Canal ou Aliança.
Em qualquer alternativa a Directcall pode assumir o suporte técnico para que os leads e clientes do parceiro utilizem o valor agregado das linhas telefônicas gratuitas da Directcall nas suas soluções SIP.
O Lead ou Cliente do parceiro pode solicitar linha telefônica gratuita em qualquer DDD.
Este documento descreve os passos necessários para que os parceiros utilizem esta API de de maneira simples e intuitiva para rápida implementação, desde a autenticação até a confirmação se o usuário concluiu a validação de dois fatores associados a cada solicitação no lado da Directcall e se o usuário precisou alterar os seus dados para concluir a validação.
Requisitos:
- Ser parceiro Directcall homologado.
Descrição do passo a passo da API:
Autenticação via OAuth: Antes de iniciar qualquer interação com a DirectCall, o parceiro deve autenticar-se utilizando OAuth, garantindo segurança e controle de acesso às funcionalidades da API.
- Solicitar a lista de cidades disponiveis: Utilizando a rota /city/list-by-uf/{uf} obter os detalhes das cidades disponiveis para realizar o teste
- Obter informações de equipamento: Utilizando a rota /equipment/ obter informações de equipamento cadastrados
- Registrar uma URL de callback: Registrar uma URL de callback para receber status dos testes criados pela API.
Registro de Pedidos de Teste: Uma vez autenticado, o parceiro pode registrar pedidos de teste na DirectCall fornecendo as informações necessárias. É crucial que todos os campos obrigatórios estejam preenchidos corretamente para evitar recusas pela API.
Verificação de Teste Existente: Caso o contato já tenha realizado um teste prévio do nosso SIP Trunk, a API retornará um código de erro 409 (Test already exists), informando que o pedido de teste foi negado devido ao teste anterior já existente.
Processo para Novos Testes: Se o contato ainda não tiver testado o SIP Trunk, a API irá retornar a URL da DirectCall. O parceiro deve redirecionar o contato para essa URL, onde será solicitado que o mesmo verifique seu e-mail cadastrado. Existe também a opção para atualização do e-mail cadastrado, caso necessário.
Início do Processo de Liberação: Uma vez que o contato tenha acessado a URL e validado seu e-mail, a DirectCall iniciará o processo para liberar o teste, incluindo instruções detalhadas sobre o uso do serviço, planos de minutos disponíveis, entre outros detalhes relevantes.
Retorno de Informações ao Parceiro: Finalmente, a API retornará ao parceiro o status do pedido de teste, indicando se foi ativado com sucesso. Além disso, será fornecido o e-mail encontrado no banco de dados da DirectCall, permitindo que o parceiro mantenha seus registros atualizados conforme necessário.
Clique aqui para acessar a documentação técnica interativa desta API, que facilita o entendimento, testes e o uso desta API, inclui detalhes sobre endpoints, métodos HTTP, parâmetros, respostas e exemplos de chamadas.
Suporte técnico: Telefone gratuito e WhatsApp: 0800 724 0804.