Skip to main content
GET

Listar Ações

Recuperar uma lista de ações configuradas para um agente específico com suporte à paginação.

Endpoint

Parâmetros de caminho

string
obrigatório
O identificador único do agente. Você pode encontrá-lo na lista de agentes.

Cabeçalhos da requisição

string
obrigatório
Token Bearer para autenticação. Formato: Bearer talq_your_environment_token_here

Parâmetros de consulta

string
Filtrar por tipo de ação. Opções: webhook, transfer, hold
integer
Número de itens por página (padrão: 20, máximo: 100)
integer
Número da página (padrão: 1)

Exemplos de Requisição

Resposta

Resposta de Sucesso (200 OK)

Campos da Resposta

boolean
obrigatório
Indica se a operação foi bem-sucedida.
array
obrigatório
Array de objetos de ação.
object
obrigatório
Metadados de paginação.

Respostas de erro

404 Não Encontrado

422 Erro de Validação

401 Não Autorizado

500 Erro do Servidor

Códigos de erro

Notas Importantes

Tipos de ação. As ações podem ser webhooks, transferências ou pausas.
Configurações específicas. Cada tipo de ação tem sua própria configuração.
Status ativo. Ações podem ser ativadas ou desativadas conforme necessário.
Suporte à paginação. Use parâmetros page e per_page para navegar pelos resultados.

Melhores Práticas

  1. Use paginação - Sempre use paginação para grandes conjuntos de dados
  2. Filtre por tipo - Use filtros de tipo para encontrar ações específicas
  3. Monitore status - Verifique se as ações estão ativas quando necessário
  4. Teste configurações - Sempre teste as configurações de ações antes de usar em produção
  5. Documente ações - Mantenha descrições claras para cada ação

Endpoints relacionados

  • Criar/Atualizar Ação: POST /api/v1/agents/{agent_id}/actions
  • Excluir Ação: DELETE /api/v1/agents/{agent_id}/actions/{action_id}
  • Obter Agente: GET /api/v1/agents/{agent_id}
  • Listar Agentes: GET /api/v1/agents