PHPackages                             sejator/waba-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. sejator/waba-sdk

ActiveLibrary[API Development](/categories/api)

sejator/waba-sdk
================

Laravel SDK for WhatsApp Cloud API (WABA)

v1.0.2(1mo ago)04MITPHPPHP >=8.2

Since Feb 7Pushed 1mo agoCompare

[ Source](https://github.com/sejator/waba-sdk)[ Packagist](https://packagist.org/packages/sejator/waba-sdk)[ Docs](https://github.com/sejator/waba-sdk)[ RSS](/packages/sejator-waba-sdk/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (2)Versions (4)Used By (0)

Sejator WABA SDK (Laravel)
==========================

[](#sejator-waba-sdk-laravel)

Laravel-native SDK untuk **WhatsApp Cloud API (WABA)**.

SDK ini dirancang untuk kebutuhan **production & SaaS (Omnichannel / BSP)** dengan fitur lengkap:

- WhatsApp Cloud API (Messaging, Media, Template)
- Embedded Signup (OAuth & Embedded Flow)
- System User & BSP Management
- Credit Line (Billing)
- Webhook Verification & Parsing
- Multi-tenant ready
- Retry, timeout & logging (production-grade)

---

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

[](#requirements)

- PHP >= 8.2
- Laravel 12.x
- Meta (Facebook) Developer Account

---

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

[](#installation)

### Local Development (Path Repository)

[](#local-development-path-repository)

1. Tambahkan repository path di composer.json

```
{
  "repositories": [
    {
      "type": "path",
      "url": "../waba-sdk"
    }
  ],
  "require": {
    "sejator/waba-sdk": "*"
  }
}
```

```
composer update sejator/waba-sdk
```

2. Install package

```
composer require sejator/waba-sdk:*
```

Service Provider & Facade
-----------------------------

[](#service-provider--facade)

Auto-discovery aktif secara default.

Facade:

```
use Waba;
```

Alias:

```
Sejator\WabaSdk\Facades\Waba
```

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

[](#configuration)

Publish Config

```
php artisan vendor:publish \
  --provider="Sejator\WabaSdk\WabaServiceProvider" \
  --tag=waba-config
```

File config:

```
config/waba.php

```

Environment Variables (.env)
----------------------------

[](#environment-variables-env)

```
# Meta App
META_APP_ID=
META_APP_SECRET=

# Graph API
META_GRAPH_URL=https://graph.facebook.com
META_GRAPH_VERSION=v24.0

# OAuth / Embedded Signup
META_OAUTH_BASE_URL=https://www.facebook.com
META_OAUTH_VERSION=v24.0
META_OAUTH_REDIRECT_URI=https://your-domain.com/waba/callback

# Webhook
META_WEBHOOK_VERIFY_TOKEN=

# Default Token (optional)
WABA_TOKEN=

# HTTP Config
WABA_HTTP_TIMEOUT=10
WABA_HTTP_RETRY=3
```

Basic Usage
-----------

[](#basic-usage)

Set Access Token (Multi-tenant)

```
$waba = Waba::withAccessToken($token);
```

Messaging API
-------------

[](#messaging-api)

- Send Text

```
Waba::withAccessToken($token)
    ->messages($phoneNumberId)
    ->text('628xxxx', 'Hello world');
```

- Send Image

```
->image($to, $url, $caption);
```

- Send Template

```
->template($to, 'hello_world', 'id', $components);
```

- Mark as Read

```
->markAsRead($messageId);
```

Media API
---------

[](#media-api)

- Upload

```
Waba::withAccessToken($token)
    ->media()
    ->upload(storage_path('app/image.jpg'), 'image/jpeg');
```

Template API
------------

[](#template-api)

```
Waba::withAccessToken($token)
    ->templates($wabaId)
    ->list();
```

Billing (Credit Line)
---------------------

[](#billing-credit-line)

```
Waba::withAccessToken($token)
    ->credit()
    ->listCreditLines($businessId);
```

Embedded Signup
---------------

[](#embedded-signup)

- Generate URL

```
$url = Waba::embeddedSignup()
    ->clientId()
    ->redirectUri(route('waba.callback'))
    ->state(csrf_token())
    ->build();
```

- Exchange Code

```
$data = Waba::exchangeEmbeddedCode($code);
```

BSP / Admin Flow
----------------

[](#bsp--admin-flow)

- Create System User

```
$userId = Waba::admin()
    ->createSystemUser($businessId);
```

- Assign WABA

```
Waba::admin()->assignWabaAsset($userId, $wabaId);
```

- Generate Token

```
$token = Waba::admin()->generateToken($userId);
```

Embedded User Flow
------------------

[](#embedded-user-flow)

```
Waba::withAccessToken($token)
    ->embedded()
    ->subscribeAppToWaba($wabaId);
```

Webhook
-------

[](#webhook)

- Verify Signature

```
Waba::verifyWebhookSignature(
    $request->getContent(),
    config('waba.meta.app_secret'),
    $request->header('X-Hub-Signature-256')
);
```

- Parse Payload

```
$payload = Waba::parseWebhook($request->getContent());

$type = $payload->type(); // message | status | template
```

Error Handling
--------------

[](#error-handling)

```
try {
    // call SDK
} catch (\Sejator\WabaSdk\Exceptions\WabaException $e) {
    report($e);
}
```

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance89

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity48

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

Total

3

Last Release

54d ago

PHP version history (2 changes)v1.0.0PHP >=8.1

v1.0.2PHP >=8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/41ae14529ebbf15dc950f601622549ee46d893164fe7e4c1ed8bbdb2f43234ba?d=identicon)[sejator](/maintainers/sejator)

---

Top Contributors

[![sejator](https://avatars.githubusercontent.com/u/76089365?v=4)](https://github.com/sejator "sejator (3 commits)")

---

Tags

laravelsdkwhatsappWABA

### Embed Badge

![Health badge](/badges/sejator-waba-sdk/health.svg)

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

###  Alternatives

[resend/resend-laravel

Resend for Laravel

1191.4M6](/packages/resend-resend-laravel)[missael-anda/laravel-whatsapp

A Whatsapp Business Cloud API wrapper for Laravel.

677.5k](/packages/missael-anda-laravel-whatsapp)[claude-php/claude-php-sdk-laravel

Laravel integration for the Claude PHP SDK - Anthropic Claude API

5010.8k](/packages/claude-php-claude-php-sdk-laravel)

PHPackages © 2026

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