AgentclicAgentclic
Crear token
Secciones

Contactos

Actualizar contacto

PATCH/clients/{clientId}/contacts/{id}

Cambia los datos, la etapa o los campos personalizados de un contacto.

Solo se cambian los campos que envíes. Un texto vacío o null borra ese dato.

No puede quedar sin nombre, email y teléfono a la vez. Si el email o el teléfono nuevos los tiene otro contacto, responde 409 y no cambia nada.

Autenticación

Cabecera Authorization: Bearer ack_live_…. Permiso necesario: contacts:write. Cada llamada correcta consume créditos (créditos y límites).

Parámetros de la ruta

clientIduuidobligatorio

Id del cliente.

iduuidobligatorio

Id del contacto.

Cuerpo (JSON)

namestring

Nombre (hasta 160 caracteres).

emailstring

Email. Se guarda en minúsculas.

phonestring

Teléfono. Se normaliza igual que en el panel (p. ej. «600 11 22 33» y «600112233» son el mismo).

companystring

Empresa.

notesstring

Notas (hasta 2.000 caracteres).

stageIduuid | null

Etapa del CRM del cliente (ver «Opciones del CRM»).

customFieldsobject

Campos personalizados: { idDelCampo: valor }. Un valor vacío o null borra el dato.

Respuestas

200Correcto. Consume créditos.
401UNAUTHORIZED · Falta el token o no es válido.
401TOKEN_REVOKED · El token se ha revocado.
401TOKEN_EXPIRED · El token ha caducado.
403PLAN_REQUIRED · La cuenta no tiene el plan Agentes ilimitados.
402NO_CREDITS · No quedan créditos en la cuenta.
429RATE_LIMITED · Más de 60 llamadas por minuto con el mismo token.
403FORBIDDEN_SCOPE · El token no tiene el permiso necesario.
404NOT_FOUND · El cliente no existe, no es tuyo o el token está limitado a otro cliente.
404NOT_FOUND · El contacto no existe en ese CRM.
409CONTACT_EXISTS · El email o el teléfono nuevos ya los tiene otro contacto.
422VALIDATION_ERROR · Algún dato no es válido.

Las respuestas de error no consumen créditos.