Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Official Zavu SDK for PHP. Send SMS, WhatsApp, Email and Voice messages from Laravel or any PHP app with PSR-aware HTTP helpers and retries.
composer require zavudev/sdk
<?php
use Zavudev\Client;
$client = new Client(
apiKey: getenv('ZAVUDEV_API_KEY')
);
$result = $client->messages->send([
'to' => '+14155551234',
'text' => 'Hello from Zavu!',
]);
echo "Message sent: " . $result->message->id . "\n";
use Zavudev\Client;
// Basic initialization
$client = new Client(
apiKey: getenv('ZAVUDEV_API_KEY')
);
// With custom base URL
$client = new Client(
apiKey: 'zv_live_xxx',
baseURL: 'https://api.zavu.dev'
);
$client = new Client(
apiKey: getenv('ZAVUDEV_API_KEY')
);
->withRawResponse() to access the full HTTP response including headers:
$response = $client->messages->withRawResponse()->send([
'to' => '+14155551234',
'text' => 'Hello!',
]);
$remaining = $response->headers['X-RateLimit-Remaining'];
echo "Remaining requests: $remaining\n";
$result = $response->parse();
echo "Message ID: " . $result->message->id . "\n";
use Zavudev\Client;
use Zavudev\APIError;
use Zavudev\ZavudevError;
$client = new Client(
apiKey: getenv('ZAVUDEV_API_KEY')
);
try {
$client->messages->send([
'to' => 'invalid-number',
'text' => 'Hello',
]);
} catch (APIError $e) {
echo "Status: " . $e->status . "\n";
echo "Message: " . $e->getMessage() . "\n";
} catch (ZavudevError $e) {
echo "Error: " . $e->getMessage() . "\n";
}
| Error Code | Description |
|---|---|
400 | Invalid request parameters |
401 | Invalid or missing API key |
403 | Insufficient permissions |
404 | Resource not found |
429 | Rate limit exceeded |
$client = new Client(
apiKey: 'zv_live_xxx',
maxRetries: 3
);
$result = $client->messages->send([
'to' => '+14155551234',
'text' => 'Hello!',
]);
.env:
ZAVUDEV_API_KEY=zv_live_xxx
use Zavudev\Client;
class MessageController extends Controller
{
private Client $zavu;
public function __construct()
{
$this->zavu = new Client(
apiKey: config('services.zavu.key')
);
}
public function send(Request $request)
{
$result = $this->zavu->messages->send([
'to' => $request->input('to'),
'text' => $request->input('text'),
]);
return response()->json(['messageId' => $result->message->id]);
}
}
# config/services.yaml
parameters:
zavudev_api_key: '%env(ZAVUDEV_API_KEY)%'
use Zavudev\Client;
class MessageService
{
private Client $zavu;
public function __construct(string $zavudevApiKey)
{
$this->zavu = new Client(
apiKey: $zavudevApiKey
);
}
public function send(string $to, string $text): string
{
$result = $this->zavu->messages->send([
'to' => $to,
'text' => $text,
]);
return $result->message->id;
}
}