Actualizar Campo Personalizado
Actualiza un campo personalizado existente. Solo se modifican los campos proporcionados en la solicitud.
PATCH https://api.platica.mx/v1/custom-fields/{fieldId} Parámetros de URL
| Parámetro | Tipo | Descripción | Requerido |
|---|---|---|---|
fieldId | string | Identificador único del campo personalizado | ✓ |
Cuerpo de la solicitud
{
"description": "Tipo de membresía actual del cliente",
"automatic": true,
"overwritable": false
} Parámetros del cuerpo
Todos los parámetros son opcionales, pero la solicitud debe incluir al menos uno.
| Parámetro | Tipo | Descripción |
|---|---|---|
description | string | Descripción del campo (máx. 500 caracteres) |
automatic | boolean | Si la IA debe llenar el campo automáticamente desde la conversación |
overwritable | boolean | Si la IA puede sobrescribir el valor existente del campo |
options | array | Solo select. Reemplaza por completo el catálogo de opciones. Debe quedar al menos una opción activa (no archivada). Máximo 50 opciones. |
ordered | boolean | Solo select. Indica si las opciones son una secuencia ordenada (etapas/pasos). |
Editar las opciones de un campo select
Envía el catálogo completo de opciones en options. Conserva el id de las opciones existentes para no romper los valores ya guardados en los clientes; las opciones sin id se tratan como nuevas.
{
"ordered": true,
"options": [
{ "id": "nuevo", "label": "Nuevo" },
{ "id": "contactado", "label": "Contactado" },
{ "id": "cerrado", "label": "Cerrado", "archived": true },
{ "label": "Ganado" }
]
} Respuesta
{
"status": "success",
"message": "Custom field updated successfully",
"data": {
"id": "nivel_de_membresia"
}
} Notas
nameytypeson inmutables después de crear el campo. Para cambiarlos, elimina el campo y créalo de nuevo.- En un campo
select, para "eliminar" una opción márcala comoarchived: trueen lugar de quitarla del arreglo: así se conservan los valores históricos en los clientes y la opción deja de ofrecerse para nuevas asignaciones. optionsyorderedsolo aplican a camposselect; en otros tipos se ignoran.- Si el campo no existe o fue eliminado previamente, la API devolverá
404.