Ações
Listar Ações
Recuperar uma lista de ações para um agente específico
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_hereParâmetros de consulta
string
Filtrar por tipo de ação. Opções:
webhook, transfer, holdinteger
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
- Use paginação - Sempre use paginação para grandes conjuntos de dados
- Filtre por tipo - Use filtros de tipo para encontrar ações específicas
- Monitore status - Verifique se as ações estão ativas quando necessário
- Teste configurações - Sempre teste as configurações de ações antes de usar em produção
- 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