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:

  1. 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.

  2. Solicitar a lista de cidades disponiveis: Utilizando a rota /city/list-by-uf/{uf} obter os detalhes das cidades disponiveis para realizar o teste
  3. Obter informações de equipamento: Utilizando a rota /equipment/ obter informações de equipamento cadastrados
  4. Registrar uma URL de callback:  Registrar uma URL de callback para receber status dos testes criados pela API.
  5. 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.

  6. 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.

  7. 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.

  8. 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.

  9. 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 WhatsApp0800 724 0804.

  • No labels