API - Call Info

A API Call Info permite inserir informações personalizadas dentro dos dados da chamada, que serão exibidas automaticamente pelo Painel do Operador, ou no EvoluxPhone por meio de um botão chamado “Informações da Chamada", e também podem ser consultadas nos eventos javascript que são transportados nos dois casos, assim como por uma requisição à API.

Para utilizar as APIs de Call Info, você precisa conhecer o “uuid” da chamada. No Studio esse valor está guardado na chave {{call_uuid}}, por exemplo.

Enviando dados para o Call Info

A recomendação é que essa inserção de dados seja feita pelo Evolux Studio, uma vez que no curso da chamada, já temos o uuid daquela ligação e com isso conseguimos montar a requisição de API.

Para versões On Premise do Evolux, precisamos usar a caixinha de HTTP e preencher da seguinte maneira:

Endereço da API

https://servidor.evolux.net.br:8080/api/freeswitch/save_call_info/{{ call_uuid }}

Método

GET

Dados

JSON

[{
"label": "Campo de Descrição", 
"type": "text" ou "number", 
"value": "Campo com o Valor"
}]

ou

[{
"label": "115673", 
"type": "link", 
"value": "https://seucrm.com/115673"
}]

Nos ambiente em nuvem, o Studio já traz um componente pronto que monta essa requisição, veja mais no Manual do Studio - Informação da Chamada ( Call Info)

O recurso de Call Info só funciona para chamadas que são transferidas para uma fila de atendimento. Caso a ligação seja entregue para um ramal, a informação não será exibida.

Consultando o Call Info

As informações inseridas em um Call Info são automaticamente exibidas quando uma chamada é entregue em uma fila e posteriormente atendida por um ramal/operador, veja em Call Info.

Para realizar a consulta via API, devemos primeiramente ter em mente que:

Os dados contidos ali são temporários, ou seja, não é desejável que uma chamada encerrada a algum tempo ainda carregue as informações de Call Info;
O intuito principal dessa API é de buscar dados inseridos por automações via Evolux Studio. Como os dados não são permanentes, sugerimos utilizar como gatilho o Webhook Genérico que é disparado ao fim da ligação e pode entregar o valor da chave “uuid". Caso opte por uma coleta assíncrona, sugerimos a API - Histórico do Studio que entrega a mesma chave/valor para cada ligação registrada.

Para realizar a consulta, precisamos efetuar a seguinte requisição:

Endereço da API	https://servidor.evolux.io/api/v1/calls/{{ call_uuid }}/info
Método	GET
Cabeçalho	token: {{token}}

Retornos:

200

{
    "call_info": [
        {
            "label": "Número Discado/DDR",
            "value": [
                {
                    "label": "Número",
                    "value": "7135101000",
                    "type": "number"
                },
                {
                    "label": "Nome",
                    "value": null,
                    "type": "text"
                }
            ],
            "type": "multi"
        },
        {
            "label": "Nome",
            "value": "SERJ TANKIAN",
            "type": "text"
        },
        {
            "label": "CPF",
            "value": "111.222.333-45",
            "type": "text"
        },
        {
            "label": "Assunto",
            "value": "Suporte Técnico",
            "type": "text"
        }
    ]
}

404