Actualizar negociación

Actualiza parcialmente una negociación: título, importe, moneda, agente o departamento.

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}

Actualiza parcialmente una negociación: título, importe, moneda, agente o departamento.

Las transiciones de etapa tienen su propio endpoint: PATCH /deals/{dealId}/stage.

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
`title`	string	No	Título de la negociación `minLength: 1` · `maxLength: 120`
`amount`	['number', 'null']	No	Valor monetario de la negociación `minimum: 0` · `maximum: 999999999` · `format: float`
`currency`	['string', 'null']	No	Código de moneda ISO 4217, o null para restablecerla al valor predeterminado del pipeline `minLength: 3` · `maxLength: 3`
`agent`	['string', 'null']	No	ID de usuario del agente asignado a la negociación `minLength: 24` · `maxLength: 24` · `pattern: ^[0-9A-Fa-f]{24}$`
`department`	['string', 'null']	No	ID del departamento asignado a la negociación `minLength: 24` · `maxLength: 24` · `pattern: ^[0-9A-Fa-f]{24}$`

Respuestas

Código	Descripción
`200`	Negociación actualizada
`400`	Datos de consulta o de cuerpo de la solicitud no válidos
`401`	No autorizado: token de API no válido o ausente
`403`	Faltan los permisos necesarios
`404`	Negociación 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

// Update the deal amount
curl --request PATCH \
  --url https://api.getincloud.ai/v1/deals/{dealId} \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"amount":2500}'

AnteriorSincronizar mensajes del chat SiguienteActualizar nota de una negociación

¿Te sirvió esta página?