Esta API é destinada a
Canais e Aliançasparceiros 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 o formulário fornecido personalizado pela própria Directcall o parceiro recebe uma cópia das informações recebidas por e-mail as informações que chegam na Directcall, cada vez que ele é preenchido. - Com esta API o parceiro pode personalizar o ayout 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 o Cliente do parceiro pode solicitar linhas telefônicas gratuitas 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.