Passo a Passo Integração
Descrição
- ClickToCall para chamadas
- Gera eventos das ligações entrantes
- Gera eventos de atendimento
- Grava histórico de chamadas no evento
Conteúdo
O Situator trabalhará integrado com alguns recursos de chamada da central telefônica, um destes recursos é a captura de eventos da ligação.
Neste momento, o Situator captura a ação de atendimento de uma ligação por um ramal, quando esta ligação é feita para a fila de atendimento. Também pode-se ativar o recurso de atendimento automático para que o card do evento passe da coluna Aberto para a coluna Atendimento.
Informações Relevantes
Para a perfeita utilização do recurso é importante se atentar a algumas situações:
Somente com a configuração minuciosa, acompanhando este documento em cada passo, será possível usufruir de todos os recursos da integração
É possível utilizar os ramais dentro da VTCall, através de Softphones VTCall ou aparelhos IPs
O recebimento de chamada fica atrelado obrigatoriamente ao recebimento via Fila de Atendimento (a utilização de chamada direta a ramal DDR não surtirá efeito dentro do Situator)
A VTCall não se responsabiliza pela utilização, manutenção ou suporte técnico da plataforma Situator, ficando responsável apenas pela integração e claro, sua solução.
Token de Autenticação
Para realizar qualquer tipo de integração e consumo de APIs VTCall, é imprescindível que o cliente já tenha habilitado seu token no seguinte caminho:
- Ajustes
- Integrações
- Segurança (Token)
- Clique no botão de atualizar token
Sempre que precisar, o cliente poderá alterar seu Token, sempre lembrando de atualizá-lo em todas as aplicações que o utilizem.
Webhooks
Esta integração está baseada no recurso de Webhooks, os quais serão configurados da seguinte forma:
- Ajustes
- Integrações
- Webhooks
- Clique no botão Add Webhook
O Webhook para capturar os eventos será configurado da seguinte forma:
- URL = É o endereço que está rodando o Situator junto da rota do endpoint de monitoramento. Exemplo:
Endereço do Situator = http://endereco-do-servidor:8080/ (usar IP fixo ou dns dinâmico)
Rota do endpoint = api/voip/vtcall/webhook/events (fixa para todos os clientes) - Content type = Usar sempre “application/json”
- Senha (Opcional) = neste Webhook não será necessária
- Quais eventos você gostaria de adicionar este webhook? = Escolha “Envie-me tudo”
- Clique no botão “Adicionar Webhook”
O Webhook atendimento automático será configurado da seguinte forma:
- URL = É o endereço que está rodando o Situator junto da rota do endpoint de monitoramento. Exemplo:
Endereço do Situator = http://endereco-do-servidor:8080/ (usar IP fixo ou dns dinâmico)
Rota do endpoint = api/voip/events (fixa para todos os clientes) - Content type = Usar sempre “application/json”
- Senha (Opcional) = usar o Token da API do usuário VTCall existente no Situator
- Quais eventos você gostaria de adicionar este webhook? = Escolha “Situator - Enviar o evento AgentConnect customizado.”
- Clique no botão “Adicionar Webhook”
Obs.: Para pegar o Token da API do usuário VTCall no Situator, basta ir em >Configurações >Usuários >Editar o usuário “vtcall”
Vale relembrar que a rota endpoint utilizada na geração de eventos será api/voip/vtcall/webhook/events enquanto a rota endpoint do atendimento automático será api/voip/events, ficando da seguinte forma:
Configurações a serem realizadas no Situator
Em >Configurações >Integrações >Comunicação >Telefonia, configurar conforme abaixo:
- Tipo = VTCall
- URL = É formada pelo endereço do PABX do cliente, API utilizada, Token do Cliente no Gestor VTCall e os variáveis de discagem. Exemplo:
Endereço do PABX = https://www22.vtcall.app/
API utilizada = API/clicktocall-post?
Token do Cliente = access_token=SEU_TOKEN
Variáveis de discagem = &type=ramal&first={RAMAL}&last= - Token = Token do cliente no Gestor VTCall
- URL Chamadas = API/clicktocall-post?access_token={TOKEN}&type=ramal&first={RAMAL}&last=
- URL Gravações = API/ligacoes?linkedid=
- Ativo = Clicar para manter ativo
- Clicar em “Salvar”
Para o evento aparecer corretamente no Situator, é necessário criar o Evento Personalizando associado ao ramal desejado, para isso acesse Contas, Configurações da Conta, Eventos, Adicionar Evento:
Para o correto funcionamento do recurso de Atendimento Automático, nas preferências de cada operador, é necessário que seja definido o Ramal com o tipo “Fixo” e o Número será o próprio ramal do Operador:
Video de demonstração de funcionamento: situator_evento.mp4