```php
use BulkGate\Sms\Sender;
```

Um eine Nachricht vom Typ `BulkGate\Sms\IMessage` zu senden

 - [`BulkGate\Sms\Message`](https://www.bulkgate.com/de/dokumentation/php-sdk/php-sdk-nachricht/2.0/)
 - [`BulkGate\Sms\BulkMessage`](https://www.bulkgate.com/de/dokumentation/php-sdk/php-sdk-massennachricht/2.0/)

müssen Sie einen Sender erstellen. Dafür gibt es zwei Möglichkeiten:

 - [Nette Framework](https://www.bulkgate.com/de/dokumentation/php-sdk/php-sdk-installation-nette/1.0/) – wenn Sie das [Nette Framework](https://nette.org/) verwenden
 - [PHP](https://www.bulkgate.com/de/dokumentation/php-sdk/php-sdk-installation/1.0/) – in allen anderen Fällen
 
```php
/** @var BulkGate\Message\Connection $connection */
$sender = new BulkGate\Sms\Sender($connection);
```
 
## Nachrichten senden
 
Zum Senden der Nachricht verwenden Sie die Methode `send()`, die Nachrichten vom Typ `BulkGate\Sms\IMessage` entgegennimmt.
 
```php
/** 
  * @var BulkGate\Sms\Sender $sender 
  * @var BulkGate\Sms\IMessage|BulkGate\Sms\Message|BulkGate\Sms\BulkMessage $message
  */
$response = $sender->send($message);
```

### Antwort auf `BulkGate\Sms\Message`
```php
BulkGate\Message\Response Object
(
    [data:BulkGate\Message\Response:private] => Array
    (
        [sms_id] => tmpde8f0dca011
        [price] => 0.033
        [credit] => 215.8138
        [number] => 420777777777
    )
)
```

### Antwort auf `BulkGate\Sms\BulkMessage`
```php
BulkGate\Message\Response Object
(
    [data:BulkGate\Message\Response:private] => Array
    (
        [total] => Array
        (
            [price] => 0.033
            [status] => Array
            (
                [sent] => 0
                [accepted] => 1
                [scheduled] => 0
                [error] => 0
            )
        )
        [response] => Array
        (
            [0] => Array
            (
                [status] => accepted
                [sms_id] => tmpde8f0b47b12
                [price] => 0.033
                [credit] => 215.8138
                [number] => 420777777777
            )
        )
    )
)
```

## Unicode

Um [Unicode](https://www.bulkgate.com/de/hilfe-center/sms/unicode/) einzustellen, rufen Sie die Methode `unicode()` auf.

```php
/** @var BulkGate\Sms\Sender $sender */
$sender->unicode(); // Einschalten
$sender->unicode(true); // Einschalten
$sender->unicode(false); // Ausschalten
```

 ## Einstellung des Absenders
 
Die Einstellung des Absendertyps ist in einem eigenen [Kapitel](https://www.bulkgate.com/de/dokumentation/php-sdk/php-sdk-absendereinstellungen/) beschrieben.
 
 ```php
/** 
  * @var BulkGate\Sms\Sender $sender
  * @var SenderSettings\CountrySenderSettings|SenderSettings\StaticSenderSettings $settings
  */
$sender->setSenderSettings($settings);
```

## Standardland

Wenn Sie Telefonnummern im nationalen Format angeben, weiß das System nicht, wohin die Nachrichten gesendet werden sollen. Ist die internationale Vorwahl also nicht ausdrücklich angegeben, können Sie für den Sender ein Standardland festlegen, in das die Nachrichten geleitet werden.

 ```php
 /** @var BulkGate\Sms\Sender $sender */
 $sender->setDefaultCountry(BulkGate\Sms\Country::CZECH_REPUBLIC); // über BulkGate\Sms\Country
 $sender->setDefaultCountry('cz'); // ISO 3166-1 alpha-2 
 ``` 
 
 ## Überprüfung von Nummern
 
 Wenn Sie prüfen müssen, ob eine Telefonnummer dem Format des Landes entspricht, verwenden Sie die Methode `checkPhoneNumbers()`.
 
 ```php
 /** @var BulkGate\Sms\Sender $sender */
 $sender->checkPhoneNumbers($numbers, $iso);
 ``` 
 
Dabei kann `$numbers` Folgendes sein:
- eine Telefonnummer als Zeichenkette `"420777777777"`
- eine Telefonnummer vom Typ `BulkGate\Sms\Message\PhoneNumber`
- ein Array von Telefonnummern `['420777777777','420777777778','420777777779']`
- ein Array von Telefonnummern vom Typ `BulkGate\Sms\Message\PhoneNumber`

`$iso` hat dieselbe Bedeutung wie beim [Standardland](#standardland)

Die Ausgabe ist dann `BulkGate\Message\Response`

```php
BulkGate\Message\Response Object
(
    [data:BulkGate\Message\Response:private] => Array
    (
        [420777777777] => Array
        (
            [number] => 420777777777
            [iso] => cz
            [prefix] => 420
            [area] => 420
            [length] => 12
            [area_found] => true
        )
        [77777777] => Array
        (
            [number] => 42177777777 
            [iso] => sk
            [prefix] => 421
            [area] => 421
            [length] => 8
            [area_found] => false
        )
    )
)
```

Der Wert `area_found` gibt an, ob die Nummer dem landesspezifischen Format entspricht.
