Calculer les champs IA d'un contact
POST
https://app.sendapp.ai/api/contacts/{id}/ai-fields
L'IA lit les conversations du contact et remplit ses champs personnalisés de type
ai, comme le bouton de la fiche du contact. Chaque champ calculé utilise le crédit IA du compte. Sans
async, la réponse arrive une fois le calcul terminé (quelques secondes par champ) avec les nouvelles valeurs. Avec async: true, la réponse est 202 immédiatement et le calcul se fait en arrière-plan : lisez les valeurs ensuite avec GET /api/contacts/{id}/ai-fields.Pour qu'ils se mettent à jour seuls après chaque conversation, choisissez les minutes dans Champs personnalisés → « Mettre à jour les champs IA automatiquement ».
Erreurs courantes :
401 clé API manquante ou erronée — 403 forfait expiré, sans accès API ou IA désactivée pour le compte (code: account_ai_off) — 404 contact introuvable — 422 aucun champ IA, champ inconnu ou langue non valide — 429 plus de 30 requêtes IA par minute pour le compte : réessayez après les secondes indiquées dans Retry-After — 502 l'IA n'a pas répondu (vérifiez le crédit IA).Paramètres
5 · 2 obligatoires
apikey
obligatoire
Votre API Key (l'en-tête
X-API-Key fonctionne aussi).
id
obligatoire
ID du contact (entier, dans le chemin). Utilisez
GET /api/contacts pour le trouver.
fields
facultatif
Uniquement ces champs IA : liste de noms ou d'ID (séparés par des virgules aussi). S'il manque, tous les champs IA.
async
facultatif
true pour obtenir tout de suite la réponse 202 et calculer en arrière-plan.
locale
facultatif
Langue des réponses :
it, en, es, fr, de, pt. S'il manque, celle choisie dans Champs personnalisés, sinon l'italien.
Besoin d'aide pour l'intégration ? info@sendapp.live