Ler a trava de discagem de um agente
Diz se o agente pode discar agora e, quando não pode, quem está ocupando a linha: um agendamento em despacho ou uma ligação em curso. A trava é do canal de saída — dois agentes que discam pelo mesmo tronco dividem uma linha só, e a trava de um mostra a ligação do outro. Um agendamento que nunca chegou ao worker deixa de travar em dois minutos, e uma ligação atendida, em quatro horas; para soltar antes disso, DELETE no mesmo caminho. Agente de texto não tem linha: responde 404.
Autorização
bearer calls:readCredencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.
Em: header
Escopo: calls:read
Parâmetros de caminho
Id do agente de voz
Corpo da resposta
application/json
application/json
curl -X GET "https://example.com/agents/string/call-lock"{ "holder": null, "locked": true, "reason": "string"}