Conversas

Criar Conversa

Cria uma nova conversa externa vinculada obrigatoriamente a um lead existente e atribui ao setor de atendimento desejado.

POST/account-external-conversation

curl --request POST \
  --url 'https://crm.wavups.com/api/v1/account-external-conversation' \
  --header 'Token: SEU_TOKEN_DE_API' \
  --header 'Content-Type: application/json' \
  --data '{
    "leadId": "clead12345",
    "accountChatSectorId": "csector001",
    "contactPhone": "5511988887777",
    "contactName": "Carlos Eduardo"
  }'

{
  "id": "clconv123",
  "contactName": "Carlos Eduardo",
  "contactPhone": "5511988887777",
  "contactUsername": null,
  "leadId": "clead12345",
  "accountChatSectorId": "csector001",
  "status": "active",
  "state": "NEW",
  "unreadCount": 0,
  "createdAt": "2026-02-20T10:00:00.000Z",
  "AccountChatSector": {
    "id": "csector001",
    "name": "Vendas",
    "color": "#10B981"
  },
  "PlatformIntegration": {
    "id": "cplat001",
    "name": "WhatsApp"
  }
}

Padrão Estrito de Telefone (DDI + DDD + Número)

Os números de telefone devem ser enviados exclusivamente no formato de dígitos com DDI + DDD/Código de Área + Número (exemplo Brasil: 5547999999999, exemplo EUA: 14155552671), sem espaços, traços, parênteses ou o símbolo +.

Qualquer divergência neste formato causará falhas nos disparos da API do WhatsApp e duplicação de leads no sistema.

Fluxo de Criação em Duas Etapas: Para direcionar um lead a um setor específico antes do primeiro contato:

Primeiro registre o lead através do endpoint Criar Lead para obter o id do lead.
Em seguida, utilize este endpoint enviando o leadId e o accountChatSectorId desejado (ex: Setor de Vendas).

Requisição

POST https://crm.wavups.com/api/v1/account-external-conversation

Tokenstringobrigatório

Seu token de autenticação.

Body

leadIdstringobrigatório

ID do Lead retornado na criação do lead (POST /lead). Campo obrigatório.

accountChatSectorIdstring

ID do setor do chat para atribuir a conversa (ex: Setor de Vendas, Suporte).

contactPhonestring

Telefone do contato no formato estrito internacional (5547999999999). Caso não informado, o telefone cadastrado no Lead será utilizado.

contactNamestring

Nome do contato da conversa. Caso não informado, o nome cadastrado no Lead será utilizado.

contactUsernamestring

Username ou identificador social do contato (ex: username do Instagram).

accountIntegrationIdstring

ID da integração da conta (consulte Listar Integrações). Opcional caso o setor já possua integração associada.

conversationOwnerIdstring

ID do membro da conta responsável pela conversa. Caso não informado, utilizará o leadOwner do lead.

statusstring

Status da conversa (padrão: active).

statestring

Estado inicial do atendimento da conversa (padrão: NEW). Valores aceitos: NEW, AI_ANSWERING, NEEDS_HUMAN, NO_RESPONSE, COMPLETED, ARCHIVED.

Resposta

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

idstring

Identificador único da conversa.

contactNamestring

Nome do contato.

contactPhonestring | null

Telefone do contato formatado.

leadIdstring

ID do lead associado.

accountChatSectorIdstring | null

ID do setor associado.

statusstring

Status da conversa.

statestring

Estado atual do atendimento da conversa. Padrão: NEW. Valores possíveis: NEW, AI_ANSWERING, NEEDS_HUMAN, NO_RESPONSE, COMPLETED, ARCHIVED.

createdAtstring

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