Cliente PHP para TotalVoice API
Funcionalidad
Requisitos
Instalación
Para instalar la biblioteca, solo agrégala a través del compositor
composer require total-voice/php-client 1.*
O ningún compositor.json
{
"total-voice/php-client" : " 1.* "
}Pruebas
Podemos usar el compositor para ejecutar las pruebas:
composer test
o usando el.
php composer.phar test
Usar
Para usar esta biblioteca, primero debe registrarse en el sitio web de Total Voice. Después de la creación del registro, estará disponible un accessostoken para acceder a la API.
Con AccessSstoken en la mano, será posible hacer las consultas/registros de acuerdo con la documentación de la API
Métodos API que se pueden invocar:
Luego, un pequeño ejemplo de cómo se puede usar esta biblioteca.
Hace una llamada telefónica entre dos números: A y B
<?php
// Consideramos que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoice Client as TotalVoiceClient ;
$ client = new TotalVoiceClient ( ' access-token ' );
$ response = $ client -> chamada -> ligar ( ' NUMERO-A ' , ' NUMERO-B ' );
echo $ response -> getContent ();Consulta de llamadas por identificación
<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoice Client as TotalVoiceClient ;
$ client = new TotalVoiceClient ( ' access-token ' );
$ response = $ client -> chamada -> buscaChamada ( ' ID_CHAMADA ' );
echo $ response -> getContent (); // {} Cierra una llamada activa
<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoice Client as TotalVoiceClient ;
$ client = new TotalVoiceClient ( ' access-token ' );
$ response = $ client -> chamada -> encerrar ( ' ID_CHAMADA ' );
echo $ response -> getContent (); // {} Envío de SMS
<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoice Client as TotalVoiceClient ;
$ client = new TotalVoiceClient ( ' access-token ' );
$ response = $ client -> sms -> enviar ( ' NUMERO-DESTINO ' , ' SUA MENSAGEM ' );
echo $ response -> getContent (); // {}
Envío TTS
<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoice Client as TotalVoiceClient ;
$ client = new TotalVoiceClient ( ' access-token ' );
$ response = $ client -> tts -> enviar ( ' NUMERO-DESTINO ' , ' SUA MENSAGEM ' );
echo $ response -> getContent (); // {}
Envío de audio
<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoice Client as TotalVoiceClient ;
$ client = new TotalVoiceClient ( ' access-token ' );
$ response = $ client -> audio -> enviar ( ' NUMERO-DESTINO ' , ' SUA MENSAGEM ' );
echo $ response -> getContent (); // {} Configuración telefónica central
<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoice Client as TotalVoiceClient ;
$ client = new TotalVoiceClient ( ' access-token ' );
$ response = $ client -> central -> buscaRamal ( ' ID-RAMAL ' );
echo $ response -> getContent (); // {}
Gestión de datos de cuenta
<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoice Client as TotalVoiceClient ;
$ client = new TotalVoiceClient ( ' access-token ' );
$ response = $ client -> conta -> buscaConta ( ' ID_CONTA ' );
echo $ response -> getContent (); // {} Saldo saldo mi cuenta
<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoice Client as TotalVoiceClient ;
$ client = new TotalVoiceClient ( ' access-token ' );
$ response = $ client -> perfil -> consultaSaldo ();
echo $ response -> getContent (); // {} Todas las clases de API también se pueden instalar por separado
<?php
// Consideramos que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoice Client as TotalVoiceClient ;
use TotalVoice Api Chamada ;
$ client = new TotalVoiceClient ( ' access-token ' );
$ service = new Chamada ( $ client );
$ response = $ service -> ligar ( ' NUMERO-A ' , ' NUMERO-B ' );
echo $ response -> getContent ();Si usa un cliente personalizado
<?php
// Consideramos que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoice Api Chamada ;
class MeuClient implements ClientInterface
{
}
$ meuclient = new MeuClient ( ' access-token ' );
$ service = new Chamada ( $ meuclient );
$ response = $ service -> ligar ( ' NUMERO-A ' , ' NUMERO-B ' );Si necesita usar su propia dirección configurada con voz total
<?php
// Consideramos que já existe um autoloader compatível com a PSR-4 registrado
use TotalVoice Client as TotalVoiceClient ;
use TotalVoice Api Chamada ;
$ client = new TotalVoiceClient ( ' access-token ' , ' https://meuhost.com.br ' );
$ service = new Chamada ( $ client );
$ response = $ service -> ligar ( ' NUMERO-A ' , ' NUMERO-B ' );Listado DIDS en stock
<?php
use TotalVoice Client as TotalVoiceClient ;
use TotalVoice Api Chamada ;
$ client = new TotalVoiceClient ( ' access-token ' );
$ response = $ client -> did -> listaEstoque ();Adquiriendo un
<?php
use TotalVoice Client as TotalVoiceClient ;
use TotalVoice Api Chamada ;
$ client = new TotalVoiceClient ( ' access-token ' );
$ idDid = " 10 " ;
$ response = $ client -> did -> adquirir ( $ idDid );Editar un hecho
<?php
use TotalVoice Client as TotalVoiceClient ;
use TotalVoice Api Chamada ;
$ client = new TotalVoiceClient ( ' access-token ' );
$ didId = " 11 " ;
$ uraId = null ;
$ response = $ client -> did -> atualizar ( $ idDid , $ ramalId , $ uraId );Eliminar un hecho
<?php
use TotalVoice Client as TotalVoiceClient ;
use TotalVoice Api Chamada ;
$ client = new TotalVoiceClient ( ' access-token ' );
$ didId = " 11 " ;
$ response = $ client -> did -> excluir ( $ didId );Enumerando a sus dudas
<?php
use TotalVoice Client as TotalVoiceClient ;
use TotalVoice Api Chamada ;
$ client = new TotalVoiceClient ( ' access-token ' );
$ response = $ client -> did -> lista ();Puede encontrar más información sobre los métodos disponibles en la documentación de la API
¡Contribuir!
¿Quieres contribuir? haga clic aquí
Licencia
Esta biblioteca sigue los términos de uso del MIT