Centro de ayudaIntegraciones

Para: Administradores

Agregue notas a los casos con una clave central

Crea notas internas sobre un caso desde tu propio software, asígnales un documento y archivos, y elige qué roles pueden verlas.

En este artículo7 secciones

Antes de empezar

Esta página trata sobre cómo agregar y leer los datos de un caso. NotasNotas Notas internas sobre un caso que solo pueden ver las personas cuyo rol lo permite; los clientes no pueden verlas a menos que la firma cambie eso. Con una clave de concentración. Los caminos están bajo… https://prd-api-app.caseactive.com/v1/<hub id>/<case id>.

Llamadas

LlamarLo que hace
GET /notes/templatesLista de los plantillas de notas que tienes.
POST /notesSe crea una nota.
GET /notesLista las notas relacionadas con el caso, empezando por las más recientes.
GET /notes/<note_id>Lee una nota.
PUT /notes/<note_id>Cambia el título de una nota o quién puede verla.
DELETE /notes/<note_id>Se elimina una nota, junto con sus archivos relacionados.

Una nota es un documento que se guarda en un caso específico, para su equipo, junto con todos los archivos relacionados con él. El contenido de la nota consiste en el propio documento; se puede comenzar desde una plantilla o cargar un archivo PDF o Word una vez que la nota ya esté lista. No hay campos de texto disponibles para la escritura. Nadie recibe notificaciones sobre cuándo se agrega o modifica una nota, y las notas no envían ningún tipo de señales web.

Crear una nota

CampoLo que haceRequeridoPor defecto
nameEl título de la nota. Letras, números, espacios y & ' - _ ( ) . /; sin comas, dos puntos, signos de interrogación o guiones.Sí.—
permissionsLos rolesPapel Un conjunto de permisos que determina qué puede ver y hacer una persona en un caso, como por ejemplo, el personal o los clientes. que pueden acceder a ella, como por ejemplo ["role::staff"]. Solo los roles que pueden leer las notas.No.Las funciones del plantilla, o todas las funciones que pueden leer las notas.
templateDesde {"owner": "host", "template_id": "<asset_id>"} hasta GET /notes/templates: para llevar el documento y los archivos del plantilla. O desde {"owner": "case", "template_id": "<note_id>"}: para copiar una nota relacionada con este caso.No.Ninguno.
curl -X POST https://prd-api-app.caseactive.com/v1/ca-7e6d5c4b3a2f10/cc-1a2b3c4d5e6f70/notes \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Case representation letter", "permissions": ["role::staff"], "template": {"owner": "host", "template_id": "note::20260915101500_5e4d3c2b1a0f90"}}'

Responde a 201 con note_id.

  • A partir de un modelo, la nota obtiene los datos del documento, los archivos y las funciones asociadas al modelo. Los códigos, como el nombre del cliente, se rellenan una vez que se crea la nota. Los códigos relacionados con quien la creó, como su nombre, toman los detalles del Asistente Virtual, que incluyen el nombre de su empresa. El título de la nota no se copia; se envía name.
  • Una copia de una nota sobre este caso también conserva lo que se ha escrito o dibujado en ella, a menos que se envíe schema para reemplazar ese contenido. Los códigos se rellenan nuevamente en el momento en que se hace la copia.
  • Sin un modelo predeterminado, cargue su documento de inmediato: solicite una dirección con media_group=schemas, cargue un archivo en formato PDF o Word, y adjúntelo con PUT /notes/<note_id>/schema/media. Un archivo en formato Word se convierte en PDF. Una nota contiene un solo documento. Consulte Carga y adjunta archivos utilizando la clave de hub.
  • Otros archivos, como fotos o grabaciones, deben adjuntarse con PUT /notes/<note_id>/media.

¿Quién lo ve?

Las personas que ocupan los roles relacionados con las notas pueden abrirlas. El personal, cuyo rol es moderar las notas por defecto, puede ver todas las notas, independientemente de su rol. Los clientes no pueden ver las notas, a menos que un administrador les haya dado acceso a ellas. Para más información, vea ¿Cómo cambiar las funciones de un rol?.

Notas de lectura

GET /notes toma como parámetros limit (por defecto: 20; hasta 1000), start_key, y también las páginas, tal como ocurre en cualquier lista. Una clave lee cada nota del caso. Cada nota contiene lo siguiente:

CampoLo que contiene
note_id, case_idSus identificadores
nameSu título
user_id¿Quién lo creó? Es la identificación del Asistente Virtual, utilizada para indicar si se trata de una nota importante o si se trata de algo automatizado.
permissionsLos roles que podrían verlo… Se han excluido aquellos roles que pueden leer las notas.
schema_mediaEl media_id de su documento
media, media_ctSus documentos y archivos… ¿Cuántos son? Descargalos, tal como se indica en “Subir y adjuntar archivos utilizando una clave de hub”.
schemaLo que la gente escribió o dibujó en el documento, en formato Instant JSON.
template_idEl modelo del cual se trata es el que sirvió de base para su creación.
created_on, updated_onCuando se realizó y se realizó la última modificación, en UTC.

GET /notes/templates Lista de las notas que han sido publicadas. PlantillasPlantilla Un formulario, formulario, firma electrónica, nota o tarea reutilizable que se guarda en la biblioteca y se copia en los expedientes., Los más antiguos primero, y cada uno de ellos… asset_id, title, description y permissions.

Modificar y eliminar

PUT /notes/<note_id> toma name y permissions, y solo modifica aquellos valores que usted envíe. Un “key” puede cambiar cualquier nota en el caso. Una lista vacía de permissions es rechazada: por favor, envíe los valores que deben ser visibles en ese caso. Un cuerpo sin ninguno de estos valores también es rechazado.

DELETE /notes/<note_id> elimina todas las notas, junto con sus documentos y archivos relacionados. Nadie es informado de esto.

Si se rechaza una llamada

EstadomessagePor qué
400SchemaFieldsExceptionSe ha perdido o invalidado un campo. Por ejemplo, puede haber comas en name, una lista vacía en permissions, o alguna función que su centro de control no posee. errors indica el nombre del campo.
400SchemaFieldsException, con ItemCopyNotAllowedException en templateEl plantilla no está publicada, no está disponible para las herramientas automáticas, o sus archivos aún están siendo procesados.
400SchemaFieldsException, con NoteRoleCannotReadNotesException en permissions.<n>Un rollo en permissions no puede leer las notas.
403HostModuleDisabledExceptionLas notas están desactivadas para su centro de control, o escondidas en este caso.
403CaseClosedExceptionEl caso está cerrado.
404ItemNotFoundExceptionLa nota no existe.

Para información sobre el cuerpo de error y los demás códigos, vea Como manejar los errores de la API y los códigos de estado.

Artículos relacionados

Entienda lo que la API puede hacerDescubre qué funciones pueden alcanzar una clave de administración y una clave de concentrador, por qué cada clave actúa como asistente virtual y dónde encontrar la lista técnica completa.IntegracionesCarga y adjunta archivos con una clave de hub.Obtén una dirección de carga, sube un archivo, adjúntalo a una publicación, nota, tarea, formulario o firma electrónica, y descarga los archivos de un caso.IntegracionesAgregar una nota interna a un casoMantén una nota interna sobre el caso, como un documento adjunto a los archivos, y elige qué roles, además del personal, pueden verla.Casos y admisión · 3 minGestionar errores de API y códigos de estadoLea el cuerpo del error, qué significan los códigos 400, 401, 403, 404, 500 y 503, y por qué un elemento que su clave no puede ver responde con el código 404.Integraciones