SendApp Docs
Accedi

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