# Listar Atendimentos

> Retorna a lista de atendimentos realizados na conta autenticada, com suporte a filtros.

`GET https://crm.wavups.com/api/v1/customer-service`

Página: https://crm.wavups.com/docs/api/atendimentos/listar

## Requisição

`GET https://crm.wavups.com/api/v1/customer-service`

- `Token` (string, obrigatório, header):
  Seu token de autenticação.

### Query Parameters

- `startDate` (string, query):
  Data de início para filtrar atendimentos pelo campo `createdAt`. Formato ISO 8601 (ex: `2025-01-01T00:00:00Z`). Utilizado em conjunto com `endDate`.

- `endDate` (string, query):
  Data de fim para filtrar atendimentos. Formato ISO 8601 (ex: `2025-12-31T23:59:59Z`). Utilizado em conjunto com `startDate`.

- `status` (string, query):
  Filtra atendimentos pelo status (ex: `pending`, `completed`).

- `leadId` (string, query):
  Filtra atendimentos vinculados a uma conversa de um lead específico.

---

## Resposta

Retorna um array de objetos de atendimento, ordenados do mais recente para o mais antigo. Os campos internos `customerContact`, `customerName`, `customerExternalId` e `updatedAt` são omitidos.

- `id` (string):
  Identificador único do atendimento.

- `accountExternalConversationId` (string | null):
  ID da conversa externa vinculada ao atendimento.

- `status` (string):
  Status do atendimento. Padrão: `pending`.

- `temperature` (number | null):
  Temperatura do atendimento (valor numérico).

- `chatSummary` (string | null):
  Resumo da conversa do atendimento.

- `createdAt` (string):
  Data de criação (ISO 8601).

- `AccountExternalConversation` (object | null):
  Dados da conversa externa vinculada.

  Propriedades da conversa:
  - `leadId` (string | null):
  ID do lead vinculado à conversa.
  
  - `contactName` (string):
  Nome do contato da conversa.
  
  - `contactPhone` (string | null):
  Telefone do contato.
  
  - `contactUsername` (string | null):
  Username do contato (ex: Instagram).
  
  - `AccountCRMLead` (object | null):
  Dados do lead vinculado.

  Propriedades do lead:
  - `name` (string):
  Nome do lead.
  
  - `email` (string | null):
  E-mail do lead.
  
  - `phone` (string | null):
  Telefone do lead.
  
  - `taxId` (string | null):
  CPF/CNPJ do lead.
  
  
  
  

---

## Exemplos

### Exemplo de requisição

```bash GET /api/v1/customer-service
curl --request GET \
  --url 'https://crm.wavups.com/api/v1/customer-service?status=completed' \
  --header 'Token: SEU_TOKEN_DE_API'
```

### Exemplo de resposta

```json 200
[
  {
  "id": "atd_001",
  "accountExternalConversationId": "conv_abc123",
  "status": "completed",
  "temperature": 4,
  "chatSummary": "Cliente solicitou informações sobre planos.",
  "createdAt": "2025-06-15T14:30:00.000Z",
  "AccountExternalConversation": {
  "leadId": "lead_xyz",
  "contactName": "João Silva",
  "contactPhone": "11999998888",
  "contactUsername": null,
  "AccountCRMLead": {
  "name": "João Silva",
  "email": "joao@email.com",
  "phone": "11999998888",
  "taxId": "12345678909"
  }
  }
  }
]
```

```json 500
{
  "error": "Error to get customers served"
}
```