Free, Open Source, Self-Hosted WhatsApp API Gateway
TypeScript apibotgatewayself-hostedwhatsappwhatsapp-apiwhatsapp-automationwhatsapp-botwhatsapp-gatewaywhatsapp-gateway-apiwhatsapp-webwhatsapp-web-api
<?php
declare(strict_types=1);
namespace OpenWA\Tests;
use PHPUnit\Framework\TestCase;
class LabelsChannelsCatalogTest extends TestCase
{
public function testLabels(): void
{
$backend = new MockBackend();
$backend->on(200, [['id' => 'l1', 'name' => 'VIP']]);
$backend->on(200, ['id' => 'l1', 'name' => 'VIP']);
$backend->on(200, [['id' => 'l1', 'name' => 'VIP']]);
$backend->on(200, ['success' => true]);
$backend->on(200, ['success' => true]);
$client = $backend->makeClient();
$client->labels->list('s');
$this->assertStringContainsString('/sessions/s/labels', $backend->calls()[0]['path']);
$client->labels->get('s', 'l1');
$this->assertStringContainsString('/labels/l1', $backend->calls()[1]['path']);
$client->labels->forChat('s', '[email protected]');
$this->assertSame('GET', $backend->lastCall()['method']);
$this->assertSame('/api/sessions/s/labels/chat/[email protected]', $backend->lastCall()['path']);
$client->labels->addToChat('s', '[email protected]', ['labelId' => 'l1']);
$this->assertSame('POST', $backend->calls()[3]['method']);
$this->assertSame(['labelId' => 'l1'], $backend->calls()[3]['body']);
$client->labels->removeFromChat('s', '[email protected]', 'l1');
$this->assertSame('DELETE', $backend->calls()[4]['method']);
}
public function testChannels(): void
{
$backend = new MockBackend();
$backend->on(200, [['id' => '123@newsletter', 'name' => 'News']]);
$backend->on(200, ['id' => '123@newsletter', 'name' => 'News']);
$backend->on(200, []);
$backend->on(201, ['id' => '123@newsletter', 'name' => 'News']);
$backend->on(200, ['success' => true]);
$client = $backend->makeClient();
$client->channels->list('s');
$this->assertStringContainsString('/sessions/s/channels', $backend->calls()[0]['path']);
$client->channels->get('s', '123@newsletter');
$this->assertSame('GET', $backend->lastCall()['method']);
$this->assertSame('/api/sessions/s/channels/123@newsletter', $backend->lastCall()['path']);
$client->channels->messages('s', '123@newsletter', ['limit' => 10]);
$this->assertStringContainsString('limit=10', $backend->calls()[2]['query']);
$client->channels->subscribe('s', ['inviteCode' => 'ABCxyz']);
$this->assertSame('POST', $backend->calls()[3]['method']);
$this->assertSame(['inviteCode' => 'ABCxyz'], $backend->calls()[3]['body']);
$client->channels->unsubscribe('s', '123@newsletter');
$this->assertSame('DELETE', $backend->calls()[4]['method']);
}
public function testCatalog(): void
{
$backend = new MockBackend();
$backend->on(200, ['name' => 'My Shop', 'productsCount' => 5]);
$backend->on(200, [['id' => 'p1', 'name' => 'Widget']]);
$backend->on(200, ['id' => 'p1', 'name' => 'Widget']);
$backend->on(201, ['messageId' => 'm', 'timestamp' => 1]);
$client = $backend->makeClient();
$client->catalog->info('s');
$this->assertStringContainsString('/sessions/s/catalog', $backend->calls()[0]['path']);
$client->catalog->products('s', ['page' => 1, 'limit' => 20]);
$this->assertStringContainsString('page=1', $backend->calls()[1]['query']);
$client->catalog->product('s', 'p1');
$this->assertSame('GET', $backend->lastCall()['method']);
$this->assertSame('/api/sessions/s/catalog/products/p1', $backend->lastCall()['path']);
$client->catalog->sendProduct('s', ['chatId' => '[email protected]', 'productId' => 'p1', 'body' => 'x']);
$this->assertStringContainsString('/messages/send-product', $backend->calls()[3]['path']);
$this->assertSame(['chatId' => '[email protected]', 'productId' => 'p1', 'body' => 'x'], $backend->calls()[3]['body']);
}
public function testCatalogInfoAndProductReturnNullOnAnEmptyBody(): void
{
$backend = new MockBackend();
$backend->on(200);
$backend->on(200);
$client = $backend->makeClient();
$this->assertNull($client->catalog->info('s'));
$this->assertNull($client->catalog->product('s', 'missing'));
}
public function testClientExposesAll11Resources(): void
{
$client = (new MockBackend())->makeClient();
foreach (['sessions', 'messages', 'contacts', 'groups', 'webhooks', 'chats', 'status', 'health', 'labels', 'channels', 'catalog'] as $r) {
$this->assertTrue(property_exists($client, $r), "Client should expose resource: {$r}");
}
}
public function testChannelAdminAndOwnership(): void
{
$backend = new MockBackend();
$backend->on(200, ['success' => true]);
$backend->on(200, ['success' => true]);
$client = $backend->makeClient();
$client->channels->demoteAdmin('s', 'c@newsletter', ['userId' => '[email protected]']);
$this->assertStringEndsWith('/channels/c@newsletter/admins/demote', $backend->lastCall()['url']);
$this->assertSame(['userId' => '[email protected]'], $backend->lastCall()['body']);
$client->channels->transferOwnership('s', 'c@newsletter', ['newOwnerId' => '[email protected]']);
$this->assertStringEndsWith('/channels/c@newsletter/owner/transfer', $backend->lastCall()['url']);
$this->assertSame(['newOwnerId' => '[email protected]'], $backend->lastCall()['body']);
}
}