> ## Documentation Index
> Fetch the complete documentation index at: https://ajuda.pandazap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API de Listagens Gerais: Canais, Filas, Tags, Fluxos e Respostas Prontas

> Liste sessões de API, canais, filas, tags, respostas rápidas/automáticas e fluxos de chatbot cadastrados no seu tenant via API externa do PanÐá Zap.

Esta página reúne endpoints de **listagem simples** — sem criação, atualização ou exclusão — usados para descobrir IDs e configurações disponíveis no seu tenant antes de usá-los em outras chamadas (por exemplo, obter um `queueId` válido antes de chamar [Atualizar fila do ticket](/api/tickets#atualizar-fila-do-ticket)).

Todas as requisições exigem o cabeçalho `Authorization: Bearer {BearerToken}`.

<Note>
  Listagens de entidades com CRUD completo têm sua própria página de referência: [Contatos](/api/contacts), [Tickets](/api/tickets), [Oportunidades](/api/crm#oportunidades) e [Campanhas](/api/campaigns) também expõem os mesmos endpoints de listagem documentados aqui — eles estão descritos nesta página para centralizar a referência de descoberta de dados.
</Note>

***

## Listar todas as integrações de API

Retorna todas as integrações de API (sessões de acesso externo) cadastradas no tenant.

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/getAllSessionApis
```

***

## Listar canais

Retorna todos os canais (WhatsApp, Instagram, Messenger, Webmail, etc.) cadastrados no tenant.

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/listChannels
```

***

## Listar sessões

Retorna todas as sessões do WhatsApp cadastradas — uma visão focada em canais WhatsApp especificamente (veja também [Canais e Sessões](/api/channels)).

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/listSessions
```

***

## Listar filas

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/listQueues
```

Para criar, atualizar ou excluir filas, veja [Kanban, Tags, Motivos e Filas](/api/organization#filas).

***

## Listar tags

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/listTags?isActive=true
```

| Query param | Tipo    | Obrigatório | Descrição                                                                            |
| ----------- | ------- | ----------- | ------------------------------------------------------------------------------------ |
| `isActive`  | boolean | Não         | Filtra apenas tags ativas (`true`) ou inativas (`false`). Omita para retornar todas. |

Para criar, atualizar ou excluir tags, veja [Kanban, Tags, Motivos e Filas](/api/organization#tags).

***

## Listar contatos (paginado)

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/listContacts?pageNumber=1
```

| Query param   | Tipo    | Obrigatório | Descrição                                             |
| ------------- | ------- | ----------- | ----------------------------------------------------- |
| `pageNumber`  | integer | Não         | Número da página a retornar (padrão: `1`).            |
| `searchParam` | string  | Não         | Busca por texto livre em nome, número ou e-mail.      |
| `walletId`    | integer | Não         | Filtra contatos atribuídos a uma carteira específica. |
| `tagId`       | integer | Não         | Filtra contatos por uma tag específica.               |

Equivalente por GET ao endpoint `POST /contacts/search` documentado em [Pesquisar contatos](/api/contacts#pesquisar-contatos).

***

## Listar tickets

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/listTickets?pageNumber=1&status=open
```

Documentado em detalhe em [Listar tickets](/api/tickets#listar-tickets).

***

## Listar oportunidades

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/listOpportunities?page=1&limit=40
```

Documentado em detalhe em [Listar oportunidades](/api/crm#listar-oportunidades).

***

## Listar respostas automáticas

Retorna as respostas automáticas configuradas (mensagens de saudação, ausência, horário de atendimento, etc.).

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/listAutoReplies
```

***

## Listar respostas rápidas

Retorna os atalhos de resposta rápida cadastrados para uso dos agentes durante o atendimento.

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/listFastReplies
```

***

## Listar fluxos de chatbot

Retorna os fluxos de chatbot (chat flows) cadastrados, incluindo seus IDs — use o `id` retornado no campo `chatFlowId` de [Criar ticket](/api/tickets#criar-ticket) ou [Atualizar informações do ticket](/api/tickets#atualizar-informações-do-ticket).

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/listChatFlows
```

***

## Resposta Padrão

```json theme={null}
{
  "success": true,
  "data": [ ... ]
}
```

Endpoints paginados (`listContacts`, `listTickets`, `listOpportunities`) retornam `data` como um objeto com o array de resultados mais metadados de paginação; os demais retornam `data` diretamente como array.