Schnittstellen
Mailgun verbinden
Die Mails dieses Betriebs gehen über deine Mailgun-Domain und deine Absenderadresse hinaus.
Wo du verbindest
In VentionDesk unter Betrieb › Quellen › „Quelle hinzufügen“, Kategorie Mail, dann Mailgun. Verbinden, bearbeiten und entfernen darf nur der Inhaber.
Schritt für Schritt
- Öffne app.mailgun.com › Send › Sending › Domains › „Add new domain". Mailgun empfiehlt eine Subdomain wie mg.deine-domain.de. Wähle dabei die Region: EU speichert in der EU — sie lässt sich später nicht ändern.
- Setze die angezeigten DNS-Einträge: SPF (TXT mit include:mailgun.org) und DKIM (TXT); der CNAME fürs Tracking ist optional. Nach „Verify DNS settings" muss die Domain als „Active" dastehen — sonst lehnt VentionDesk sie beim Speichern ab.
- Unter Account › API Security einen API-Key mit der schwächsten Rolle anlegen, die senden und Domains lesen darf (bei Mailgun „Developer"). Den Schlüssel gibt es nur einmal zu sehen.
- Schlüssel, Domain, Region und Absenderadresse eintragen. Die Absenderadresse sollte auf der Versanddomain oder ihrer Hauptdomain liegen, sonst scheitert beim Empfänger die DMARC-Prüfung. VentionDesk liest zur Prüfung einmal die Domain (GET /v3/domains/…).
- Antworten deiner Kunden gehen weiter an dein VentionDesk-Postfach (Reply-To) und landen im Vorgang. Rückläufer und Beschwerden sieht nur dein Konto beim Anbieter — VentionDesk erfährt davon nichts. Scheitert ein Versand, steht der Grund an dieser Anbindung, und die Mail gilt als nicht gesendet; VentionDesk weicht nie still auf einen anderen Absender aus.
Was der Dialog abfragt
| Feld | Angabe | Woher |
|---|---|---|
| API-Key | Pflicht · geheim | Mailgun › Account › API Security › „Add new key". Ein reiner „Domain Sending Key" reicht nicht: Er darf die Domain nicht lesen, und genau damit prüft VentionDesk beim Speichern. |
| Versanddomain | Pflicht | Die unter Send › Sending › Domains bestätigte Domain, z. B. mg.deine-domain.de. |
| Region | Pflicht | eu für Konten in der EU-Region (api.eu.mailgun.net), us für die US-Region (api.mailgun.net) — dieselbe, in der die Domain angelegt ist. |
| Absenderadresse | Pflicht | Die Adresse, von der deine Mails kommen, z. B. rechnung@deine-domain.de — auf der Domain, die du beim Anbieter bestätigt hast. Den Namen davor nimmt VentionDesk aus „Einstellungen › E-Mail-Absender". |
Geheime Angaben speichert VentionDesk verschlüsselt und zeigt sie nie wieder an. Gespeichert wird erst, wenn der Anbieter den Zugang bestätigt; wer eine Anbindung bearbeitet und ein geheimes Feld leer lässt, behält den bisherigen Wert.
Alle Anbieter im Überblick: Schnittstellen · Webhook-Adressen: Webhooks