erwane/whep-postal

Postal webhooks handler

2.0.0 2025-08-04 08:17 UTC

Requires

• php: ^8.1
• ext-json: *
• erwane/whep-client: ^2.0

Requires (Dev)

• cakephp/cakephp-codesniffer: ^5.0
• erwane/phpunit-resource-helper: ^2.0
• phpunit/phpunit: ^10.0 | ^12.0
• symfony/var-dumper: ^v6.0 | ^v7.0

MIT

• Erwane

• webhook
• postal

README

Webhook handler for postal emailing provider.

Usage

composer require erwane/whep-postal

use WHEP\Client;
use WHEP\WebhookProviderException;

$provider = Client::getProvider('postal', [
    'callbacks' => [
        ProviderInterface::EVENT_BLOCKED => [$this, 'callbackInvalidate'],
        ProviderInterface::EVENT_BOUNCE_QUOTA => [$this, 'callbackUnsub'],
    ],
]);

try {
    // process the data.
    $provider->process($webhookData);
    
    // Data available from provider getters.
    $email = $provider->getRecipient();
    
    // Launch callbacks
    $provider->callback();
} catch (WebhookProviderException $e) {
    // log ?
}

See WHEP Client README for getters.