SendApp Docs
Iniciar sesión

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