Crear pipeline

Crea un nuevo pipeline de ventas en la cuenta.

API de WhatsApp y CRM

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

POST https://api.getincloud.ai/v1/pipelines

Crea un nuevo pipeline de ventas en la cuenta.

Un pipeline requiere al menos una etapa abierta, una ganada y una perdida. El orden de las etapas es el orden del array, y las etapas ganada y perdida deben ir después de todas las abiertas: un trato avanza a la siguiente etapa abierta según su posición, por lo que una etapa terminal en medio sería omitida. Cuando no se proporcionan etapas, se genera un conjunto predeterminado.

Nota: este recurso de la API está disponible en la suscripción Platform Professional y superiores.

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 prueba 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
`name`	string	Sí	Nombre del pipeline `minLength: 2` · `maxLength: 30`
`description`	string	No	Descripción del pipeline. Opcional `minLength: 0` · `maxLength: 300`
`color`	string	No	Nombre del color del pipeline, usado para identificarlo rápidamente `minLength: 1` · `maxLength: 30`
`icon`	string	No	Identificador del icono del pipeline. Por defecto es `funnel-dollar` `enum: ['funnel-dollar', 'filter', 'chart-line', 'handshake', 'money-bill-wave', 'bullseye', 'flag-checkered', 'coins', 'chart-pie', 'briefcase']`
`devices`	array<string>	No	Dispositivos que alimentan este pipeline. Vacío significa todos los dispositivos de la cuenta
`currency`	string	No	Código de moneda ISO 4217 para los montos de los tratos. Por defecto es la moneda de la cuenta `minLength: 3` · `maxLength: 3`
`entry`	object	No	Configuración de la regla de entrada
`entry.mode`	string	No	Cómo entran los chats a este pipeline: manual, filter o all. Si se omite, se conserva el valor guardado `enum: ['manual', 'filter', 'all']`
`entry.filters`	object	No	Filtros de entrada, solo se usan cuando mode es filter
`stages`	array<object>	No	Etapas del pipeline, en orden. Se requieren al menos una etapa abierta, una ganada y una perdida, y las etapas ganada y perdida deben ir después de todas las abiertas. Si se omiten, se generan las predeterminadas
`lostReasons`	array<string>	No	Motivos de pérdida predefinidos que se ofrecen cuando se pierde un trato
`settings`	object	No	Ajustes de comportamiento del pipeline
`settings.closeChatOnWon`	boolean	No	Resolver el chat cuando se gana el trato
`settings.closeChatOnLost`	boolean	No	Resolver el chat cuando se pierde el trato
`settings.ai`	object	No	Ajustes del análisis con IA

Respuestas

Código	Descripción
`200`	Pipeline creado
`400`	Configuración de pipeline no válida
`401`	Acceso no autorizado por token de API no válido o vencido
`403`	Operación no admitida: se requiere actualizar el plan
`404`	Recurso no encontrado
`409`	Ya existe un pipeline con el mismo nombre
`429`	Se alcanzó el máximo de pipelines permitidos
`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

// Create a sales pipeline
curl --request POST \
  --url https://api.getincloud.ai/v1/pipelines \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"name":"Sales","color":"blue"}'

AnteriorCrear nota de oportunidad SiguienteDescartar la alerta de riesgo de IA

¿Te sirvió esta página?