Download the PHP package vitorccs/takeblip-php without Composer
On this page you can find all versions of the php package vitorccs/takeblip-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package takeblip-php
Take Blip - SDK PHP
SDK PHP para a API de Notificações WhatsApp da Take Blip
Requisitos
- PHP >= 8.1
Descrição
SDK PHP para a API de Notificações WhatsApp da Take Blip.
Instalação
Via Composer
Parâmetros
Parâmetro | Obrigatório | Padrão | Comentário |
---|---|---|---|
TAKEBLIP_API_KEY | Sim | null | Token de acesso da API |
TAKEBLIP_API_TIMEOUT | Não | 20 | Timeout em segundos para estabelecer conexão com a API |
Como usar
1) Os parâmetros podem ser definidos por variáveis de ambiente:
ou passados como argumento de instância:
2) Em seguida, basta solicitar os endpoints:
Tratamento de erros
Esta biblioteca lança as seguintes exceções:
HttpClientException
para erros HTTP 4xxHttpServerException
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:
Exemplo de implementação
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
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:
Anexos
All versions of takeblip-php with dependencies
ext-json Version *
ext-openssl Version *
guzzlehttp/guzzle Version ^6.3.3|^7.0.1
ramsey/uuid Version ^3.7|^4.0