# Listar Integrações

> Retorna a lista simplificada de integrações ativas e configuradas da conta, contendo os IDs necessários para envio de mensagens.

`GET https://crm.wavups.com/api/v1/integration`

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

## Visão Geral

Utilize este endpoint para consultar todas as integrações de canais (como WhatsApp Business, Instagram e Z-API) associadas à sua conta.

O campo `id` retornado para cada integração é o **`accountIntegrationId`** que deve ser informado nas rotas de envio de mensagens no WhatsApp e Instagram.

---

## Requisição

`GET https://crm.wavups.com/api/v1/integration`

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

---

## Resposta

Retorna um array com as integrações da conta.

- `id` (string):
  Identificador único da integração no banco de dados. Utilize este valor como `accountIntegrationId` nas requisições de envio de mensagens e criação de conversas.

- `platformName` (string):
  Nome legível da plataforma (ex: `WhatsApp Business`, `Instagram`, `Z-API`).

- `integrationAccountName` (string | null):
  Nome de identificação da conta integrada (ex: número de telefone ou nome da página/perfil).

- `status` (string):
  Status atual da integração (ex: `active`).

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

---

## Exemplos

### Exemplo de requisição

```bash GET /api/v1/integration
curl --request GET \
  --url 'https://crm.wavups.com/api/v1/integration' \
  --header 'Token: SEU_TOKEN_DE_API'
```

```javascript Node.js
const res = await fetch('https://crm.wavups.com/api/v1/integration', {
  headers: {
  'Token': 'SEU_TOKEN_DE_API'
  }
});
const data = await res.json();
console.log(data);
```

```python Python
import requests

response = requests.get(
  'https://crm.wavups.com/api/v1/integration',
  headers={'Token': 'SEU_TOKEN_DE_API'}
)
print(response.json())
```

### Exemplo de resposta

```json 200
[
  {
  "id": "cmint1234567890",
  "platformName": "WhatsApp Business",
  "integrationAccountName": "+55 11 99999-0000",
  "status": "active",
  "createdAt": "2026-01-10T12:00:00.000Z"
  },
  {
  "id": "cmint9876543210",
  "platformName": "Instagram",
  "integrationAccountName": "@minhaempresa",
  "status": "active",
  "createdAt": "2026-01-15T15:30:00.000Z"
  }
]
```

```json 500
{
  "error": "Error to get integrations"
}
```