Interações de Lead

Cadastrar interação de lead

🔒 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)

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

Path parameters

idLeadinteger required

Identificador do lead

Request body

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.

descricaostring 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).

audioUrlstring nullable

URL de um áudio já hospedado externamente (ex. gravação de ligação). Mutuamente exclusivo com audioBase64. Extensões permitidas: mp3, ogg, wav.

audioBase64string nullable

Conteúdo do áudio em base64. Mutuamente exclusivo com audioUrl. Extensões permitidas: mp3, ogg, wav.

enviarGestorboolean
enviarImobiliariaboolean
enviarCorretorboolean
enviarClienteboolean
recalcularVencimentoLeadboolean nullable

Example request

{
  "tipo": "L",
  "descricao": "Cliente retornará amanhã",
  "situacaoLigacao": "A",
  "audioUrl": "https://cdn.exemplo.com/ligacoes/48213-01.mp3"
}

Response

Interação de lead criada

statusstring
codeinteger

Example response

{
  "status": "sucesso",
  "code": 201,
  "data": {
    "idInteracao": 501
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.