Actualizar nota de una negociación

Edita una nota, prográmala o márcala como completada.

API de WhatsApp y CRM

Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.

PATCH https://api.getincloud.ai/v1/deals/{dealId}/notes/{noteId}

Edita una nota, prográmala o márcala como completada.

Editar el texto o la fecha de vencimiento está reservado al autor de la nota y a

administradores y supervisores. Completar una tarea no lo está: cualquier persona que pueda ver la

negociación puede marcar el trabajo como hecho.

Envía dueAt: null para convertir una tarea de nuevo en una nota simple.

Pasa files para cambiar los adjuntos. Es la lista COMPLETA que la nota

debe tener después, no un delta: los ids que omitas se desvinculan, los ids

que mantengas siguen adjuntos y [] los elimina todos. Sube cualquier archivo nuevo

antes mediante POST /files con permission=public. Se aplican los mismos límites

que al crear. Un archivo desvinculado NO se elimina y sigue protegido

de la limpieza por retención, porque el mismo archivo puede estar adjunto en otro lugar.

Prueba este endpoint en el probador de API en vivo

>¿Necesitas ayuda? Explora todos los tutoriales, más de 100 ejemplos de casos de uso y juega con el probador de API en vivo con ejemplos de código listos para usar en más de 15 lenguajes de programación, incluidos JavaScript/Node.js, PHP, Python, C#, Java, Ruby, Swift, Kotlin, Powershell, cURL y más.

Autenticación

Envía tu API key en el encabezado Token en cada petición.

Cuerpo de la petición

Campo	Tipo	Obligatorio	Descripción
`text`	string	No	Cuerpo de la nota `minLength: 1` · `maxLength: 2000`
`dueAt`	['string', 'null']	No	Fecha de vencimiento, o null para convertir la tarea de nuevo en una nota simple `format: date-time`
`done`	boolean	No	Completa la tarea o la reabre
`files`	array<string>	No	La lista completa de ids de adjuntos que la nota debe tener después de la actualización, hasta 3. Los ids que no estén en la lista se desvinculan; un arreglo vacío los elimina todos. Sube primero los archivos nuevos con POST /files

Respuestas

Código	Descripción
`200`	Nota actualizada
`400`	Carga de la nota no válida, o un adjunto que no existe, es demasiado grande o es de un tipo no admitido
`401`	No autorizado - Token de API no válido o ausente
`403`	Operación no admitida - se requiere mejorar el plan, o la nota pertenece a otro usuario
`404`	Negociación o nota no encontrada
`409`	Conflicto
`429`	Demasiadas solicitudes - Inténtalo de nuevo más tarde
`500`	Error inesperado
`501`	No implementado
`503`	Servicio no disponible temporalmente - Inténtalo de nuevo más tarde

// This code example requires you to have installed curl package
// Installation instructions here: https://curl.haxx.se/download.html

// Complete a task
curl --request PATCH \
  --url https://api.getincloud.ai/v1/deals/{dealId}/notes/{noteId} \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"done":true}'

AnteriorActualizar negociación SiguienteActualizar pipeline

¿Te sirvió esta página?