<aside>
❗ Importante: con fecha 2024-06-28 se movió la funcionalidad de subir archivos a un nuevo endpoint Subir archivo a un Deal . Este endpoint “Crear Deal” ahora recibe únicamente un body JSON con los fields dentro de una llave fields
.
</aside>
Crea un deal en un flow. Los parámetros exactos que espera la creación de un deal dependen del flow en particular para el que se quiere crear y se pueden obtener de Obtener información de un Flow.
Este endpoint acepta body únicamente en formato application/json y no acepta la subida de archivos. Si se quieren subir archivos debe utilizarse el endpoint Subir archivo a un Deal .
Todas las variables que se quieran rellenar de una tarjeta deben ir como llaves individuales de un objeto con llave fields
y soportan recibir un valor directo (ej: center: 1
) o un objeto con un value y un label ({ value, label }
) de la siguiente forma:
{
value: any; // Depende del field
label: string;
}
El CRM guardará como valor del field el campo value
, pero mostrará en la interfaz el valor del campo label
(ej: center: { value: 1, label: "Clínica 1" }
).
Para las variables tipo select
, se debe mandar obligatoriamente su valor como el objeto { value, label }
descrito anteriormente.
crm/integration-generic/deals
POST
Este endpoint requiere autorización según se indica en Authorization
Nombre del dato | Tipo Dato | Descripción | Requerido |
---|---|---|---|
flowId |
string (UUID) | UUID del flow donde se quiere crear el deal | Sí |
statusId |
integer | Id del estado en que se creará el deal dentro del flow. La lista de estados posibles se puede obtener de Obtener información de un Flow | Sí |
assignee |
string (UUID) | UUID de usuario al que se le asignará el deal. La lista de usuarios válidos se puede obtener de ‣. | No |
fields |
`{ | ||
[key: string]: |
string |
number |
field
}` | Cada una de las variables del deal que se quiere rellenar.
[key: string]
) el nombre del campo como stringstring | number
) o un objeto field
con value y label.field
Nombre del dato | Tipo Dato | Descripción |
---|---|---|
value |
string | Valor real de la variable en CRM |
label |
string | Valor mostrado en la interfaz de CRM para la variable |