Calcular los campos IA de un contacto
POST
https://app.sendapp.ai/api/contacts/{id}/ai-fields
La IA lee las conversaciones del contacto y rellena sus campos personalizados de tipo
ai, como el botón de la ficha del contacto. Cada campo calculado usa el crédito IA de la cuenta. Sin
async la respuesta llega cuando termina el cálculo (unos segundos por campo) con los valores nuevos. Con async: true la respuesta es 202 enseguida y el cálculo se hace en segundo plano: lee los valores después con GET /api/contacts/{id}/ai-fields.Para que se actualicen solos tras cada conversación, elige los minutos en Campos personalizados → «Actualizar los campos IA automáticamente».
Errores comunes:
401 clave API ausente o incorrecta — 403 plan caducado, sin acceso a la API o IA desactivada en la cuenta (code: account_ai_off) — 404 contacto no encontrado — 422 ningún campo IA, campo desconocido o idioma no válido — 429 más de 30 peticiones IA por minuto en la cuenta: reintenta tras los segundos indicados en Retry-After — 502 la IA no ha respondido (revisa el crédito IA).Parámetros
5 · 2 obligatorios
apikey
obligatorio
Tu API Key (también sirve la cabecera
X-API-Key).
id
obligatorio
ID del contacto (entero, en la ruta). Usa
GET /api/contacts para encontrarlo.
fields
opcional
Solo estos campos IA: lista de nombres o ID (también separados por comas). Si falta, todos los campos IA.
async
opcional
true para recibir enseguida la respuesta 202 y calcular en segundo plano.
locale
opcional
Idioma de las respuestas:
it, en, es, fr, de, pt. Si falta, el elegido en Campos personalizados; si no, el italiano.
¿Necesitas ayuda con la integración? info@sendapp.live