Mover oportunidad a otra etapa

Mueve una oportunidad a otra etapa de su embudo.

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}/stage

Mueve una oportunidad a otra etapa de su embudo.

previousStage es obligatorio y se verifica de forma atómica en la base de datos: cuando ya no coincide con la etapa actual (alguien más movió la tarjeta primero), la solicitud falla con 409 y ninguna acción ni webhook se dispara dos veces. Recarga e inténtalo de nuevo.

Al mover una oportunidad a una etapa de ganada o perdida, esta se cierra; al devolver una oportunidad cerrada a una etapa abierta, se reabre. Las acciones de la etapa (asignar agente o departamento, agregar o quitar etiquetas) se ejecutan en segundo plano sobre el chat vinculado.

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
`stage`	string	Sí	ID de la etapa de destino. Obligatorio `minLength: 24` · `maxLength: 24` · `pattern: ^[0-9A-Fa-f]{24}$`
`previousStage`	string	Sí	Etapa que el cliente vio por última vez. La solicitud se rechaza con 409 cuando ya no coincide, de modo que los movimientos concurrentes nunca se sobrescriben entre sí `minLength: 24` · `maxLength: 24` · `pattern: ^[0-9A-Fa-f]{24}$`
`lostReason`	string	No	Motivo por el que se perdió la oportunidad. Solo tiene sentido al mover a una etapa de perdida `minLength: 1` · `maxLength: 60`

Respuestas

Código	Descripción
`200`	Oportunidad movida
`400`	La etapa no pertenece al embudo
`401`	No autorizado: token de API inválido o ausente
`403`	Operación no compatible: se requiere actualizar el plan
`404`	Oportunidad no encontrada
`409`	La etapa de la oportunidad cambió mientras tanto: recarga e inténtalo de nuevo
`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

// Move a deal to the negotiation stage
curl --request PATCH \
  --url https://api.getincloud.ai/v1/deals/{dealId}/stage \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"stage":"5f7b1b1b1b1b1b1b1b1b1b1d","previousStage":"5f7b1b1b1b1b1b1b1b1b1b1c"}'

AnteriorListar tareas de la cuenta SiguienteObtener negociación

¿Te sirvió esta página?