Contactos
Actualizar Contacto
Actualiza los datos de un contacto existente
PATCH
Actualiza uno o más campos de un contacto. Solo envía los campos que quieres modificar.
Los campos no incluidos en la request permanecen sin cambios.
Path Parameters
string
required
UUID del contacto a actualizar
Body Parameters
Todos los campos son opcionales. Solo se actualizan los campos enviados.Información Básica
string
Nombre completo
string
Email (debe ser válido)
string
URL de imagen de perfil
string
Notas internas
Tags
string[]
Reemplaza todos los tags existentes
string[]
Agrega tags sin eliminar los existentes
string[]
Elimina tags específicos
Campos Personalizados
object
Campos personalizados (se fusionan con los existentes)
object
IDs externos (se fusionan con los existentes)
Funnel y Origen
string
UUID de nueva etapa del funnel. Envía
null para quitar la etapa.string
Origen del contacto
Información de Empresa
string
Nombre de empresa
string
Dirección
string
Ciudad
string
Estado/Provincia
string
Código postal
string
Código de país ISO (2 letras)
Asignación de Agente
string | null
UUID del agente humano a asignar. Obtén IDs con GET /team/v1. Envía
null para quitar la asignación.Al asignar un agente:- Todas las conversaciones activas del contacto se reasignan automáticamente
- Las conversaciones futuras del contacto también se asignarán a este agente
Ejemplos
Actualizar Nombre y Email
Agregar Tags (sin eliminar existentes)
Actualizar Campos Personalizados
Los
custom_fields se fusionan con los existentes. Si el contacto tenía { "company": "Acme" } y envías { "last_purchase": "2026-01-28" }, el resultado será { "company": "Acme", "last_purchase": "2026-01-28" }.Mover a Nueva Etapa del Funnel
Asignar Agente Humano
Respuesta Exitosa
Errores
Próximos Pasos
Operaciones Masivas
Actualizar múltiples contactos
Eliminar Contacto
Eliminar contacto
Fusionar Contactos
Combinar duplicados
Listar Tags
Ver tags disponibles