API - Baixar gravações - Global
Para poder utilizar a API do Evolux, é necessário primeiro Gerar um Token.
Essa API tem a função de localizar e fazer download da gravação de qualquer chamada dentro do Evolux, de maneira unificada.
Como o Evolux possui módulos, onde seus relatórios e consequentemente suas rotas são distintas, essa API tem a função de normalizar o cenário para o usuário que busca padronização na auditoria das chamadas.
Parâmetros necessários:
ID de gravação da Chamada - {{recordingUuid}}
Essa informação pode ser obtida nos eventos trazidos até a camada do navegador de internet, no momento em que uma chamada é oferecida para o ramal em questão, inclusive pode ser consumida por qualquer plataforma que tiver embutido o iFrame do EvoluxPhone em sua página.
Item | Valor | Exemplo |
---|---|---|
Endpoint | {{url}}/api/v1/recording/{{recordingUuid}} | https://meucliente.evolux.io/api/v1/recording/01e87cf3-5f93-43eb-b2f9-359fde089f5e |
Método | GET |
|
Cabeçalho | token: {{token}} |
|
Exemplos de requisição:
cURL:
curl --location --globoff 'https://meucliente.evolux.io/api/v1/recording/01e87cf3-5f93-43eb-b2f9-359fde089f5e' \
--header 'token: {{token}}'
Python (lib Requests):
from pathlib import Path
from urllib.parse import urljoin
import requests
def download(uuid: str) -> None:
url = "https://meu_evolux.evolux.io/api/v1/recording/"
headers = dict(token="h9s8dfsk8-TOKEN_FAKE-9SDS0eGFdff")
filename = Path(uuid).with_suffix(".ogg")
with requests.Session() as session:
response = session.get(
url=urljoin(url, uuid), stream=True, headers=headers
)
if response.ok:
with open(filename, "wb") as f:
for chunk in response.iter_content(chunk_size=1024):
f.write(chunk)
print(f"Download concluído: {filename.absolute()}")
else:
print(response.text)
if __name__ == "__main__":
uuid = "fdasliirp62-ddfg9-469e-1ffc-0acedhgsdfh5"
download(uuid=uuid)
Caso a chamada ainda esteja ativa, ou tenha acabado de finalizar, você deve se deparar com a response:
{
"meta": {
"status": 404,
"message": "Call recording not found."
}
}