Para crear una oportunidad vía API, es necesario obtener previamente el ID del embudo, el ID de la etapa (step) y el ID del contacto en Flow. Con esta información, la oportunidad puede crearse y vincularse correctamente en el CRM.

Paso 1: Listar Embudos y Etapas (Steps)

Primero, debes listar todos los embudos disponibles junto con sus respectivas etapas.

Endpoint

GET {{host}}/api/funnels?include_steps=true

Qué hacer con la respuesta

• Identificar el embudo deseado
• Copiar el id del embudo
• Dentro de ese embudo, identificar la etapa (step) correcta
• Copiar el id de la etapa

Estos dos valores se utilizarán en la creación de la oportunidad.

Paso 2: Obtener el ID del Contacto en Flow

Ahora es necesario obtener el ID del contacto en Flow, que será vinculado a la oportunidad.

Endpoint

GET {{host}}/api/contacts/?phone={{phone}}

Observaciones importantes

• El parámetro phone debe contener el número de teléfono del contacto
• La respuesta devolverá los datos del contacto
• Copia el campo id, ya que este será el contactId utilizado en la creación de la oportunidad

Paso 3: Crear la Oportunidad

Con toda la información en mano (embudo, etapa y contacto), ya puedes crear la oportunidad.

Endpoint

POST https://api.crm.poli.digital/api/cards

Body (JSON)

{
  "title": " ",
  "funnelId": " ",
  "funnelStepId": " ",
  "status": 1,
  "uniqueValue": 1,
  "recurrentValue": 1,
  "companyId": null,
  "ticketCategoryId": 1,
  "labelIds": [1],
  "contactId": 12721125,
  "type": 1
}

Después de recopilar los IDs necesarios y realizar la solicitud de creación, la oportunidad será creada en el embudo y la etapa seleccionados, ya asociada al contacto correcto. Este proceso es ideal para integraciones y automatizaciones vía API.

Para más información, consulta la documentación oficial de la API de Triction:
https://triction.readme.io/reference/cardsapicontroller_create