Leads

Criar Conversa para Lead

Cria uma nova conversa vinculada a um lead existente, com suporte à definição de setor de atendimento.

POST/lead/{id}/conversation

curl --request POST \
  --url 'https://crm.wavups.com/api/v1/lead/clead12345/conversation' \
  --header 'Token: SEU_TOKEN_DE_API' \
  --header 'Content-Type: application/json' \
  --data '{
    "accountChatSectorId": "csector001",
    "contactName": "Maria Silva",
    "contactPhone": "+5511999990000"
  }'

{
  "id": "clconv98765",
  "leadId": "clead12345",
  "accountChatSectorId": "csector001",
  "contactName": "Maria Silva",
  "contactPhone": "+5511999990000",
  "contactUsername": null,
  "conversationOwnerId": null,
  "status": "active",
  "unreadCount": 0,
  "createdAt": "2026-02-20T10:00:00.000Z",
  "AccountChatSector": {
    "id": "csector001",
    "name": "Comercial",
    "color": "#3B82F6"
  },
  "PlatformIntegration": {
    "id": "cplat001",
    "name": "WhatsApp"
  }
}

Requisição

POST https://crm.wavups.com/api/v1/lead/{id}/conversation

Tokenstringobrigatório

Seu token de autenticação.

Path Parameters

idstringobrigatório

ID do lead que será vinculado à conversa.

Body

accountChatSectorIdstring

ID do setor do chat ao qual a conversa deve ser atribuída (consulte Listar Setores). Se informado, a conversa é criada diretamente vinculada a esse setor.

accountIntegrationIdstring

ID da integração da conta (consulte Listar Integrações). Se não informado, utiliza a integração do setor ou a integração ativa padrão da conta.

contactNamestring

Nome do contato na conversa (padrão: nome do lead).

contactPhonestring

Telefone do contato na conversa (padrão: telefone do lead).

contactUsernamestring

Username ou identificador social do contato.

conversationOwnerIdstring

ID do membro da conta responsável pela conversa.

statusstring

Status inicial da conversa (padrão: active).

Resposta

Retorna o objeto da conversa criada (status HTTP 201).

idstring

Identificador único da conversa criada.

leadIdstring

ID do lead associado à conversa.

accountChatSectorIdstring | null

ID do setor atribuído à conversa.

contactNamestring

Nome do contato.

contactPhonestring | null

Telefone do contato.

statusstring

Status da conversa.

createdAtstring

Data e hora de criação (ISO 8601).

Autorização

Tokenstring · headerobrigatório

Token de autenticacao gerado na plataforma WavUps CRM.

Parâmetros de caminho

idstringobrigatório

ID do lead que será vinculado à conversa.

Corpo da requisição

application/json · object

accountChatSectorIdstring

ID do setor do chat para atribuir a conversa.

accountIntegrationIdstring

ID da integração.

contactNamestring

Nome do contato.

contactPhonestring

Telefone do contato.

contactUsernamestring

Username do contato.

conversationOwnerIdstring

ID do responsável.

statusstring

Status inicial (padrão: active).

Respostas

201application/json · object

Conversa criada com sucesso.

idstring

contactNamestring | null

contactPhonestring | null

accountChatSectorIdstring | null

conversationOwnerIdstring | null

statusstring

stateenum<string> | null

Valores aceitos: NEW, AI_ANSWERING, NEEDS_HUMAN, NO_RESPONSE, COMPLETED, ARCHIVED

createdAtstring<date-time>

404

Lead ou setor não encontrado.

500

curl --request POST \ --url 'https://crm.wavups.com/api/v1/lead/clead12345/conversation' \ --header 'Token: SEU_TOKEN_DE_API' \ --header 'Content-Type: application/json' \ --data '{ "accountChatSectorId": "csector001", "contactName": "Maria Silva", "contactPhone": "+5511999990000" }'

{ "id": "clconv98765", "leadId": "clead12345", "accountChatSectorId": "csector001", "contactName": "Maria Silva", "contactPhone": "+5511999990000", "contactUsername": null, "conversationOwnerId": null, "status": "active", "unreadCount": 0, "createdAt": "2026-02-20T10:00:00.000Z", "AccountChatSector": { "id": "csector001", "name": "Comercial", "color": "#3B82F6" }, "PlatformIntegration": { "id": "cplat001", "name": "WhatsApp" } }