SendApp Docs
Se connecter

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