---
title: "Cadastrar interação de lead"
method: POST
path: "/leads/{idLead}/interacoes"
tags: ["Interações de Lead"]
---

# Cadastrar interação de lead

`POST /leads/{idLead}/interacoes`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api/v4/comercial`
- URL: `https://integracao.cvcrm.com.br/api/v4/comercial/leads/{idLead}/interacoes`
- Auth: HTTP bearer

> 🔒 **Autenticação necessária**
>
> Esta API utiliza **Bearer Token** no header Authorization.
> Consulte o tutorial completo antes de fazer sua primeira chamada:
> [Como autenticar nas APIs do CV CRM (v3+ — Bearer Token)](https://desenvolvedor.cvcrm.com.br/docs/como-autenticar-nas-apis-do-cv-crm-com-bearer-token)

## Path parameters

- `idLead` integer, required

## Request body

- object
  - `tipo` 'A' | 'L' | 'E' | 'S' | 'W', required: Tipo da interação (A=anotação, L=ligação, E=email, S=sms, W=whatsapp). Tarefa (T) e visita (V) têm APIs próprias e não são criadas por aqui.
  - `descricao` string, required
  - `situacaoLigacao` 'A' | 'NA' | 'NE', nullable: Situação da ligação — obrigatória quando tipo=L (A=Atendida, NA=Não Atendida, NE=Não Existe).
  - `audioUrl` string, nullable: URL de um áudio já hospedado externamente (ex. gravação de ligação). Mutuamente exclusivo com audioBase64. Extensões permitidas: mp3, ogg, wav.
  - `audioBase64` string, nullable: Conteúdo do áudio em base64. Mutuamente exclusivo com audioUrl. Extensões permitidas: mp3, ogg, wav.
  - `enviarGestor` boolean
  - `enviarImobiliaria` boolean
  - `enviarCorretor` boolean
  - `enviarCliente` boolean
  - `recalcularVencimentoLead` boolean, nullable

## Response `201`

Interação de lead criada

- object
  - `status` string
  - `code` integer
  - `data` object
    - `idInteracao` integer

## Other responses

- `400`: Dados de entrada inválidos
- `401`: Token JWT ausente ou inválido
- `403`: Usuário autenticado sem permissão para o recurso
- `422`: Falha de validação de campo (ex. situacaoLigacao ausente para tipo=L)

---

[API](https://skmtc.dev/cvcrm/apis/api-intera-es-de-lead.md) - [All operations](https://skmtc.dev/cvcrm/apis/api-intera-es-de-lead/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/api-intera-es-de-lead/revisions/12d40f7b699c?raw)