SendApp Docs
Anmelden

KI-Felder eines Kontakts berechnen

POST https://app.sendapp.ai/api/contacts/{id}/ai-fields
Die KI liest die Unterhaltungen des Kontakts und füllt seine benutzerdefinierten Felder vom Typ ai aus, wie die Schaltfläche in der Kontaktkarte. Jedes berechnete Feld verbraucht KI-Guthaben des Kontos.
Ohne async kommt die Antwort nach Abschluss der Berechnung (einige Sekunden pro Feld) mit den neuen Werten. Mit async: true lautet die Antwort sofort 202 und die Berechnung läuft im Hintergrund: Lesen Sie die Werte danach mit GET /api/contacts/{id}/ai-fields.
Damit sie nach jeder Unterhaltung von selbst aktualisiert werden, wählen Sie die Minuten unter Benutzerdefinierte Felder → „KI-Felder automatisch aktualisieren“.
Häufige Fehler: 401 API-Schlüssel fehlt oder ist falsch — 403 Tarif abgelaufen, kein API-Zugang oder KI für das Konto ausgeschaltet (code: account_ai_off) — 404 Kontakt nicht gefunden — 422 kein KI-Feld, unbekanntes Feld oder ungültige Sprache — 429 mehr als 30 KI-Anfragen pro Minute für das Konto: nach den in Retry-After genannten Sekunden erneut versuchen — 502 die KI hat nicht geantwortet (KI-Guthaben prüfen).

Parameter

5 · 2 Pflichtfelder
apikey erforderlich
Ihr API Key (der Header X-API-Key funktioniert ebenfalls).
id erforderlich
Kontakt-ID (Ganzzahl, im Pfad). Verwenden Sie GET /api/contacts, um sie zu finden.
fields optional
Nur diese KI-Felder: Liste von Namen oder IDs (auch durch Kommas getrennt). Fehlt der Parameter, alle KI-Felder.
async optional
true, um sofort die Antwort 202 zu erhalten und im Hintergrund zu berechnen.
locale optional
Sprache der Antworten: it, en, es, fr, de, pt. Fehlt er, die in Benutzerdefinierte Felder gewählte, sonst Italienisch.
Brauchen Sie Hilfe bei der Integration? info@sendapp.live