Website-Formular ins CRM

Mit einer Formular-Verbindung und dem Endpunkt /crm/form/submit landen Eingänge von Deiner Website direkt im Snapper-CRM — im Posteingang oder im Kontakt-Thread. Dein Team kann Anfragen wie Support-Tickets bearbeiten: zuordnen, per E-Mail antworten und optional eine Aufgabe anlegen.

Wichtig: Das API-Secret gehört nur auf Deinen Server (PHP, Node o. Ä.). Niemals im HTML, JavaScript oder als verstecktes Formularfeld.

Siehe auch: Website-Formular (nur Ordner) · CRM in Snapper

Besucher (Website)
    → Dein Server (Secret nur hier)
    → POST https://api.snapper.network/crm/form/submit
    → Snapper-CRM

Was Snapper automatisch macht:

Optional legt Snapper zusätzlich eine Archiv-Kopie im Zielordner Deiner Formular-Verbindung ab.

1 — Vorbereiten

1. [ ] Snapper-Account mit CRM (CRM öffnen)
2. [ ] SMTP-Verbindung anlegen (Profil → Verbindungen → SMTP) und in den CRM-Einstellungen (Zahnrad) auswählen — für Antworten an Kunden
3. [ ] Optional: Ordner für Formular-Archiv (Roh-Eingänge)

2 — Formular-Verbindung anlegen

1. [ ] Profil → Verbindungen → Typ Formular
2. [ ] Zielordner wählen (Archiv der Eingänge)
3. [ ] Secret einmalig sichern — danach nicht mehr einsehbar; bei Verlust Secret neu generieren
4. [ ] Optional: IP-Whitelist (IP Deines Webservers, komma-separiert)
5. [ ] Endpunkt notieren: https://api.snapper.network/crm/form/submit

3 — Website anbinden

1. [ ] Kontaktformular auf Deiner Website (z. B. Name, E-Mail, Betreff, Nachricht)
2. [ ] Unsichtbares Honeypot-Feld _hp (muss leer bleiben)
3. [ ] Formular sendet an Deinen Server (z. B. /kontakt-senden.php)
4. [ ] Server leitet per POST an Snapper weiter (Beispiel unten)
5. [ ] Test: Eingang in CRM → Posteingang oder Kontakt-Thread

4 — Anfragen bearbeiten

1. [ ] Posteingang prüfen (unzugeordnete Nachrichten)
2. [ ] Kontakt zuordnen oder Thread öffnen
3. [ ] E-Mail an Kunden senden (Composer im CRM)
4. [ ] Optional: Aufgabe aus der Nachricht anlegen

Browser  →  Deine Website (ohne Secret)
         →  PHP auf Deinem Server
         →  POST https://api.snapper.network/crm/form/submit

<form method="post" action="/kontakt-senden.php">
  <input type="text" name="_hp" value="" style="display:none" tabindex="-1" autocomplete="off" aria-hidden="true">
 
  <label>Name <input type="text" name="name" required></label>
  <label>E-Mail <input type="email" name="email" required></label>
  <label>Betreff <input type="text" name="subject"></label>
  <label>Nachricht <textarea name="message" required></textarea></label>
  <button type="submit">Senden</button>
</form>

<?php
declare(strict_types=1);
 
$snapperSecret = getenv('SNAPPER_CRM_FORM_SECRET') ?: '';
$snapperEndpoint = 'https://api.snapper.network/crm/form/submit';
 
if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
    http_response_code(405);
    exit('Nur POST.');
}
 
// Honeypot: leer lassen — sonst wird nichts gespeichert (stille Abwehr)
if (!empty($_POST['_hp'])) {
    header('Location: /danke.html');
    exit;
}
 
$name = trim((string)($_POST['name'] ?? ''));
$email = trim((string)($_POST['email'] ?? ''));
$subject = trim((string)($_POST['subject'] ?? ''));
$message = trim((string)($_POST['message'] ?? ''));
 
if ($name === '' || $email === '' || $message === '') {
    http_response_code(400);
    exit('Bitte Pflichtfelder ausfüllen.');
}
 
if ($snapperSecret === '') {
    error_log('SNAPPER_CRM_FORM_SECRET fehlt');
    http_response_code(500);
    exit('Formular vorübergehend nicht verfügbar.');
}
 
$payload = [
    'name' => $name,
    'email' => $email,
    'subject' => $subject,
    'message' => $message,
];
 
$ch = curl_init($snapperEndpoint);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $snapperSecret,
        'Content-Type: application/json',
        'Accept: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 20,
]);
$responseBody = curl_exec($ch);
$httpCode = (int)curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
 
if ($responseBody === false || $httpCode < 200 || $httpCode >= 300) {
    error_log('Snapper CRM-Formular fehlgeschlagen: HTTP ' . $httpCode);
    http_response_code(502);
    exit('Senden fehlgeschlagen. Bitte später erneut versuchen.');
}
 
header('Location: /danke.html');
exit;

Secret z. B. in der Server-Umgebung (nicht in Git committen):

export SNAPPER_CRM_FORM_SECRET='dein-secret-hier'

Optional: In den Formular-Verbindungs-Einstellungen die IP-Whitelist auf die ausgehende IP Deines Servers setzen.

curl -X POST 'https://api.snapper.network/crm/form/submit' \
  -H 'Authorization: Bearer DEIN_SECRET' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Max Mustermann",
    "email": "max@example.com",
    "subject": "Support-Anfrage",
    "message": "Hallo, ich habe eine Frage."
  }'

Bei Erfolg: HTTP 200 und „status“: „success“ in der Antwort. Danach Eingang im CRM prüfen.

Endpunkt: POST https://api.snapper.network/crm/form/submit

Anmeldung: Formular-Secret (kein Snapper-Login nötig)

Pflichtfelder im JSON-Body:

Optionale Felder: name, subject, category (z. B. support, sales, other)

Format: JSON empfohlen; max. 128 KB gesamt, einzelne Texte max. 8000 Zeichen. Kein HTML oder Script in Feldwerten.

Typische Fehler:

Schutz: ca. 30 Anfragen pro Minute pro Server-IP; Honeypot-Feld _hp muss leer bleiben.

Wenn Eingänge nur in einem Ordner gespeichert werden sollen (ohne CRM), nutze den Endpunkt /webhook/form — Anleitung: Website-Formular anbinden.

Für Support und Kundenanfragen im CRM immer /crm/form/submit (dieses Whitepaper).

• Secret nie im Browser oder öffentlich im Quellcode der Website.
• Auf Deiner Website eine eigene Danke-Seite nach erfolgreichem Senden anzeigen.
• Antworten an Besucher: im CRM E-Mail an Kunden (SMTP-Verbindung muss eingerichtet sein).
• Details zu Verbindungen: Verbindungen · CRM-Oberfläche: CRM