Para criar uma oportunidade via API, é necessário obter previamente o ID do funil, o ID da etapa (step) e o ID do contato no Flow. Com essas informações, a oportunidade pode ser criada e vinculada corretamente no CRM.

Etapa 1: Listar Funis e Etapas (Steps)

Primeiramente, você deve listar todos os funis disponíveis junto com suas respectivas etapas.

Endpoint

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

O que fazer com a resposta

• Identifique o funil desejado
• Copie o id do funil
• Dentro desse funil, identifique a etapa (step) correta
• Copie o id do step

Esses dois valores serão usados na criação da oportunidade.

Etapa 2: Obter o ID do Contato no Flow

Agora é necessário buscar o ID do contato no Flow, que será vinculado à oportunidade.

Endpoint

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

Observações importantes

• O parâmetro phone deve conter o número do contato
• A resposta retornará os dados do contato
• Copie o campo id, pois esse será o contactId usado na criação da oportunidade

Etapa 3: Criar a Oportunidade

Com todas as informações em mãos (funil, step e contato), você já pode criar a oportunidade.

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
}

Após coletar os IDs necessários e realizar a requisição de criação, a oportunidade será criada no funil e etapa desejados, já associada ao contato correto. Esse processo é ideal para integrações e automações via API. Qualquer duvida, acessar a api oficial da Triction: https://triction.readme.io/reference/cardsapicontroller_create