PHPackages vitorccs/takeblip-php - 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. [API Development](/categories/api) 4. / 5. vitorccs/takeblip-php ActiveLibrary[API Development](/categories/api) vitorccs/takeblip-php ===================== SDK PHP para a API WhatsApp da Take Blip v1.2.0(2y ago)21.0kGPL-3.0PHPPHP >=8.1 Since Sep 2Pushed 2y ago1 watchersCompare [ Source](https://github.com/vitorccs/takeblip-php)[ Packagist](https://packagist.org/packages/vitorccs/takeblip-php)[ Docs](https://github.com/vitorccs/takeblip-php)[ RSS](/packages/vitorccs-takeblip-php/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (2)Dependencies (3)Versions (5)Used By (0) Take Blip - SDK PHP =================== [](#take-blip---sdk-php) SDK PHP para a API de Notificações WhatsApp da Take Blip Requisitos ---------- [](#requisitos) - PHP >= 8.1 Descrição --------- [](#descrição) SDK PHP para a [API de Notificações WhatsApp da Take Blip](https://docs.blip.ai/#whatsapp). Instalação ---------- [](#instalação) Via Composer ``` composer require vitorccs/takeblip-php ``` Parâmetros ---------- [](#parâmetros) ParâmetroObrigatórioPadrãoComentárioTAKEBLIP\_API\_KEYSimnullToken de acesso da APITAKEBLIP\_API\_TIMEOUTNão20Timeout em segundos para estabelecer conexão com a APIComo usar --------- [](#como-usar) 1. Os parâmetros podem ser definidos por variáveis de ambiente: ``` putenv('TAKEBLIP_API_KEY=myApiKey'); putenv('TAKEBLIP_API_TIMEOUT=20'); ``` ou passados como argumento de instância: ``` new \TakeBlip\TakeBlip($token, $timeout); ``` 2. Em seguida, basta solicitar os endpoints: ``` $takeBlip = new \TakeBlip\TakeBlip(); // Obter Templates de Mensagens $response = $takeBlip->getMessageTemplates(); // Obter Identificador do usuário (altere este número) $response = $takeBlip->getUserIdentity('551190000000'); // Enviar Notificação Ativa $takeBlip->sendNotification($pictureTemplate); // Consultar os eventos da Notificação disparada $takeBlip->getNotificationEvents('myNotificationId'); ``` Tratamento de erros ------------------- [](#tratamento-de-erros) Esta biblioteca lança as seguintes exceções: - `HttpClientException` para erros HTTP 4xx - `HttpServerException` para erros HTTP 5xx Importante: como a API da Take Blip sempre retorna código HTTP 2xx (sucesso) mesmo quando ela não foi bem-sucedida, foi implementando um tratamento que verifica o corpo da resposta, e caso encontre o valor "failure", ele lançará uma exceção do tipo `HttpClientException`. Exemplo de corpo da resposta: ``` { "method": "get", "status": "failure", "reason": { "code": 61, "description": "The string supplied did not seem to be a phone number." } } ``` Exemplo de implementação ------------------------ [](#exemplo-de-implementação) ``` error_reporting(E_ALL); ini_set('display_errors', 1); require __DIR__.'/vendor/autoload.php'; putenv('TAKEBLIP_API_KEY=myApiKey'); use TakeBlip\Exceptions\HttpClientException; use TakeBlip\Exceptions\HttpServerException; try { $takeBlip = new \TakeBlip\TakeBlip(); # Step 1/4 - Obter Identificador do usuário $response = $takeBlip->getUserIdentity('551190000000'); $userIdentity = $response->resource->identity; # Step 2/4 - Construir o Template da Mensagem $builder = new \TakeBlip\Builders\TemplateBuilder(); $template = $builder ->create('user_identity', 'my_template_name', 'my_template_namespace') ->addVariable('MyVar1') ->addVariable('MyVar2') ->addReply('QuickReply1') ->addReply('QuickReply2') ->setUrl('https://www.domain.com/boleto.pdf', 'document', 'BoletoBancario.pdf') ->get(); # Step 3/4 - Enviar Notificação Ativa $takeBlip->sendNotification($template); # Step 4/4 - Consultar os eventos da Notificação (opcional) // Esta consulta não deveria ser feita imediatamente após o disparo // e os eventos podem levar vários minutos para chegarem sleep(5); // apenas para fins de teste $response = $takeBlip->getNotificationEvents($template->id); print_r($response); } catch (HttpClientException $e) { // erros de cliente (HTTP 4xx) echo sprintf('Client: %s (%s)', $e->getMessage(), $e->getHttpCode()); } catch (HttpServerException $e) { // erros de servidor (HTTP 5xx) echo sprintf('Server: %s (%s)', $e->getMessage(), $e->getHttpCode()); } catch (\Exception $e) { // demais erros echo $e->getMessage(); } ``` Aviso ----- [](#aviso) O template da mensagem precisa estar em acordo com o template aprovado no WhatsApp. Para diminuir o riscos de erros, foi implementado o construtor de templates `TemplateBuilder`. Contudo, ele não será capaz de identificar determinados erros: - Dados inválidos para Identity, Nome de template ou Namespace - O template possui URL e esta não foi fornecida ou apresenta falha - A quantidade de Variáveis ou Quick Replies está incorreta - Definir URL, Variável ou Quick Reply sem o template possuir Os erros mencionados acima não conseguem ser detectados pela API Take Blip no momento do disparo, que irá disparar como sucesso (HTTP 2xx). Somente poderá ser identificado consultando o endpoint `getNotificationEvents`. Testes ------ [](#testes) Caso queira contribuir, por favor, implementar testes de unidade em PHPUnit. Para executar: 1. Faça uma cópia de phpunit.xml.dist em phpunit.xml na raíz do projeto 2. Execute o comando abaixo no terminal dentro da pasta deste projeto: ``` composer test ``` Anexos ------ [](#anexos) - [Tutorial Notificações WhatsApp da Take Blip](https://help.blip.ai/hc/pt-br/articles/360057514334-Como-enviar-notifica%C3%A7%C3%B5es-WhatsApp-via-API-do-Blip) ### Health Score 31 — LowBetter than 68% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity20 Limited adoption so far Community7 Small or concentrated contributor base Maturity62 Established project with proven stability 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 ~251 days Total 4 Last Release 966d ago PHP version history (2 changes)v1.0.0PHP >=7.4 v1.1.0PHP >=8.1 ### Community Maintainers ![](https://www.gravatar.com/avatar/2d5d2e771a97ac9dc5a1a1c8a18ec3cf97b5ea7872bfbc0fd62b060545cf6dfa?d=identicon)[vitorccs](/maintainers/vitorccs) --- Top Contributors [![vitorccs](https://avatars.githubusercontent.com/u/9891961?v=4)](https://github.com/vitorccs "vitorccs (13 commits)") --- Tags whatsapptakebliptake blip ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/vitorccs-takeblip-php/health.svg) ``` [![Health](https://phpackages.com/badges/vitorccs-takeblip-php/health.svg)](https://phpackages.com/packages/vitorccs-takeblip-php) ``` ### Alternatives [sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.4k5.6M651](/packages/sylius-sylius)[wheelpros/fitment-platform-api Magento 2 (Open Source) 12.1k1.2k](/packages/wheelpros-fitment-platform-api)[commercetools/commercetools-sdk The official PHP SDK for the commercetools Composable Commerce APIs 19281.5k](/packages/commercetools-commercetools-sdk)[scriptdevelop/whatsapp-manager Paquete para manejo de WhatsApp Business API en Laravel 762.6k](/packages/scriptdevelop-whatsapp-manager)[jhowbhz/package-apigratis Uma forma simples de consumir serviços gratuitos oferecidos pelo site https://apigratis.com.br/ 505.2k](/packages/jhowbhz-package-apigratis)[exinone/mixin-sdk-php Mixin-Network SDK for PHP, modify from ExinOne/laravel-mixin-sdk 242.5k4](/packages/exinone-mixin-sdk-php) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)