PHPackages                             sendzap/laravel-sdk - 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. sendzap/laravel-sdk

ActiveLibrary[API Development](/categories/api)

sendzap/laravel-sdk
===================

A Laravel SDK to interact with the SendZap WhatsApp API.

v1.1.0(2d ago)00MITPHPPHP ^8.1CI passing

Since Jun 28Pushed yesterdayCompare

[ Source](https://github.com/usesendzap/sendzap-laravel)[ Packagist](https://packagist.org/packages/sendzap/laravel-sdk)[ Docs](https://github.com/UBUNTU-INOV/sendzap-laravel)[ RSS](/packages/sendzap-laravel-sdk/feed)WikiDiscussions main Synced yesterday

READMEChangelogDependencies (7)Versions (3)Used By (0)

 [![SendZap Laravel SDK](art/logo_sendzap.png)](art/logo_sendzap.png)

SendZap Laravel SDK
===================

[](#sendzap-laravel-sdk)

[![Latest Version on Packagist](https://camo.githubusercontent.com/e157f4f99dbc006cb59e39558d003d190b022fe6228b765b7cde69c9a1774348/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f73656e647a61702f6c61726176656c2d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sendzap/laravel-sdk)[![Total Downloads](https://camo.githubusercontent.com/91e85934cc5991ab4c4e0ad3e9dbd9279b1be4fe41bfe4d08d29a8cca965281d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f73656e647a61702f6c61726176656c2d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sendzap/laravel-sdk)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)

A clean and powerful Laravel SDK to interact with the **SendZap WhatsApp API**. Effortlessly manage instances, send text, media, bulk messages, buttons, and carousels directly from your Laravel application.

Requirements
------------

[](#requirements)

- PHP 8.1+
- Laravel 10, 11, 12, or 13

CI only runs the test suite against Laravel 12 and 13, since 10 and 11 are past their official security-support window and have no patched `laravel/framework` release to test against. The SDK itself only depends on `illuminate/support` (service container, facades), not the routing/validation layer affected by those advisories, so it should keep working fine on 10/11 — just without automated coverage.

---

Installation and Usage
----------------------

[](#installation-and-usage)

Installation
------------

[](#installation)

Install with Composer:

```
composer require sendzap/laravel-sdk

```

Usage
-----

[](#usage)

After publishing config and setting `api_key` and `default_instance_id`, use the facade or contract:

```
use Sendzap\Laravel\Facades\Sendzap;
// or via constructor injection: Sendzap\Laravel\Contracts\SendzapClientContract

Sendzap::sendText('5511999999999', 'Hello world');
```

You can install the package via composer:

```
composer require sendzap/laravel-sdk
```

After installing the package, run the installation command to publish the configuration file and set up your environment variables:

```
php artisan sendzap:install
```

This will:

1. Publish the `config/sendzap.php` configuration file.
2. Append `SENDZAP_API_KEY`, `SENDZAP_BASE_URL`, and `SENDZAP_DEFAULT_INSTANCE_ID` to your `.env` file.

---

Configuration
-------------

[](#configuration)

Add your API Key and default Instance ID to your `.env` file:

```
SENDZAP_API_KEY=your_api_key_here
SENDZAP_BASE_URL=https://api.sendzap.click/api/v1
SENDZAP_DEFAULT_INSTANCE_ID=your_default_whatsapp_instance_uuid
```

---

Usage
-----

[](#usage-1)

You can use the SDK either via the `Sendzap` Facade or by dependency-injecting the `SendzapClient`.

### 1. Sending Messages

[](#1-sending-messages)

#### Send a Simple Text Message

[](#send-a-simple-text-message)

```
use Sendzap\Laravel\Facades\Sendzap;

$response = Sendzap::sendText('22990000000', 'Hello from SendZap!');
```

#### Send Media (Image, Video, Document, Audio)

[](#send-media-image-video-document-audio)

```
$response = Sendzap::sendMedia(
    to: '22990000000',
    mediaUrl: 'https://example.com/image.png',
    type: 'image',
    caption: 'Check out this image!',
    fileName: 'photo.png' // optional
);
```

#### Send Interactive Buttons

[](#send-interactive-buttons)

```
to: '22990000000',
text: 'Do you agree with the terms?',
buttons: [
    [
        'buttonId' => 'yes_id',
        'buttonText' => ['displayText' => 'Yes, I agree']
    ],
    [
        'buttonId' => 'no_id',
        'buttonText' => ['displayText' => 'No']
    ]
],
footer: 'SendZap Interactive Buttons' // optional

```

);

```

#### Send a Carousel of Cards
```php
$response = Sendzap::sendCarousel(
    to: '22990000000',
    cards: [
        [
            'imageUrl' => 'https://example.com/item1.png',
            'caption' => 'Product 1',
            'footer' => 'Only $10',
            'buttons' => [
                ['type' => 'url', 'displayText' => 'Buy Now', 'url' => 'https://example.com/buy/1']
            ]
        ],
        [
            'imageUrl' => 'https://example.com/item2.png',
            'caption' => 'Product 2',
            'footer' => 'Only $20',
            'buttons' => [
                ['type' => 'url', 'displayText' => 'Buy Now', 'url' => 'https://example.com/buy/2']
            ]
        ]
    ],
    text: 'Check out our new catalog:',
    footer: 'Special offers'
);

```

#### Send Bulk Messages

[](#send-bulk-messages)

```
$response = Sendzap::sendBulk(
    messages: [
        ['to' => '22990000000', 'message' => 'Hello Alice!'],
        ['to' => '22990000001', 'message' => 'Hello Bob!'],
    ],
    delay: 5000 // Delay in ms between messages (default is handled by API)
);
```

---

### 2. Managing Instances

[](#2-managing-instances)

#### List All Instances

[](#list-all-instances)

```
$instances = Sendzap::listInstances();
```

#### Create a New Instance

[](#create-a-new-instance)

```
$instance = Sendzap::createInstance('My New WhatsApp Business Instance');
```

#### Get Instance Status and Details

[](#get-instance-status-and-details)

```
$details = Sendzap::showInstance('instance-uuid-here');
```

#### Get QR Code (Base64) to scan

[](#get-qr-code-base64-to-scan)

```
$qr = Sendzap::getQr('instance-uuid-here');
// returns base64 image data to display in your frontend
```

#### Disconnect / Logout

[](#disconnect--logout)

```
Sendzap::logoutInstance('instance-uuid-here');
```

---

### 3. Using Multiple Instances Dynamically

[](#3-using-multiple-instances-dynamically)

If your application manages multiple WhatsApp accounts/instances, you can switch the active instance dynamically on the fly:

```
// Switch to a specific instance for the next call
Sendzap::setInstanceId('another-instance-uuid')->sendText('22990000000', 'Dynamic instance message!');
```

---

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance100

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity43

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 ~1 days

Total

2

Last Release

2d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/84053acc89803e485106f220b546026c23cbf85a8f56dbd59e204211dde16c8d?d=identicon)[Sendzap](/maintainers/Sendzap)

---

Top Contributors

[![Block67](https://avatars.githubusercontent.com/u/104683928?v=4)](https://github.com/Block67 "Block67 (8 commits)")

---

Tags

laravelsdkwhatsappsendzap

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/sendzap-laravel-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/sendzap-laravel-sdk/health.svg)](https://phpackages.com/packages/sendzap-laravel-sdk)
```

###  Alternatives

[craftcms/cms

Craft CMS

3.6k3.6M3.1k](/packages/craftcms-cms)[simplestats-io/laravel-client

Analytics for Laravel. Track visitors, registrations, and payments. Discover which channels actually drive revenue, not just traffic. Server-side, GDPR compliant, ad-blocker proof.

5019.3k](/packages/simplestats-io-laravel-client)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)