Calcola i campi AI di un contatto
POST
https://app.sendapp.ai/api/contacts/{id}/ai-fields
L'AI legge le conversazioni del contatto e compila i suoi campi personalizzati di tipo
ai, come il pulsante nella scheda del contatto. Ogni campo calcolato usa il credito AI dell'account. Senza
async la risposta arriva a calcolo finito (qualche secondo per campo) con i valori nuovi. Con async: true la risposta è subito 202 e il calcolo avviene in background: leggi i valori dopo con GET /api/contacts/{id}/ai-fields.Per aggiornarli da soli dopo ogni conversazione, scegli i minuti in Campi personalizzati → «Aggiorna i campi AI in automatico».
Errori comuni:
401 chiave API mancante o sbagliata — 403 piano scaduto, senza accesso API o AI spenta per l'account (code: account_ai_off) — 404 contatto non trovato — 422 nessun campo AI, campo sconosciuto o lingua non valida — 429 più di 30 richieste AI al minuto per l'account: riprova dopo i secondi indicati in Retry-After — 502 l'AI non ha risposto (controlla il credito AI).Parametri
5 · 2 obbligatori
apikey
obbligatorio
La tua API Key (anche header
X-API-Key).
id
obbligatorio
ID del contatto (intero, nel path). Usa
GET /api/contacts per trovarlo.
fields
opzionale
Solo questi campi AI: elenco di nomi o ID (anche separati da virgola). Se manca, tutti i campi AI.
async
opzionale
true per avere subito la risposta 202 e calcolare in background.
locale
opzionale
Lingua delle risposte:
it, en, es, fr, de, pt. Se manca, quella scelta in Campi personalizzati, altrimenti l'italiano.
Serve aiuto con l'integrazione? info@sendapp.live