# Números, equipes e etiquetas

## Números de WhatsApp

`GET /v1/c/{slug}/channels` · Escopos: `workspace:read` · `campaigns:write` · `messages:send_template` · `templates:read`

Os números da empresa, com a qualidade e o limite diário que a Meta deu a cada um.

### Parâmetros do endereço

| Campo | Detalhes |
|---|---|
| `slug` | O identificador da empresa no DoneTalk (o mesmo da chave). |

### Exemplo de pedido

```bash
curl -X GET "https://api.donetalk.com/v1/c/demo/channels" \
  -H "Authorization: Bearer $DONETALK_KEY"
```

### Resposta 200

```json
{
  "channels": [
    {
      "id": "01a0cccc-0000-7000-8000-000000000002",
      "name": "Captei",
      "phone": "554896429898",
      "status": "active",
      "quality": "GREEN",
      "messagingTier": "TIER_1K",
      "account": {
        "id": "01a0cccc-0000-7000-8000-000000000001",
        "name": "Captei WABA"
      },
      "currency": "BRL",
      "handling": {
        "mode": "flow",
        "teamId": "01a0cb22-89c0-7e02-b96b-3f4731dde701",
        "flowId": "01a0d60a-3fc1-7df5-a07c-9769fd5701e6",
        "assistantId": null
      },
      "createdAt": "2026-09-22T20:14:21.670Z"
    }
  ]
}
```

### Erros possíveis

- `401` `unauthorized`
- `403` `insufficient_scope`
- `422` `validation_failed`
- `429` `rate_limited`

## Equipes

`GET /v1/c/{slug}/teams` · Escopos: `workspace:read` · `campaigns:write`

Para mandar as respostas de uma campanha à equipe certa (`reply.id`).

### Parâmetros do endereço

| Campo | Detalhes |
|---|---|
| `slug` | O identificador da empresa no DoneTalk (o mesmo da chave). |

### Exemplo de pedido

```bash
curl -X GET "https://api.donetalk.com/v1/c/demo/teams" \
  -H "Authorization: Bearer $DONETALK_KEY"
```

### Resposta 200

```json
{
  "teams": [
    {
      "id": "01a0cb22-89c0-7e02-b96b-3f4731dde701",
      "name": "Vendas",
      "description": null,
      "isActive": true,
      "distributionMode": "least_busy",
      "businessHoursId": null,
      "members": [
        {
          "id": "01a0cac1-4a6f-7646-b5f8-c1d19090016a",
          "name": "Tayomara Batista",
          "presence": "online"
        }
      ]
    }
  ]
}
```

### Erros possíveis

- `401` `unauthorized`
- `403` `insufficient_scope`
- `422` `validation_failed`
- `429` `rate_limited`

## Etiquetas

`GET /v1/c/{slug}/tags` · Escopos: `workspace:read` · `contacts:read`

### Parâmetros do endereço

| Campo | Detalhes |
|---|---|
| `slug` | O identificador da empresa no DoneTalk (o mesmo da chave). |

### Exemplo de pedido

```bash
curl -X GET "https://api.donetalk.com/v1/c/demo/tags" \
  -H "Authorization: Bearer $DONETALK_KEY"
```

### Resposta 200

```json
{
  "tags": [
    {
      "id": "01a12150-3610-7c00-b680-188c2b4c7313",
      "name": {
        "pt-BR": "VIP",
        "en": "VIP",
        "es": "VIP"
      },
      "color": "#92400e",
      "appliesTo": "both",
      "isActive": true,
      "contacts": 128,
      "conversations": 40
    }
  ]
}
```

### Erros possíveis

- `401` `unauthorized`
- `403` `insufficient_scope`
- `422` `validation_failed`
- `429` `rate_limited`

## Desfechos

`GET /v1/c/{slug}/outcomes` · Escopos: `workspace:read` · `conversations:read` · `conversations:write`

Como um atendimento pode ser concluído (venda, sem interesse, resolvido…), com o código usado em `close` e nos avisos.

### Parâmetros do endereço

| Campo | Detalhes |
|---|---|
| `slug` | O identificador da empresa no DoneTalk (o mesmo da chave). |

### Exemplo de pedido

```bash
curl -X GET "https://api.donetalk.com/v1/c/demo/outcomes" \
  -H "Authorization: Bearer $DONETALK_KEY"
```

### Resposta 200

```json
{
  "outcomes": [
    {
      "id": "01a0cb22-0000-7000-8000-00000000000a",
      "code": "converted",
      "label": {
        "pt-BR": "Venda",
        "en": "Sale",
        "es": "Venta"
      },
      "category": "success",
      "is_success": true,
      "requires_note": false,
      "reopen_allowed": true,
      "sort": 1
    }
  ]
}
```

### Erros possíveis

- `401` `unauthorized`
- `403` `insufficient_scope`
- `422` `validation_failed`
- `429` `rate_limited`