--- title: "Añadir leads entrantes del tipo SIP (llamada)" method: POST path: "/api/v4/leads/unsorted/sip" --- # Añadir leads entrantes del tipo SIP (llamada) `POST /api/v4/leads/unsorted/sip` Este método permite añadir uno o varios leads entrantes a la cuenta. ## Headers - `content/type` string ## Request body - object - `RAW_BODY` object[] - `source_uid` string, required — UID de la fuente del lead entrante. Generado por la integración - `source_name` string, required — Nombre de la fuente del lead entrante - `pipeline_id` integer — ID del pipeline al que se añadirá el lead entrante - `created_at` integer — Fecha de creación del lead entrante en formato de Unix Timestamp - `metadata` object — Metadatos del lead entrante. Revisa los parámetros de metadatos de tipo SIP. Campo requerido. - `from` string — Iniciador de la llamada - `phone` integer — Destinatario de la llamada - `called_at` integer — Fecha y hora de la llamada en formato Unix Timestamp - `duration` integer — Duración de la llamada en segundos - `link` string — Enlace a la grabación de la llamada - `service_code` string — Código del proveedor de servicios - `is_call_event_needed` boolean — Este flag no se retorna en la respuesta, pero se puede pasar. Si se pasa el valor "true", el evento de llamada será añadido a la tarjeta de la entidad. - `call_responsible` string — A quién se realizó la llamada. Puedes pasar el ID de usuario de Kommo, el número de teléfono o el nombre - `_embedded` object - `contacts` object[] — Datos relacionados con el contacto del lead entrante. Siempre consiste en un objeto. - `id` integer — ID del contacto - `name` string — Nombre completo del contacto - `first_name` string — Nombre del contacto - `last_name` string — Apellido del contacto - `responsible_user_id` integer — ID del contacto responsable - `created_by` integer — ID del usuario que creó el contacto - `updated_by` integer — ID del usuario que actualizó el contacto por última vez - `created_at` integer — Fecha de creación del contacto en formato de Unix Timestamp - `updated_at` integer — Fecha de actualización del contacto en formato de Unix Timestamp - `custom_fields_values` string, json — Un arreglo de los valores actuales de los campos personalizados del contacto - `_embedded` object - `tags` object[] - `id` integer — ID de la etiqueta. - `name` string — Nombre de la etiqueta. - `tags_to_add` object[] — Arreglo de etiquetas para añadir Debes pasar ya sea el nombre o el ID de la etiqueta. - `id` integer — ID de la etiqueta. - `name` string — Nombre de la etiqueta. - `request_id` string — El campo será retornado sin cambios en la respuesta y no se guardará. - `companies` object[] — Datos relacionados con la compañía del lead entrante. Siempre consiste en un objeto. - `id` integer — ID de la compañía - `name` string — Nombre de la compañía - `responsible_user_id` integer — ID del usuario responsable de la compañía - `created_by` integer — El ID del usuario que creó la compañía - `updated_by` integer — El ID del usuario que actualizó la compañía por última vez - `created_at` integer — Fecha de creación de la compañía en formato de Unix Timestamp - `updated_at` integer — Fecha de actualización de la compañía en formato de Unix Timestamp - `custom_fields_values` string, json — Un arreglo de los valores actuales de los campos personalizados de la compañía - `_embedded` object - `tags` object[] - `id` integer — ID de la etiqueta. - `name` string — Nombre de la etiqueta. - `tags_to_add` object[] — Arreglo de etiquetas para añadir Debes pasar ya sea el nombre o el ID de la etiqueta. - `id` integer — ID de la etiqueta. - `name` string — Nombre de la etiqueta. - `request_id` string — El campo será retornado sin cambios en la respuesta y no se guardará. - `leads` object[] — Datos relacionados con el lead al que el lead entrante está conectado. Siempre consiste en un objeto. - `name` string — Nombre del lead - `price` integer — Venta del lead - `status_id` integer — ID de la etapa a la que se añade el lead. Por defecto, es la primera etapa del pipeline principal. - `pipeline_id` integer — ID del pipeline al que se añade el lead. - `created_by` integer — El ID del usuario que crea el lead. Al pasar el valor 0, el lead será considerado como creado por el robot. - `updated_by` integer — El ID del usuario que actualiza el lead. Al pasar el valor 0, el lead será considerado como creado por el robot. - `created_at` integer — Fecha de creación del lead en formato de Unix Timestamp. - `updated_at` integer — Fecha de actualización del lead en formato de Unix Timestamp. - `closed_at` integer — Fecha de cierre del lead en formato de Unix Timestamp. - `loss_reason_id` integer — ID del motivo de pérdida del lead. - `responsible_user_id` integer — ID del usuario responsable del lead. - `custom_fields_values` string, json — Un arreglo de los valores actuales de los campos personalizados del lead. - `_embedded` object — Entidades asociadas del lead. - `tags` object[] — Etiquetas vinculadas al lead - `id` integer — ID de la etiqueta. - `name` string — Nombre de la etiqueta. - `contacts` object[] — Contactos vinculados al lead - `id` integer — ID del contacto - `is_main` boolean — Indica si el contacto es principal o no - `companies` object[] — Compañía vinculada al lead. Puedes asignar solo 1 compañía - `id` integer — ID de la compañía - `source` object — Fuente del lead. - `external_id` string — ID externo de la fuente. Una fuente puede ser añadida utilizando la API de Fuentes. Si se pasa el external_id de la fuente y no se pasa el pipeline_id, el lead se añadirá al pipeline donde se encuentra la fuente. - `type` string — Tipo de fuente. Para leads añadidos por integraciones, solo se admite el widget. - `tags_to_add` object[] — Arreglo de etiquetas para añadir Debes pasar ya sea el nombre o el ID de la etiqueta. - `id` integer — ID de la etiqueta. - `name` string — Nombre de la etiqueta. - `request_id` string — Campo que será retornado sin cambios en la respuesta y que no será guardado. ## Response `200` 200 - object ## Other responses - `400` — 400 --- [API](https://skmtc.dev/kommo/apis/kommo-api.md) · [All operations](https://skmtc.dev/kommo/apis/kommo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kommo/kommo-api/revisions/e291c0b2038d/schema)