Für Agenten
Endpunkt für Anfragen
Dieser Endpunkt nimmt Projektanfragen an MF Consulting von einem Agenten entgegen, der für eine Person handelt. Er braucht kein Konto und keine Anmeldung und erfasst dieselben Angaben wie unser Anfrageformular.
Eine Anfrage senden
Senden Sie eine POST-Anfrage mit JSON-Inhalt an https://matthiasfrank.de/wp-json/mf/v1/enquiry, mit dem Content-Type application/json. Anfragen brauchen einen User-Agent-Header, der den Client benennt, zum Beispiel mein-agent/1.0. Fehlt er oder ist er eine Standardkennung wie curl/8, gibt es eine 400 mit diesem Hinweis. Einige andere, etwa Python-urllib, lehnt unser CDN schon vorher mit einer 403 ab.
curl -X POST https://matthiasfrank.de/wp-json/mf/v1/enquiry \
-H "Content-Type: application/json" \
-H "User-Agent: mein-agent/1.0" \
-d '{
"language": "de",
"name": "Erika Beispiel",
"email": "erika@example.com",
"company": "Beispiel GmbH",
"role": "Leitung Operations",
"team_size": "26-75",
"message": "Wir möchten unsere Projekte und Kundenarbeit an einem Ort in Notion bündeln.",
"how_found": "Mein Assistent hat Ihre Fallstudien gefunden."
}'
Felder
Alle Felder sind Pflichtfelder, außer idempotency_key. Unbekannte Felder werden abgelehnt.
language- en oder de. Wir antworten in dieser Sprache.
name- Der Name der Person. Bis zu 200 Zeichen.
email- Die E-Mail-Adresse der Person. Dorthin geht unsere Antwort. Bis zu 254 Zeichen.
company- Das Unternehmen der Person. Bis zu 200 Zeichen.
role- Die Position der Person im Unternehmen. Bis zu 200 Zeichen.
team_size- Wie viele Leute im Unternehmen arbeiten. Einer der Werte 2-10, 11-25, 26-75, 76-150 oder 150+.
message- Wobei die Person Hilfe braucht. Bis zu 5.000 Zeichen.
how_found- Wie die Person oder ihr Agent auf uns aufmerksam geworden ist. Bis zu 1.000 Zeichen.
idempotency_key- Optional. Bei einem erneuten Versuch denselben Wert senden, dann gibt es dieselbe Empfangsbestätigung. Bis zu 200 Zeichen.
Antworten
- 202: eingegangen, mit einer Empfangsbestätigung aus request_id, status, booking_confirmed, received_at und next_step. Dieselbe Anfrage noch einmal ergibt dieselbe Bestätigung.
- 400: Ein Feld fehlt oder ist ungültig. Alle Probleme stehen unter errors.
- 413 oder 415: Der Inhalt ist größer als 32 KB, oder der Content-Type stimmt nicht.
- 429: zu viele Anfragen. Siehe retry_after und den Retry-After-Header.
- 503: Derzeit werden keine Anfragen angenommen. Nutzen Sie das Formular unter fallback_url.
Wie es weitergeht
Die Anfrage landet in unserem CRM in Notion, und wir melden uns so schnell wie möglich per E-Mail, meist innerhalb von 24 Stunden, um die Situation gemeinsam einzuschätzen. Eine 202 heißt, dass die Anfrage angekommen ist. Ein Termin ist damit noch nicht vereinbart.
Vor dem Senden
Wir bitten darum, dass die Person die ganze Nachricht sieht und den genauen Text freigibt, bevor er gesendet wird.
Andere Wege zu uns
- Auf der Beratungsseite gibt es ein Anfrageformular mit denselben Angaben, für alle mit einem Browser.
- Per E-Mail erreichen Sie uns unter hello@matthiasfrank-consulting.com.
Für Tools
- Eine OpenAPI-3.1-Beschreibung dieses Endpunkts.
- Eine GET-Anfrage an den Endpunkt liefert die Felder als JSON und zeigt, ob gerade Anfragen angenommen werden.
