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

ActiveLibrary[API Development](/categories/api)

ararahq/sdk
===========

Official PHP SDK for AraraHQ platform. Simple, typed, and developer-first.

v1.8.0(3mo ago)1371MITPHPPHP ^8.2

Since Feb 13Pushed 3mo agoCompare

[ Source](https://github.com/ararahq/arara-php-sdk)[ Packagist](https://packagist.org/packages/ararahq/sdk)[ RSS](/packages/ararahq-sdk/feed)WikiDiscussions main Synced today

READMEChangelog (1)Dependencies (12)Versions (3)Used By (0)

Arara PHP SDK
=============

[](#arara-php-sdk)

[![Packagist](https://camo.githubusercontent.com/ee7a56410a2774f97739c0d56acf0cc9f9d40c80f6eeb9974233071f1335f65f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f617261726168712f73646b)](https://packagist.org/packages/ararahq/sdk)[![PHP](https://camo.githubusercontent.com/187240af044d09d5b14a1d9d9ebdf3f7a993e4c7bc09bdb46b4ba661a891bf5b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d626c7565)](https://www.php.net/)[![License](https://camo.githubusercontent.com/5caa455d8debc46fb23abbadb45a733a937f3910a73fc875c2f7820468e1bb54/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e)](LICENSE)[![Docs](https://camo.githubusercontent.com/2afa51ed5343437150a1b5aa20fb039d348e891ec89116b31cf5a5dbfbdad942/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f446f63732d646f63732e617261726168712e636f6d2d6f72616e6765)](https://docs.ararahq.com)

Official PHP SDK for **[AraraHQ](https://ararahq.com)** — the developer-first WhatsApp API. Simple, typed, and developer-first.

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

[](#installation)

```
composer require ararahq/sdk
```

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

[](#configuration)

```
use Arara\Arara;
use Arara\Config;

$config = new Config(
    apiKey: 'sk_live_...',
);

$sdk = new Arara($config);
```

Resources
---------

[](#resources)

### 1. Messages (`$sdk->messages`)

[](#1-messages-sdk-messages)

```
// Template standard
$response = $sdk->messages->send(
    receiver: 'whatsapp:+5511999999999',
    templateName: 'welcome',
    variables: ['John']
);

// Template com Mídia (Header de Imagem/PDF)
$response = $sdk->messages->send(
    receiver: 'whatsapp:+5511999999999',
    templateName: 'invoice_ready',
    variables: ['John', 'January'],
    mediaUrl: 'https://your-media.com/invoice.pdf'
);

// Mensagem de Sessão (Texto Livre)
$response = $sdk->messages->send(
    receiver: 'whatsapp:+5511999999999',
    body: 'Olá! Como posso ajudar?'
);
```

### 2. Templates (`$sdk->templates`)

[](#2-templates-sdk-templates)

```
$templates = $sdk->templates->list();

$details = $sdk->templates->get('template-name');

$sdk->templates->create([
    'name' => 'promo_christmas',
    'category' => 'MARKETING',
    'language' => 'pt_BR',
    'body' => 'Hi {{1}}, check our Christmas deals!',
    'samples' => ['John']
]);

$sdk->templates->delete('template-name');
```

### 3. Webhook Events

[](#3-webhook-events)

```
use Arara\Utils\WebhookUtils;

$payload = file_get_contents('php://input');
$data = json_decode($payload, true);

if (WebhookUtils::isMessageStatusEvent($data)) {
    $status = $data['data']['status'];
    // Handle status update
}

if (WebhookUtils::isInboundMessageEvent($data)) {
    $from = $data['data']['from'];
    $body = $data['data']['body'];
    // Handle inbound message
}
```

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

[](#error-handling)

```
use Arara\Exceptions\AraraException;

try {
    $sdk->messages->send(...);
} catch (AraraException $e) {
    echo "Error {$e->statusCode}: {$e->getMessage()}";
    print_r($e->response);
}
```

License
-------

[](#license)

MIT

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance81

Actively maintained with recent releases

Popularity11

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 64.7% 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 ~26 days

Total

2

Last Release

114d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3f804d42829abaae70565a69892621c42beee520eb207c7b7a54c64a1ee9a0ff?d=identicon)[micaelmrsilva](/maintainers/micaelmrsilva)

---

Top Contributors

[![mateuslecchi](https://avatars.githubusercontent.com/u/45340326?v=4)](https://github.com/mateuslecchi "mateuslecchi (11 commits)")[![micaelmrsilva](https://avatars.githubusercontent.com/u/38797435?v=4)](https://github.com/micaelmrsilva "micaelmrsilva (6 commits)")

---

Tags

apiararahqmessagingopensourcephpsdkwhatsappwhatsapp-apiapisdksmsmessagingwhatsappbrazilarara

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

273.0k](/packages/eslazarev-wildberries-sdk)[resend/resend-php

Resend PHP library.

617.2M43](/packages/resend-resend-php)[infobip/infobip-api-php-client

PHP library for consuming Infobip's API

961.9M10](/packages/infobip-infobip-api-php-client)[scriptdevelop/whatsapp-manager

Paquete para manejo de WhatsApp Business API en Laravel

783.8k](/packages/scriptdevelop-whatsapp-manager)[files.com/files-php-sdk

Files.com PHP SDK

2481.1k](/packages/filescom-files-php-sdk)

PHPackages © 2026

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