PHPackages andreshg112/hablame-sms - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [HTTP & Networking](/categories/http) 4. / 5. andreshg112/hablame-sms AbandonedArchivedLibrary[HTTP & Networking](/categories/http) andreshg112/hablame-sms ======================= Cliente para comunicarse con la API para SMS de Háblame Colombia. v1.0.1(5y ago)92033MITPHPPHP ^7.1 Since Jun 25Pushed 4y ago1 watchersCompare [ Source](https://github.com/andreshg112/hablame-sms)[ Packagist](https://packagist.org/packages/andreshg112/hablame-sms)[ Docs](https://github.com/andreshg112/hablame-sms)[ RSS](/packages/andreshg112-hablame-sms/feed)WikiDiscussions master Synced yesterday READMEChangelog (2)Dependencies (6)Versions (3)Used By (0) Cliente de Háblame SMS (Colombia) para PHP (Optimizado para Laravel) ==================================================================== [](#cliente-de-háblame-sms-colombia-para-php-optimizado-para-laravel) [![Latest Version on Packagist](https://camo.githubusercontent.com/3f24569a95e1e3adc09448e558714e72f3dcc3b8a6fb0aef61fbb031f2f55baf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f616e6472657368673131322f6861626c616d652d736d732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/andreshg112/hablame-sms)[![Build Status](https://camo.githubusercontent.com/75fc943244d482003d34fb7de4c7984be2e62b990b4a50251c565c0d057069c4/68747470733a2f2f7472617669732d63692e636f6d2f616e6472657368673131322f6861626c616d652d736d732e7376673f6272616e63683d6d6173746572)](https://travis-ci.com/andreshg112/hablame-sms)[![StyleCI](https://camo.githubusercontent.com/30dda07a867571178557e0893d6a64852032dda41387cfa628ac2e58afd8d778/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3138313830363034322f736869656c643f6272616e63683d6d6173746572)](https://github.styleci.io/repos/181806042)[![Quality Score](https://camo.githubusercontent.com/2db4615a16ec4ae980d723ba2c571467030b0f63bf952c0070bf3a2848167847/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f616e6472657368673131322f6861626c616d652d736d732e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/andreshg112/hablame-sms)[![Code Coverage](https://camo.githubusercontent.com/3178cc054fb844500a55ce556646071e07712fe9cd847f0e8ead79e7fa12c3f9/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f616e6472657368673131322f6861626c616d652d736d732f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/andreshg112/hablame-sms/?branch=master)[![Maintainability](https://camo.githubusercontent.com/b47f03dc6243b356adb66cb195b703f0421e09b3e8ec3edec807e726877126cb/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f30653766653939386132336266333665633936332f6d61696e7461696e6162696c697479)](https://codeclimate.com/github/andreshg112/hablame-sms/maintainability)[![Total Downloads](https://camo.githubusercontent.com/fd5b2223e74f9837dabdd7a858bf9614ad32d82a57b9ae50d7b7235fafdfbd72/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f616e6472657368673131322f6861626c616d652d736d732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/andreshg112/hablame-sms) Este paquete facilita la conexión con la API de [Háblame SMS](https://www.hablame.co) para enviar mensajes de texto y consultar el saldo. Además, permite el envío de notificaciones a través de SMS usando el [sistema de notificaciones de Laravel](https://laravel.com/docs/5.5/notifications). Requerimientos -------------- [](#requerimientos) - PHP >= 7.1 - Laravel >= 5.3 (Requerido solo si vas a usar la fachada o el canal de notificaciones). Instalación ----------- [](#instalación) Puedes instalar el paquete a través de composer: ``` composer require andreshg112/hablame-sms ``` Uso --- [](#uso) ``` /** * Crear instancia. * * $client: Número de cliente. * $api: Clave de la API. * $guzzle: [opcional] Sirve para pasar un cliente de Guzzle (\GuzzleHttp\Client) configurado, * por ejemplo, en pruebas unitarias. */ $hablame = new \Andreshg112\HablameSms\Client($client, $api, $guzzle); /** * Consultar saldo. * * Retorna un array con la respuesta del servidor de Háblame. */ $response = $hablame->checkBalance(); /** * Enviar mensaje. * * $phoneNumbers: Número(s) telefónico(s) separados por coma. * $sms: Cuerpo del mensaje. * $datetime: [opcional] Fecha a enviar el mensaje. Formato en PHP: 'Y-m-d H:i:s' * $referencia: [opcional] Nombre de campaña. * * Retorna un array con la respuesta del servidor de Háblame. */ $response = $hablame->sendMessage($phoneNumbers, $sms, $datetime, $reference); ``` ### Laravel [](#laravel) #### Fachada y alias [](#fachada-y-alias) En Laravel puedes usar la fachada o el alias para ejecutar las funciones anteriores. Primero debes agregar las credenciales de Háblame a `config/services.php` así: ``` return [ // ... 'hablame_sms' => [ 'api' => env('HABLAME_API', ''), 'cliente' => env('HABLAME_CLIENTE', ''), /** * Si deseas agregar tu propio cliente de Guzzle, en vez de usar uno por defecto, * haz que el callback retorne el respectivo cliente. * Si quieres usar uno por defecto, quita este parámetro o asígnalo null. */ 'guzzle' => function (): \GuzzleHttp\Client { return createHttpClient(logger()); }, ], // ... ]; ``` Ahora puedes hacer: ``` $response = \Andreshg112\HablameSms\Facade::checkBalance(); $response = \Andreshg112\HablameSms\Facade::sendMessage($phoneNumbers, $sms, $datetime, $reference); // o $response = \Hablame::checkBalance(); $response = \Hablame::sendMessage($phoneNumbers, $sms, $datetime, $reference); ``` > Si usas Laravel < 5.5, debes agregar `\Andreshg112\HablameSms\HablameSmsServiceProvider::class` al arreglo de `providers` en `config/app.php`. #### Notificaciones [](#notificaciones) Puedes enviar notificaciones usando el [sistema integrado en Laravel](https://laravel.com/docs/5.5/notifications) que facilita el proceso y organiza el código. Ten en cuenta que debes saber implementar las [notificaciones de Laravel](https://code.tutsplus.com/es/tutorials/notifications-in-laravel--cms-30499) antes de usar esta funcionalidad. En tu notificación, añade `HablameChannel::class` al array que retorna la función `via()`: ``` use Andreshg112\HablameSms\HablameChannel; public function via($notifiable) { return [HablameChannel::class]; } ``` Luego, crea un método llamado `toHablameNotification()` en tu clase: ``` use Andreshg112\HablameSms\HablameMessage; public function toHablameNotification($notifiable) { return (new HablameMessage) ->phoneNumbers($phoneNumbers) ->sms($sms) ->datetime($datetime) ->reference($reference); // o return new HablameMessage($phoneNumbers, $sms, $datetime, $reference); } ``` ### Pruebas [](#pruebas) ``` composer test ``` ### Registro de cambios [](#registro-de-cambios) Por favor mira el historial de [versiones](../../releases) para más información sobre lo que ha cambiado recientemente. Contribuir ---------- [](#contribuir) Por favor mira las [guías de contribución](CONTRIBUTING.md) (en inglés) para conocer los detalles. ### Seguridad [](#seguridad) Si descubres alguna vulnerabilidad, por favor escríbeme a en vez de usar el [seguimiento de indicendias](../../issues) de GitHub. Créditos -------- [](#créditos) - [Andrés Herrera García](https://github.com/andreshg112) - [Todos los colaboradores](../../contributors) Licencia -------- [](#licencia) La Licencia MIT. Por favor mira el [archivo de licencia](LICENSE.md) para más información. PHP Package Boilerplate ----------------------- [](#php-package-boilerplate) This package was generated using the [PHP Package Boilerplate](https://laravelpackageboilerplate.com). ### Health Score 29 — LowBetter than 60% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity19 Limited adoption so far Community9 Small or concentrated contributor base Maturity55 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~334 days Total 2 Last Release 2179d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/5035725cb99badcda1bac670e2ec5808d31ff98c9144e278fbff399fed1bb594?d=identicon)[andreshg112](/maintainers/andreshg112) --- Top Contributors [![andreshg112](https://avatars.githubusercontent.com/u/15859884?v=4)](https://github.com/andreshg112 "andreshg112 (29 commits)") --- Tags andreshg112hablame-sms ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/andreshg112-hablame-sms/health.svg) ``` [![Health](https://phpackages.com/badges/andreshg112-hablame-sms/health.svg)](https://phpackages.com/packages/andreshg112-hablame-sms) ``` ### Alternatives [spatie/crawler Crawl all internal links found on a website 2.8k16.3M52](/packages/spatie-crawler)[omniphx/forrest A Laravel library for Salesforce 2724.4M8](/packages/omniphx-forrest)[akamai-open/edgegrid-client Implements the Akamai {OPEN} EdgeGrid Authentication specified by https://developer.akamai.com/introduction/Client\_Auth.html 482.5M6](/packages/akamai-open-edgegrid-client)[muhammadhuzaifa/telescope-guzzle-watcher Telescope Guzzle Watcher provide a custom watcher for intercepting http requests made via guzzlehttp/guzzle php library. The package uses the on\_stats request option for extracting the request/response data. The watcher intercept and log the request into the Laravel Telescope HTTP Client Watcher. 98239.8k1](/packages/muhammadhuzaifa-telescope-guzzle-watcher)[onesignal/onesignal-php-api A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com 34170.2k2](/packages/onesignal-onesignal-php-api)[ory/hydra-client-php Documentation for all of Ory Hydra's APIs. 1710.8k](/packages/ory-hydra-client-php) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)