totalvoice php
Versão 1.17.0
Cliente em PHP para API da Totalvoice
Funcionalidades
Requisitos
Instalação
Para instalar a biblioteca basta adicioná-la via composer
composer require total-voice/php-client 1.*
Ou no composer.json
{
"total-voice/php-client": "1.*"
}Testes
Podemos usar o composer para rodar os testes:
composer test
ou utilizando o .phar
php composer.phar test
Utilização
Para utilizar esta biblioteca, primeiramente você deverá realizar um cadastro no site da Total Voice. Após a criação do cadastro será disponibilizado um AccessToken para acesso a API.
Com o AccessToken em mãos será possível realizar as consultas/cadastros conforme documentação da API
Os métodos da API que poderão ser invocados:
A seguir um pequeno exemplo de como pode ser utilizada esta biblioteca.
Realiza uma chamada telefônica entre dois números: A e B
<?php
// Consideramos que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoiceClient as TotalVoiceClient;
$client = new TotalVoiceClient('access-token');
$response = $client->chamada->ligar('NUMERO-A', 'NUMERO-B');
echo $response->getContent();Consulta de chamada pelo ID
<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoiceClient as TotalVoiceClient;
$client = new TotalVoiceClient('access-token');
$response = $client->chamada->buscaChamada('ID_CHAMADA');
echo $response->getContent(); // {}Encerra uma chamada ativa
<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoiceClient as TotalVoiceClient;
$client = new TotalVoiceClient('access-token');
$response = $client->chamada->encerrar('ID_CHAMADA');
echo $response->getContent(); // {}Envio de SMS
<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoiceClient as TotalVoiceClient;
$client = new TotalVoiceClient('access-token');
$response = $client->sms->enviar('NUMERO-DESTINO', 'SUA MENSAGEM');
echo $response->getContent(); // {}
Envio de TTS
<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoiceClient as TotalVoiceClient;
$client = new TotalVoiceClient('access-token');
$response = $client->tts->enviar('NUMERO-DESTINO', 'SUA MENSAGEM');
echo $response->getContent(); // {}
Envio de Audio
<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoiceClient as TotalVoiceClient;
$client = new TotalVoiceClient('access-token');
$response = $client->audio->enviar('NUMERO-DESTINO', 'SUA MENSAGEM');
echo $response->getContent(); // {}Configurações de central telefonica
<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoiceClient as TotalVoiceClient;
$client = new TotalVoiceClient('access-token');
$response = $client->central->buscaRamal('ID-RAMAL');
echo $response->getContent(); // {}
Gerenciamento dos dados da Conta
<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoiceClient as TotalVoiceClient;
$client = new TotalVoiceClient('access-token');
$response = $client->conta->buscaConta('ID_CONTA');
echo $response->getContent(); // {}Consulta saldo da Minha Conta
<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoiceClient as TotalVoiceClient;
$client = new TotalVoiceClient('access-token');
$response = $client->perfil->consultaSaldo();
echo $response->getContent(); // {}Todas as classes da API podem ser instânciadas separadamente também
<?php
// Consideramos que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoiceClient as TotalVoiceClient;
use TotalVoiceApiChamada;
$client = new TotalVoiceClient('access-token');
$service = new Chamada($client);
$response = $service->ligar('NUMERO-A', 'NUMERO-B');
echo $response->getContent();Caso você utilize um Client personalizado
<?php
// Consideramos que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoiceApiChamada;
class MeuClient implements ClientInterface
{
}
$meuclient = new MeuClient('access-token');
$service = new Chamada($meuclient);
$response = $service->ligar('NUMERO-A', 'NUMERO-B');Caso você necessite utilizar seu próprio endereço configurado na Total Voice
<?php
// Consideramos que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoiceClient as TotalVoiceClient;
use TotalVoiceApiChamada;
$client = new TotalVoiceClient('access-token', 'https://meuhost.com.br');
$service = new Chamada($client);
$response = $service->ligar('NUMERO-A', 'NUMERO-B');Listando dids no estoque
<?php
use TotalVoiceClient as TotalVoiceClient;
use TotalVoiceApiChamada;
$client = new TotalVoiceClient('access-token');
$response = $client->did->listaEstoque();Adquirindo um did
<?php
use TotalVoiceClient as TotalVoiceClient;
use TotalVoiceApiChamada;
$client = new TotalVoiceClient('access-token');
$idDid = "10";
$response = $client->did->adquirir($idDid);Editando um did
<?php
use TotalVoiceClient as TotalVoiceClient;
use TotalVoiceApiChamada;
$client = new TotalVoiceClient('access-token');
$didId = "11";
$uraId = null;
$response = $client->did->atualizar($idDid, $ramalId, $uraId);Deletando um did
<?php
use TotalVoiceClient as TotalVoiceClient;
use TotalVoiceApiChamada;
$client = new TotalVoiceClient('access-token');
$didId = "11";
$response = $client->did->excluir($didId);Listando seus dids
<?php
use TotalVoiceClient as TotalVoiceClient;
use TotalVoiceApiChamada;
$client = new TotalVoiceClient('access-token');
$response = $client->did->lista();Mais informações sobre os métodos disponíveis podem ser encontrados na documentação da API
Contribua!
Quer contribuir? clique aqui
Licença
Esta biblioteca segue os termos de uso da MIT
