# Küldési hibák, összefoglaló gyakoriság, SparkPost és Twilio hookjai

> Hookok sikertelen küldés kezelésére, az összefoglaló e-mail gyakoriságának listájához, a SparkPost tranzakciós jelöléséhez és a Twilio SMS-riasztások kéréstörzséhez.

Ezek a hookok a sikertelen küldésre, az összefoglaló e-mail beállítására, a SparkPost-küldésre és az SMS-riasztásokra vonatkoznak. A kódot az aktív téma `functions.php` fájljába, egy saját funkcióbővítő bővítménybe, egyedi kiegészítőbe vagy kódrészlet-kezelő bővítménybe teheted.

## gravitysmtp_on_send_failure (action)

Lefut, ha egy e-mail elküldése nem sikerül a Gravity SMTP-n keresztül. Saját kódot futtathatsz vele, például értesítést küldhetsz egy másik csatornán.

```php
add_action( 'gravitysmtp_on_send_failure', 'fuggveny_neve', 10, 1 );
```

| Paraméter | Típus | Leírás |
|---|---|---|
| `$email_id` | egész szám | A sikertelen e-mail-esemény azonosítója. |

```php
add_action( 'gravitysmtp_on_send_failure', function( $email_id ) {
    // Ide jön a saját kód, ha egy levél nem ment el.
} );
```

## gravitysmtp_on_primary_failure (action)

Lefut, ha a levél elküldése az elsődleges integráción nem sikerül. Ez korábbi pont, mint a végleges küldési hiba: itt még dönthetsz arról, mi történjen az elsődleges integráció hibájakor.

```php
add_action( 'gravitysmtp_on_primary_failure', 'fuggveny_neve', 10, 1 );
```

| Paraméter | Típus | Leírás |
|---|---|---|
| `$failed_id` | egész szám | A sikertelen e-mail-esemény azonosítója. |

```php
add_action( 'gravitysmtp_on_primary_failure', function( $failed_id ) {
    // Ide jön a saját kód, ha az elsődleges küldés nem sikerült.
} );
```

A hook a Gravity SMTP 2.2-es verziójától érhető el.

## gravitysmtp_notifications_email_digest_frequency_options (filter)

Az **SMTP → Beállítások** oldal **E-mailes történések összefoglalója** részén az **Összefoglaló küldése** listában választható gyakoriságokat módosíthatod vele. Alapból három van: **Napi** (1 nap), **Hetente (ajánlott)** (7 nap) és **Havi** (30 nap). Az összefoglaló e-mail működését a [Riasztások és összefoglaló e-mail](https://hub.hellowp.io/hu/plugins/gravitysmtp/riasztasok/) fejezet írja le.

```php
add_filter( 'gravitysmtp_notifications_email_digest_frequency_options', 'fuggveny_neve', 10, 1 );
```

| Paraméter | Típus | Leírás |
|---|---|---|
| `$options` | tömb | A gyakoriságok tömbje. Minden elem két kulcsot tartalmaz: `label` (a felületen megjelenő felirat, szöveg) és `value` (az időköz napokban, egész szám). |

Az alapértelmezett érték:

```php
array(
    array( 'label' => 'Daily', 'value' => 1 ),
    array( 'label' => 'Weekly (recommended)', 'value' => 7 ),
    array( 'label' => 'Monthly', 'value' => 30 ),
);
```

Példa: háromnaponkénti küldés hozzáadása.

```php
add_filter( 'gravitysmtp_notifications_email_digest_frequency_options', function( $options ) {
    $options[] = array(
        'label' => __( 'Every 3 Days', 'gravitysmtp' ),
        'value' => 3,
    );
    return $options;
} );
```

A szűrő a Gravity SMTP 2.0.0 verziójától érhető el.

## gravitysmtp_sparkpost_send_as_transactional (filter)

Azt szabályozza, hogy a SparkPoston át küldött leveleket tranzakciósként jelölje-e meg a Gravity SMTP. Alapértéke `true`. A SparkPost integráció beállítását a [SparkPost](https://hub.hellowp.io/hu/plugins/gravitysmtp/szolgaltatok-sparkpost/) fejezet tartalmazza.

```php
add_filter( 'gravitysmtp_sparkpost_send_as_transactional', 'fuggveny_neve', 10, 1 );
```

| Paraméter | Típus | Leírás |
|---|---|---|
| `$send_as_transactional` | logikai | Tranzakciósként menjen-e a levél. Alapérték: `true`. |

Példa: a tranzakciós jelölés kikapcsolása.

```php
add_filter( 'gravitysmtp_sparkpost_send_as_transactional', '__return_false' );
```

## gravitysmtp_twilio_alert_request_body (filter)

A Twilio API-nak küldött kérés törzsét módosíthatod vele, amikor a Gravity SMTP SMS-ben küld riasztást. Az SMS-riasztásokról a [Riasztások és összefoglaló e-mail](https://hub.hellowp.io/hu/plugins/gravitysmtp/riasztasok/) fejezet szól.

```php
add_filter( 'gravitysmtp_twilio_alert_request_body', 'fuggveny_neve', 10, 2 );
```

| Paraméter | Típus | Leírás |
|---|---|---|
| `$request_body` | tömb | A Twilionak küldendő kéréstörzs. Alapból az `ApplicationSid`, `Body`, `To` és `From` mezőket tartalmazza. |
| `$send_args` | tömb | Az eredeti küldési paraméterek: `account_id`, `auth_token`, `to`, `from` és `message`. |

Példa: egyedi Twilio-paraméterek hozzáadása.

```php
add_filter( 'gravitysmtp_twilio_alert_request_body', 'twilio_uzenet_testreszabasa', 10, 2 );

function twilio_uzenet_testreszabasa( $request_body, $send_args ) {
    $request_body['StatusCallback'] = 'https://pelda.example/twilio-webhook';
    $request_body['ValidityPeriod'] = 1440; // 24 óra, percben megadva

    return $request_body;
}
```