Ereignis eines abgesendeten Kontaktformulars — senden Sie es, wenn ein Besucher des Shops das Kontaktformular ausfüllt. Anfrageparameter, Auswahl der Benachrichtigung und Form der Antwort werden in der [Übersicht der E-shop API](https://www.bulkgate.com/de/dokumentation/eshop-api/eshop-api-uebersicht/) beschrieben.

## API-URL

URL zum Senden von HTTP-Anfragen:

```url
https://portal.bulkgate.com/api/1.0/eshop/contact/form
```

> [!NOTE]
> Erreicht die Anfrage ihr Ziel nicht, wiederholen Sie sie auf dem [Backup-Server](https://www.bulkgate.com/de/dokumentation/api-verwaltung-und-tokens/backup-server/) `backup1.bulkgate.com`.

## Unterstützte HTTP-Methoden

- `POST` - `application/json`

```http
POST /api/1.0/eshop/contact/form HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json
```

## Benachrichtigung

Das Portal verwendet die Benachrichtigung des Ereignisses `contact_form`. Fest vorgegebene Variablen hat das Formular nicht — senden Sie die Formularfelder unter eigenen Namen und verwenden Sie sie in der Vorlage (`<Name>`). Den Text der Nachricht des Besuchers können Sie zum Beispiel in `customer_message` senden.

## Beispielanfrage

```http-json
POST /api/1.0/eshop/contact/form HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json

{
  "application_id": 451,
  "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj",
  "language": "de",
  "variables": {
    "customer_name": "Max Mustermann",
    "customer_email": "max.mustermann@example.com",
    "customer_mobile": "777777777",
    "customer_country_id": "cz",
    "customer_message": "Guten Tag, wann haben Sie Größe M wieder auf Lager?"
  }
}
```

## Antwort

```json
{
    "data": {
        "admin": [
            {
                "status": "accepted",
                "message_id": "tmpde1bcd4b1d1",
                "part_id": ["tmpde1bcd4b1d1"],
                "number": "420777777777",
                "channel": "sms"
            }
        ]
    }
}
```

Die Bedeutung der Schlüssel `customer` und `admin`, Fehler beim Senden und die Fehlertypen finden Sie in der [Übersicht der E-shop API](https://www.bulkgate.com/de/dokumentation/eshop-api/eshop-api-uebersicht/).
