PHP code example of iletiniz / sdk

1. Go to this page and download the library: Download iletiniz/sdk library. Choose the download type require.

2. Extract the ZIP file and open the index.php.

3. Add this code to the index.php.
    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

iletiniz / sdk example snippets




letiniz\IletinizClient;

$client = new IletinizClient([
    'apiKey' => getenv('ILETINIZ_API_KEY') ?: null, // 'iltz_live_…' veya 'iltz_test_…'
]);

$result = $client->messages->send([
    'to' => '+905551234567',
    'body' => 'Merhaba!',
]);

echo $result['job_id'], ' ', $result['status'];

new IletinizClient([
    'apiKey' => 'iltz_live_…',
    'baseUrl' => 'https://api.iletiniz.com', // varsayılan
    'timeoutMs' => 30000,                     // varsayılan
    'maxRetries' => 2,                        // 408/429/5xx ve ağ hatalarında
    'defaultHeaders' => ['X-Source' => 'crm'],
    'transport' => null,                      // özel TransportInterface implementasyonu
]);

$client->messages->send([
    'to' => '+905551234567',
    'body' => 'Sipariş kodunuz: 4821',
    'sender' => 'MAGAZA',     // opsiyonel
    'provider' => 'netgsm',   // opsiyonel
]);

$client->messages->send([
    'to' => '8409353994',
    'body' => 'Merhaba!',
    'provider' => 'telegram',
]);

$result = $client->messages->send([
    'to' => '+905551234567',
    'body' => 'Sipariş kodunuz: 4821',
    'provider' => 'netgsm',                        // birincil
    'fallback' => ['verimor', 'iletimerkezi'],     // sıralı yedekler (max 3)
]);

// $result['provider']  → mesajı KABUL eden sağlayıcı
// $result['attempts']  → denenen her sağlayıcı + sonucu (opsiyonel)

$client->messages->send([
    'to' => '+905551234567',
    'template' => 'order_shipped',
    'variables' => ['name' => 'Ayşe', 'tracking_no' => 'TR123'],
]);

// Düz metin modu — her item'da body zorunlu, variables yok
$client->messages->sendBulk([
    'items' => [
        ['to' => '+905551111111', 'body' => 'Mesaj 1'],
        ['to' => '+905552222222', 'body' => 'Mesaj 2'],
    ],
]);

// Template modu — items'ta body olmamalı
$client->messages->sendBulk([
    'template' => 'low_stock_alert',
    'items' => [
        ['to' => '+905551111111', 'variables' => ['product' => 'Ürün A', 'stock' => 3]],
        ['to' => '+905552222222', 'variables' => ['product' => 'Ürün B', 'stock' => 1]],
    ],
]);

$res = $client->messages->send([
    'to' => '+905551234567',
    'provider' => 'whatsapp',
    'sender' => '123456789012345',
    'whatsappTemplate' => [
        'name' => 'randevu_hatirlatma',
        'language' => 'tr',
        'components' => [
            ['type' => 'body', 'parameters' => [
                ['type' => 'text', 'text' => 'Ayşe'],
                ['type' => 'text', 'text' => '5 Kasım 10:00'],
            ]],
        ],
    ],
]);

$client->messages->sendBulk([
    'provider' => 'whatsapp',
    'whatsappTemplate' => ['name' => 'kargo_cikti', 'language' => 'tr'],
    'items' => [
        ['to' => '+905551112233', 'whatsappComponents' => [['type' => 'body', 'parameters' => [['type' => 'text', 'text' => 'TR123']]]]],
        ['to' => '+905554445566', 'whatsappComponents' => [['type' => 'body', 'parameters' => [['type' => 'text', 'text' => 'TR456']]]]],
    ],
]);

$client->messages->send([
    'to' => '+905551234567',
    'provider' => 'whatsapp',
    'whatsappMessage' => [
        'type' => 'buttons',
        'body' => 'Merhaba, size nasıl yardımcı olabiliriz?',
        'buttons' => [
            ['id' => 'siparis', 'title' => 'Sipariş durumu'],
            ['id' => 'temsilci', 'title' => 'Temsilciye bağlan'],
        ],
        'replyTo' => $wamid, // isteğe bağlı: yanıtlanan mesaj
    ],
]);

use Iletiniz\Webhook;

$payload = file_get_contents('php://input');
$event = Webhook::parse($payload, $_SERVER, getenv('ILETINIZ_WEBHOOK_SECRET')); // imza geçersizse IletinizError

if ($event['event'] === 'message.received') {
    $data = $event['data'];
    $from = $data['from'];                                   // +905551234567
    $choice = $data['interactive']['id'] ?? $data['text'];   // buton/liste seçimi ya da metin
    if ($data['media'] !== null) {
        $file = $client->whatsapp->downloadMedia($data['wamid']); // ['content', 'contentType', 'filename']
    }
}

$job = $client->messages->send([
    'to' => '+905551234567',
    'body' => 'Yarınki randevunuzu hatırlatırız.',
    'scheduledAt' => new DateTimeImmutable('2026-11-05 09:00', new DateTimeZone('Europe/Istanbul')),
]);

$list = $client->scheduled->list(['status' => 'scheduled']);
$client->scheduled->cancel($job['scheduled_id']);

// Randevudan 24 saat ve 2 saat önce
$client->reminders->create([
    'type' => 'one_time',
    'name' => 'Randevu #4411',
    'eventAt' => '2026-11-10T14:00:00+03:00',
    'offsetsMinutes' => [1440, 120],
    'message' => ['to' => '+905551234567', 'body' => 'Randevunuz 10 Kasım 14:00.'],
]);

// Her pazartesi 09:30 (Europe/Istanbul)
$rule = $client->reminders->create([
    'type' => 'recurring',
    'name' => 'Haftalık bülten',
    'frequency' => 'weekly',
    'dayOfWeek' => 1,
    'timeOfDay' => '09:30',
    'message' => ['to' => '+905551234567', 'template' => 'haftalik_bulten'],
]);

$client->reminders->update($rule['id'], ['status' => 'paused']);
$client->reminders->delete($rule['id']);

$partner = new IletinizClient(['apiKey' => getenv('ILETINIZ_PARTNER_KEY')]);

$child = $partner->partner->createAccount(['name' => 'Klinik Ankara', 'externalRef' => 'klinik-42']);
$key = $partner->partner->createApiKey($child['id'], ['name' => 'prod']);
// $key['key'] yalnız bu yanıtta döner; güvenli şekilde saklayın.

// Alt hesabın anahtarlarını listeleyin (düz metin anahtar dönmez, yalnız key_prefix) ve gerekirse iptal edin:
$keys = $partner->partner->listApiKeys($child['id'])['data'];
$partner->partner->revokeApiKey($child['id'], $keys[0]['id']); // idempotent: iptal edilmişse aynı nesne döner

$partner->partner->transferQuota($child['id'], 5000);
$link = $partner->partner->createWhatsappSignupLink($child['id']);
// $link['url'] müşterinize iletilir (24 saat geçerli, tek kullanımlık).

// Alt hesap adına gönderim, alt hesabın anahtarıyla yapılır:
$childClient = new IletinizClient(['apiKey' => $key['key']]);

$info = $client->messages->retrieve($jobId);
// $info['status']: 'sent' | 'queued' | 'failed' | 'delivered' | 'expired' | 'rejected' | 'unknown'

$health = $client->health->check();
// ['ok' => true, 'db' => 'up']

use Iletiniz\Exception\IletinizAPIError;
use Iletiniz\Exception\IletinizAuthenticationError;
use Iletiniz\Exception\IletinizConnectionError;
use Iletiniz\Exception\IletinizNotFoundError;
use Iletiniz\Exception\IletinizRateLimitError;
use Iletiniz\Exception\IletinizServerError;
use Iletiniz\Exception\IletinizTimeoutError;
use Iletiniz\Exception\IletinizValidationError;

try {
    $client->messages->send(['to' => '+905551234567', 'body' => 'test']);
} catch (IletinizAuthenticationError $e) {
    // 401 — geçersiz veya iptal edilmiş anahtar
} catch (IletinizValidationError $e) {
    // 400 / 422 — istek doğrulanamadı
    var_dump($e->getBody());
} catch (IletinizRateLimitError $e) {
    // 429 — yeniden denemeden önce backoff
} catch (IletinizNotFoundError $e) {
    // 404
} catch (IletinizServerError $e) {
    // 5xx
} catch (IletinizAPIError $e) {
    error_log(sprintf('%d %s %s [%s]', $e->status, $e->getApiCode() ?? '-', $e->getMessage(), $e->getRequestId() ?? '-'));
} catch (IletinizTimeoutError $e) {
    // istek timeout'a takıldı
} catch (IletinizConnectionError $e) {
    // ağ hatası
}

use Iletiniz\RequestOptions;

$client->messages->send(
    ['to' => '+905551234567', 'body' => 'merhaba'],
    new RequestOptions(timeoutMs: 10000),
);

use Iletiniz\Http\HttpResponse;
use Iletiniz\Http\TransportInterface;
use Iletiniz\IletinizClient;

$transport = new class implements TransportInterface {
    public function send(string $method, string $url, array $headers, ?string $body, int $timeoutMs): HttpResponse
    {
        return new HttpResponse(200, '{"ok":true,"db":"up"}', []);
    }
};

$client = new IletinizClient([
    'apiKey' => 'iltz_test_xxx',
    'transport' => $transport,
]);