{"id":13405012,"url":"https://github.com/totalvoice/totalvoice-php","last_synced_at":"2026-01-11T12:54:05.992Z","repository":{"id":47465432,"uuid":"108917980","full_name":"totalvoice/totalvoice-php","owner":"totalvoice","description":"Client em PHP para API da Totalvoice","archived":false,"fork":false,"pushed_at":"2021-08-30T19:33:22.000Z","size":110,"stargazers_count":29,"open_issues_count":0,"forks_count":15,"subscribers_count":13,"default_branch":"master","last_synced_at":"2024-09-22T08:16:01.365Z","etag":null,"topics":["api","audio","chamadas","conferencia","ramais","rest","sms","totalvoice","tts","ura"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/totalvoice.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-10-30T23:03:52.000Z","updated_at":"2023-03-25T13:38:52.000Z","dependencies_parsed_at":"2022-08-24T13:20:45.340Z","dependency_job_id":null,"html_url":"https://github.com/totalvoice/totalvoice-php","commit_stats":null,"previous_names":[],"tags_count":47,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/totalvoice%2Ftotalvoice-php","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/totalvoice%2Ftotalvoice-php/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/totalvoice%2Ftotalvoice-php/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/totalvoice%2Ftotalvoice-php/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/totalvoice","download_url":"https://codeload.github.com/totalvoice/totalvoice-php/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243554157,"owners_count":20309873,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","audio","chamadas","conferencia","ramais","rest","sms","totalvoice","tts","ura"],"created_at":"2024-07-30T19:01:54.527Z","updated_at":"2026-01-11T12:54:05.936Z","avatar_url":"https://github.com/totalvoice.png","language":"PHP","funding_links":[],"categories":["PHP"],"sub_categories":[],"readme":"# totalvoice-php\nCliente em PHP para API da Totalvoice\n\n[![Build Status](https://travis-ci.org/totalvoice/totalvoice-php.svg?style=flat-square)](http://travis-ci.org/#!/totalvoice/totalvoice-php)\n[![Packagist](https://img.shields.io/packagist/v/total-voice/php-client.svg?style=flat-square)](https://github.com/totalvoice/totalvoice-php)\n\n\u003e ### Funcionalidades\n\n- Gerenciamento das chamadas\n- Consulta e envio de SMS\n- Consulta e envio de TTS\n- Consulta e envio de Audio\n- Consulta e envio de Composto\n- Consulta e envio de Conferência\n- Gerenciamento da Conta\n- Gerenciamento da Central\n- Gerenciamento de DID\n\n\u003e ### Requisitos\n\n- PHP 5.5+\n- Autoloader compatível com a PSR-4\n- PHP deve estar compilado com a lib-curl\n\n\u003e ### Instalação\n\nPara instalar a biblioteca basta adicioná-la via [composer](https://getcomposer.org/download/)\n\n```composer\ncomposer require total-voice/php-client 1.*\n```\n\nOu no composer.json\n\n```json\n{\n    \"total-voice/php-client\": \"1.*\"\n}\n```\n\n\u003e ### Testes\n\nPodemos usar o composer para rodar os testes:\n\n```composer\ncomposer test\n```\nou utilizando o .phar\n\n```composer\nphp composer.phar test\n```\n\n\u003e ### Utilização\n\nPara utilizar esta biblioteca, primeiramente você deverá realizar um cadastro no site da [Total Voice](http://www.totalvoice.com.br).\nApós a criação do cadastro será disponibilizado um AccessToken para acesso a API.\n\nCom o AccessToken em mãos será possível realizar as consultas/cadastros conforme documentação da [API](https://api.totalvoice.com.br/doc/#/)\n\nOs métodos da API que poderão ser invocados:\n- audio\n- central\n- chamada\n- composto\n- conferencia\n- conta\n- perfil\n- sms\n- tts\n\nA seguir um pequeno exemplo de como pode ser utilizada esta biblioteca.\n\n\u003e ##### Realiza uma chamada telefônica entre dois números: A e B\n\n```php\n\u003c?php\n// Consideramos que já existe um autoloader compatível com a PSR-4 registrado\n\nuse TotalVoice\\Client as TotalVoiceClient;\n\n$client = new TotalVoiceClient('access-token');\n$response = $client-\u003echamada-\u003eligar('NUMERO-A', 'NUMERO-B');\n\necho $response-\u003egetContent();\n\n```\n\n\u003e ##### Consulta de chamada pelo ID\n\n```php\n\u003c?php\n// Considero que já existe um autoloader compatível com a PSR-4 registrado\n\nuse TotalVoice\\Client as TotalVoiceClient;\n\n$client = new TotalVoiceClient('access-token');\n$response = $client-\u003echamada-\u003ebuscaChamada('ID_CHAMADA');\n\necho $response-\u003egetContent(); // {}\n\n```\n\n\n\u003e ##### Encerra uma chamada ativa\n\n```php\n\u003c?php\n// Considero que já existe um autoloader compatível com a PSR-4 registrado\n\nuse TotalVoice\\Client as TotalVoiceClient;\n\n$client = new TotalVoiceClient('access-token');\n$response = $client-\u003echamada-\u003eencerrar('ID_CHAMADA');\n\necho $response-\u003egetContent(); // {}\n\n```\n\n\u003e ##### Envio de SMS\n\n```php\n\u003c?php\n// Considero que já existe um autoloader compatível com a PSR-4 registrado\n\nuse TotalVoice\\Client as TotalVoiceClient;\n\n$client = new TotalVoiceClient('access-token');\n$response = $client-\u003esms-\u003eenviar('NUMERO-DESTINO', 'SUA MENSAGEM');\n\necho $response-\u003egetContent(); // {}\n    \n```\n\n\u003e ##### Envio de TTS\n\n```php\n\u003c?php\n// Considero que já existe um autoloader compatível com a PSR-4 registrado\n\nuse TotalVoice\\Client as TotalVoiceClient;\n\n$client = new TotalVoiceClient('access-token');\n$response = $client-\u003etts-\u003eenviar('NUMERO-DESTINO', 'SUA MENSAGEM');\n\necho $response-\u003egetContent(); // {}\n    \n```\n\n\u003e ##### Envio de Audio\n\n```php\n\u003c?php\n// Considero que já existe um autoloader compatível com a PSR-4 registrado\n\nuse TotalVoice\\Client as TotalVoiceClient;\n\n$client = new TotalVoiceClient('access-token');\n$response = $client-\u003eaudio-\u003eenviar('NUMERO-DESTINO', 'SUA MENSAGEM');\n\necho $response-\u003egetContent(); // {}\n\n```\n\n\u003e ##### Configurações de central telefonica\n\n```php\n\u003c?php\n// Considero que já existe um autoloader compatível com a PSR-4 registrado\n\nuse TotalVoice\\Client as TotalVoiceClient;\n    \n$client = new TotalVoiceClient('access-token');\n$response = $client-\u003ecentral-\u003ebuscaRamal('ID-RAMAL');\n\necho $response-\u003egetContent(); // {}\n    \n```\n\n\u003e ##### Gerenciamento dos dados da Conta\n\n```php\n\u003c?php\n// Considero que já existe um autoloader compatível com a PSR-4 registrado\n\nuse TotalVoice\\Client as TotalVoiceClient;\n\n$client = new TotalVoiceClient('access-token');\n$response = $client-\u003econta-\u003ebuscaConta('ID_CONTA');\n\necho $response-\u003egetContent(); // {}\n\n```\n\n\u003e ##### Consulta saldo da Minha Conta\n\n```php\n\u003c?php\n// Considero que já existe um autoloader compatível com a PSR-4 registrado\n\nuse TotalVoice\\Client as TotalVoiceClient;\n\n$client = new TotalVoiceClient('access-token');\n$response = $client-\u003eperfil-\u003econsultaSaldo();\n\necho $response-\u003egetContent(); // {}\n\n```\n\n\u003e ##### Todas as classes da API podem ser instânciadas separadamente também\n\n```php\n\u003c?php\n// Consideramos que já existe um autoloader compatível com a PSR-4 registrado\n\nuse TotalVoice\\Client as TotalVoiceClient;\nuse TotalVoice\\Api\\Chamada;\n\n$client = new TotalVoiceClient('access-token');\n$service = new Chamada($client);\n$response = $service-\u003eligar('NUMERO-A', 'NUMERO-B');\n\necho $response-\u003egetContent();\n\n```\n\n\u003e ##### Caso você utilize um Client personalizado\n\n```php\n\u003c?php\n// Consideramos que já existe um autoloader compatível com a PSR-4 registrado\n\nuse TotalVoice\\Api\\Chamada;\n\nclass MeuClient implements ClientInterface \n{\n\n}\n\n$meuclient = new MeuClient('access-token');\n$service = new Chamada($meuclient);\n$response = $service-\u003eligar('NUMERO-A', 'NUMERO-B');\n\n```\n\n\u003e ##### Caso você necessite utilizar seu próprio endereço configurado na Total Voice\n\n```php\n\u003c?php\n// Consideramos que já existe um autoloader compatível com a PSR-4 registrado\n\nuse TotalVoice\\Client as TotalVoiceClient;\nuse TotalVoice\\Api\\Chamada;\n\n$client = new TotalVoiceClient('access-token', 'https://meuhost.com.br');\n$service = new Chamada($client);\n$response = $service-\u003eligar('NUMERO-A', 'NUMERO-B');\n\n```\n\u003e #### Listando dids no estoque\n\n```php\n\u003c?php\n\nuse TotalVoice\\Client as TotalVoiceClient;\nuse TotalVoice\\Api\\Chamada;\n\n$client = new TotalVoiceClient('access-token');\n$response = $client-\u003edid-\u003elistaEstoque();\n\n```\n\n\u003e #### Adquirindo um did\n\n```php\n\u003c?php\n\nuse TotalVoice\\Client as TotalVoiceClient;\nuse TotalVoice\\Api\\Chamada;\n\n$client = new TotalVoiceClient('access-token');\n$idDid = \"10\";\n$response = $client-\u003edid-\u003eadquirir($idDid);\n\n```\n\n\u003e #### Editando um did\n\n```php\n\u003c?php\n\nuse TotalVoice\\Client as TotalVoiceClient;\nuse TotalVoice\\Api\\Chamada;\n\n$client = new TotalVoiceClient('access-token');\n$didId = \"11\";\n$uraId = null;\n$response = $client-\u003edid-\u003eatualizar($idDid, $ramalId, $uraId);\n\n```\n\n\u003e #### Deletando um did\n\n```php\n\u003c?php\n\nuse TotalVoice\\Client as TotalVoiceClient;\nuse TotalVoice\\Api\\Chamada;\n\n$client = new TotalVoiceClient('access-token');\n$didId = \"11\";\n$response = $client-\u003edid-\u003eexcluir($didId);\n\n```\n\n\u003e #### Listando seus dids\n\n```php\n\u003c?php\n\nuse TotalVoice\\Client as TotalVoiceClient;\nuse TotalVoice\\Api\\Chamada;\n\n$client = new TotalVoiceClient('access-token');\n$response = $client-\u003edid-\u003elista();\n```\n\n\nMais informações sobre os métodos disponíveis podem ser encontrados na documentação da [API](https://api.totalvoice.com.br/doc/#/)\n\n\u003e ### Contribua!\n\nQuer contribuir? [clique aqui](https://github.com/totalvoice/totalvoice-php/blob/master/CONTRIBUTING.md)\n\n\u003e ### Licença\n\nEsta biblioteca segue os termos de uso da [MIT](https://github.com/totalvoice/totalvoice-php/blob/master/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftotalvoice%2Ftotalvoice-php","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftotalvoice%2Ftotalvoice-php","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftotalvoice%2Ftotalvoice-php/lists"}