SendApp Docs
Entrar

Calcular os campos de IA de um contacto

POST https://app.sendapp.ai/api/contacts/{id}/ai-fields
A IA lê as conversas do contacto e preenche os seus campos personalizados do tipo ai, como o botão na ficha do contacto. Cada campo calculado usa o crédito de IA da conta.
Sem async a resposta chega com o cálculo concluído (alguns segundos por campo) com os novos valores. Com async: true a resposta é 202 de imediato e o cálculo corre em segundo plano: leia os valores depois com GET /api/contacts/{id}/ai-fields.
Para que se atualizem sozinhos após cada conversa, escolha os minutos em Campos personalizados → «Atualizar os campos de IA automaticamente».
Erros comuns: 401 chave API em falta ou errada — 403 plano expirado, sem acesso à API ou IA desligada na conta (code: account_ai_off) — 404 contacto não encontrado — 422 nenhum campo de IA, campo desconhecido ou idioma inválido — 429 mais de 30 pedidos de IA por minuto na conta: tente de novo após os segundos indicados em Retry-After — 502 a IA não respondeu (verifique o crédito de IA).

Parâmetros

5 · 2 obrigatórios
apikey obrigatório
A sua API Key (o cabeçalho X-API-Key também funciona).
id obrigatório
ID do contacto (inteiro, no path). Use GET /api/contacts para o encontrar.
fields opcional
Só estes campos de IA: lista de nomes ou ID (também separados por vírgula). Se faltar, todos os campos de IA.
async opcional
true para receber logo a resposta 202 e calcular em segundo plano.
locale opcional
Idioma das respostas: it, en, es, fr, de, pt. Se faltar, o escolhido em Campos personalizados; caso contrário, o italiano.
Precisa de ajuda com a integração? info@sendapp.live