vsartech / seenwa

v0.3.1 2026-09-22 17:16 UTC

Requires

• php: >=8.1
• ext-curl: *
• ext-json: *

Requires (Dev)

• phpunit/phpunit: ^10.5

MIT

• whatsapp
• seen
• whatsapp-business-api

Published on Packagist.org on 2026-09-22 17:17 UTC

README

PHP SDK for the Seen WhatsApp Business API.

Install

composer require vsartech/seenwa

Usage

use Seen\SeenClient;

$client = new SeenClient($_ENV['SEEN_API_KEY']);

$client->messages->sendText(
    to: '[phone]',
    phoneNumberId: '1234567890',
    message: 'Hello from PHP',
);

$contacts = $client->contacts->list(optedIn: true);

Verifying inbound webhooks

Verify the X-Webhook-Signature header against the raw request body before trusting a payload from Seen's outbound client webhooks:

use Seen\SeenWebhookVerifier;

$rawBody = file_get_contents('php://input');

$isValid = SeenWebhookVerifier::verify(
    rawBody: $rawBody,
    signatureHeader: $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'] ?? null,
    secret: $storedWebhookSecret, // shown once when the webhook was created
);

if (!$isValid) {
    http_response_code(401);
    exit;
}