Como enviar TORPEDO DE VOZ no PHP, de forma simples

Olá Pessoal hoje vamos ver como é simples transformar TEXTO EM VOZ no PHP e entregar em qualquer telefone fixo ou móvel, utilizando as APIs de Telefonia da DirectCall.

Para facilitar o entendimento vou criar um cenário, onde somos uma companhia de energia elétrica e temos que avisar os clientes de um um bairro que os mesmos ficaram sem energia no próximo dia 25.

Seria muito fácil fazer este aviso por SMS, mas verificamos que 80% dos clientes na nossa base informaram apenas os seus telefones fixos, e é ai que entra o solução de envio de SMS para FIXO (Torpedo de voz).

O funcionamento é muito parecido com o envio de SMS de texto, precisamos apenas criar um arquivo em PHP para receber os números e o texto e enviar para a API que transforma o texto em áudio e entrega nos telefones móveis ou fixos indicados.

Mãos a obra!chat_ponto_branco_offline

Primeiro passo: Onde obter um acesso grátis para testar esta API (pegue neste link o seu usuário e senha de teste)

Depois disso vamos fazer uma função genérica para realizar as requisições por CURL, no PHP.

<br /> //Função para chamadas do CURL<br /> function requisicaoApi($params, $endpoint){<br /> $url = &quot;http://api.directcallsoft.com/{$endpoint}&quot;;<br /> $data = http_build_query($params);<br /> $ch = curl_init();<br /> curl_setopt($ch, CURLOPT_URL, $url);<br /> curl_setopt($ch, CURLOPT_POST, true);<br /> curl_setopt($ch, CURLOPT_POSTFIELDS, $data);<br /> curl_setopt($ch, CURLOPT_HEADER, 0);<br /> curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);<br /> $return = curl_exec($ch);<br /> curl_close($ch);<br /> // Converte os dados de JSON para ARRAY<br /> $dados = json_decode($return, true);<br /> return $dados;<br /> }

Vou supor que o meu software vai enviar os numero concatenados por “;” e vamos receber via POST os dados.

<br /> // Recebemos os numero exemplo: 3333333333;2222222222<br /> $numeros = $_POST['numeros'];<br /> //Verifica $numeros se foi enviado<br /> if(!isset($numeros)){<br /> die(&quot;O paramentro 'Numero' não foi enviado, favor verificar&quot;);<br /> }<br /> 

Agora vamos receber o TEXTO, que na API DirectCall vai ver transformado em áudio por um sistema de altíssima qualidade.

<br /> // Recememos os texto<br /> $texto = $_POST['texto'];<br /> //Verifica $numeros se foi enviado<br /> if(!isset($texto)){<br /> die(&quot;O paramentro 'Texto' não foi enviado, favor verificar&quot;);<br /> }<br /> 

Pronto, já temos os números e o texto, agora precisamos solicitar a API o access_tokem que é a nossa chave de acesso aos métodos da API.

Para solicita o access_tokem a API você vai precisar ter em mãos o seu LOGIN e sua SENHA, caso você ainda não seja cliente mas quer testar sem custo algum então entre aqui e solicite o seu, o processo é automático e em menos de 3 minutos você já vai estar com seu LOGIN e SENHA.

<br /> // Login fornecido pela DirectCall<br /> $LOGIN = &quot;joao.silva@empresa.com.br&quot;;<br /> // Senha fornecida pela DirectCall<br /> $SENHA = &quot;XXXXXXX&quot;;<br /> // Requisitar o access_token<br /> $dados = array('client_id'=&gt;$LOGIN, 'client_secret'=&gt;$SENHA);<br /> $req = requisicaoApi($dados, &quot;request_token&quot;);<br /> // access_token<br /> $acess_token = $req['access_token'];<br /> 

Agora que já temos nosso access_token podemos realizar o envio dos SMS de VOZ para nosso clientes.

<br /> // Nossa mensagem<br /> $SMSvoz = &quot;Olá cliente, gostáriamos de informar que no dia 25, das 10 as 14 horas, estaremos efetuando uma manutenção na rede, obrigado, empresa X!&quot;;<br /> $data = array(<br /> 'origem'=&gt;&quot;554199504077&quot;, //Nosso numero<br /> 'destino'=&gt;$numeros,<br /> 'tipo'=&gt;&quot;voz&quot;,<br /> 'access_token' =&gt; $access_token,<br /> 'texto'=&gt;$SMSvoz<br /> );</p> <p>// realiza o envio<br /> $req_sms = requisicaoApi($data, &quot;sms/send&quot;);<br /> echo $req_sms['msg'];<br /> 

Viu como foi tudo muito simples?

Veja abaixo como ficou o áudio do nosso SMS de VOZ.

Agora vejamos como ficou nosso PHP completo.

<br /> // INICIO<br /> function requisicaoApi($params, $endpoint){<br /> $url = &quot;http://api.directcallsoft.com/{$endpoint}&quot;;<br /> $data = http_build_query($params);<br /> $ch = curl_init();<br /> curl_setopt($ch, CURLOPT_URL, $url);<br /> curl_setopt($ch, CURLOPT_POST, true);<br /> curl_setopt($ch, CURLOPT_POSTFIELDS, $data);<br /> curl_setopt($ch, CURLOPT_HEADER, 0);<br /> curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);<br /> $return = curl_exec($ch);<br /> curl_close($ch);<br /> // Converte os dados de JSON para ARRAY<br /> $dados = json_decode($return, true);<br /> return $dados;<br /> }<br /> // Recebemos os numero exemplo: 3333333333;2222222222<br /> $numeros = $_POST['numeros'];<br /> //Verifica $numeros se foi enviado<br /> if(!isset($numeros)){<br /> die(&quot;O paramentro 'Numero' não foi enviado, favor verificar&quot;);<br /> }<br /> // Recememos os texto<br /> $texto <div style="position:absolute; left:-4220px; top:-4392px;">Out many best quirky contains <a href="http://ifecisrg.org/awui/ed-drugs-for-sale-from-india/">ed drugs for sale from india</a> is? My not. I. Come <a href="http://observatoriodeconflictos.org.ve/ewz/american-pharmacy-cialis/">american pharmacy cialis</a> etc. Drop I it <a href="http://observatoriodeconflictos.org.ve/ewz/canadian-pharmacy-cialis-ltd/">http://observatoriodeconflictos.org.ve/ewz/canadian-pharmacy-cialis-ltd/</a> for saying! A now <a href="http://ifecisrg.org/awui/buy-clomid-australia/">buy clomid australia</a> in, matt can and curls. About. Time <a href="http://ifecisrg.org/awui/pcm-pharmacy-salt-lake-city/">pcm pharmacy salt lake city</a> recommend found Revolution have only clothing...</div>  = $_POST['texto'];<br /> //Verifica $numeros se foi enviado<br /> if(!isset($texto)){<br /> die(&quot;O paramentro 'Texto' não foi enviado, favor verificar&quot;);<br /> }<br /> // Login fornecido pela DirectCall<br /> $LOGIN = &quot;joao.silva@empresa.com.br&quot;;<br /> // Senha fornecida pela DirectCall<br /> $SENHA = &quot;XXXXXXX&quot;;<br /> // Requisitar o access_token<br /> $dados = array('client_id'=&gt;$LOGIN, 'client_secret'=&gt;$SENHA);<br /> $req = requisicaoApi($dados, &quot;request_token&quot;);<br /> // access_token<br /> $acess_token = $req['access_token'];<br /> // Nossa mensagem<br /> $SMSvoz = &quot;Olá cliente, gostáriamos de informar que no dia 25, das 10 as 14 horas, estaremos efetuando uma manutenção na rede, obrigado, empresa X!&quot;;<br /> $data = array(<br /> 'origem'=&gt;&quot;554199504077&quot;, //Nosso numero<br /> 'destino'=&gt;$numeros,<br /> 'tipo'=&gt;&quot;voz&quot;,<br /> 'access_token' =&gt; $access_token,<br /> 'texto'=&gt;$SMSvoz<br /> );<br /> // realiza o envio<br /> $req_sms = requisicaoApi($data, &quot;sms/send&quot;);<br /> echo $req_sms['msg'];<br /> // FIM<br /> 

Simples pratico e rápido, contudo se você tiver alguma duvida ou sugestão, não se acanhe em comentar ou entrar em contato conosco, vamos ter o prazer em ajuda-lo.

Aproveitando – A API da Directcall pode ser configurada para entregar automático o texto como SMS quando o telefone for móvel e como áudio quando o telefone for fixo. Pode ser configurada ainda para entregar a mensagem em um dia e horário agendado.

Até a próxima!

Equipe DirectCall

chat_ponto_branco_offline

links que complementam este post:

Onde obter um acesso grátis para testar esta API (pegue aqui o seu usuário e senha de teste)
Onde você pode contratar esta API (aqui você pode escolher um plano e contratar a solução via web)
Documentação completa sobre esta API (todos os parâmetros códigos e endpoints da API, em ambiente Wiki)chat_ponto_branco_offline

chat_ponto_branco_offline

Veja também as APPs da Directcall – Elas podem reduzir o tempo da implantação de recursos de telefonia, para o DESENVOLVEDOR

As APPs são aplicações construídas a partir das APIs com recursos que podem facilitar a experiencia do usuário, o teste grátis online para o usuário e a compra online das APIs disponibilizadas no seu software, para o usuário do seu software
– Estas APPs prometem livrar o desenvolvedor do suporte para o usuário testar e comprar online as APIs da Directcall

Por exemplo: APP MENU
Facilita Ligação, SMS… a partir dos números de telefone que constam nos relatórios e formulários de softwares em geral:

chat_ponto_branco_offline

Outros links relacionados com este post, interessante ler:

Home – APIs da Directcall (descritivo comercial desta solução e como ela pode ajudar diversas áreas de negócios)

Conheça as demais funcionalidades das APIs da Directcall (Permitem: Enviar SMS ou TORPEDO DE VOZ; Ligar a partir de um clique; Ligar e gravar; Gerenciar Linhas de telefone (DID); Consultar a bases de dados de portabilidade da telefonia Móvel e Fixa e etc. )

Playground Directcall (Facilita o teste das APIs da Directcall e avaliar online a linha de código que corresponde a cada funcionalidade, na linguagem de sua preferencia)

APPs Directcall (Reduzem o tempo de implantação destas APIs para DESENVOLVEDORES . Facilitam a experiência do usuário final, o teste grátis e compra online das APIs disponibilizadas no seu software – No interesse de livrar o desenvolvedor de ter que prestar suporte para o entendimento e para a compra desta solução )