Telefonia Voys

Com a integração Voys, o Tillor vê quem está a ligar e mostra logo os dados do cliente. As chamadas, gravações e transcrições ficam depois em Chamadas telefónicas. O Voys é um fornecedor de telefonia para empresas.

Antes de começar:

• Precisa de uma conta VoIP Voys ativa e de acesso às definições do plano de chamadas no Voys.
• Precisa da permissão Gerir integrações.
• O número de telefone de quem liga tem de constar do perfil do cliente ou de uma pessoa de contacto, caso contrário o Tillor não associa a chamada a um cliente.

Configurar o VoysCopiar a ligação para esta secção

1. Vá a Definições (barra lateral, em Apoio)

2. Escolha Integrações e abra Voys na lista
3. Na página de detalhe, preencha os seus dados do Voys (username, password, client_uuid, token) e clique em Instalar

Precisa de uma conta VoIP Voys ativa.

Encontrar os URLs para o VoysCopiar a ligação para esta secção

O Tillor e o Voys comunicam entre si através de endereços (URLs). Em alguns passos, o Voys pede uma resposta ao Tillor, por exemplo se está aberto. Essa resposta é ACK (sim, continuar) ou NAK (não, seguir o outro caminho). Um webhook é um endereço que o Voys chama durante uma chamada.

Para webhooks, identificação do nome de quem liga e códigos de acesso, utilize os URLs que o Tillor gera para si.

1. Vá a Definições > Integrações e abra Voys
2. Depois da instalação, na página de detalhe, em Definições, está o bloco URLs a configurar - copie aí o URL certo para cada finalidade

Encontra aqui, entre outros:

• Notificações de conversas - URL de webhook para eventos de chamadas
• Webhook para identificação do chamador - URL para a identificação do nome de quem liga (caller name lookup) no seu plano de chamadas do Voys
• Lista telefónica XML - URL para os telefones VoIP obterem a lista telefónica
• Códigos de acesso - URL para comandar o ponto de acesso (cancela, portão ou porta) através do plano de chamadas
• Webhook de horário de abertura - ACK se o Tillor está aberto, NAK se o Tillor está fechado
• Webhook de chamador permitido - ACK se a chamada pode ser reencaminhada, NAK se quem liga deve ir para o correio de voz
• Webhook de encaminhamento - ACK com um destino, NAK se não estiver definido nenhum destino

No plano de chamadas do Voys, utilize as mesmas variáveis que estão indicadas no Tillor (como {callerid}, {did}, {callername}, {callid} e {code}).

Configurar as notificações de conversas no VoysCopiar a ligação para esta secção

1. No Voys, abra o módulo Notificações de conversas
2. Clique em Adicionar
3. Em package/service, escolha Personalizado
4. Cole o URL do Tillor de Notificações de conversas
5. Guarde

Documentação do Voys:

• Notificações de conversas

Configurar os nomes de quem liga (caller lookup) no plano de chamadasCopiar a ligação para esta secção

Para a identificação do nome de quem liga, utilize no Voys um passo de webhook no plano de chamadas.

1. No Tillor, abra o URL Webhook para identificação do chamador (em Definições > Integrações > Voys, em URLs a configurar) e copie-o
2. No Voys, abra o módulo Webhooks e crie um webhook com este modelo de URL
3. Ative esse webhook no seu plano de chamadas através do passo de webhook
4. No modelo de URL, utilize as variáveis que o Voys suporta ({callerid}, {did}, {callername} e, se necessário, {code})
5. Na definição do encaminhamento do webhook, configure Variável nome do chamador para que o nome devolvido seja mostrado nos telefones

Os webhooks de horário de abertura e de encaminhamento não fazem identificação do nome de quem liga. Para isso, utilize este passo separado.

Mais informação:

• Webhooks
• O que são notificações de conversas (diferença em relação aos webhooks)

Horário de abertura e destinos no plano de chamadasCopiar a ligação para esta secção

O Tillor é a fonte do horário de abertura, das férias e das exceções por feriado. O Voys já não precisa de conhecer esse calendário.

1. Em Definições > Integrações > Voys, escolha o telefone Voys para aberto e, opcionalmente, para fechado
2. Copie o Webhook de horário de abertura ou o Webhook de encaminhamento de URLs a configurar
3. No Voys, crie um webhook com esse modelo de URL
4. Coloque esse webhook como passo do plano de chamadas, acima de eventuais menus de escolha
5. Deixe Utilizar menu desativado

Dois padrões:

• Webhook de horário de abertura - status=ACK segue o caminho HTTP e menu bem-sucedidos (aberto), status=NAK segue HTTP ou menu falhado (fechado). Se estiver definido um destino para aberto, este vai com o ACK como destination.
• Webhook de encaminhamento - o Tillor escolhe o destino. No passo bem-sucedido, configure Variável destino final. ACK + destination se houver um destino, caso contrário NAK.

Em caso de erro ou timeout, o Voys segue o caminho falhado. Trate isso como fechado.

Documentação do Voys: Webhooks.

Enviar automaticamente os chamadores para o correio de vozCopiar a ligação para esta secção

Com o Webhook de chamador permitido, o Voys decide, para cada chamador, se uma chamada é reencaminhada. O Tillor verifica se o número de quem liga pertence a um cliente que tem o correio de voz automático ativado.

Primeiro, configure o plano de chamadas:

1. Copie o Webhook de chamador permitido de URLs a configurar, em Definições > Integrações > Voys
2. No Voys, crie um webhook com esse modelo de URL
3. Coloque esse webhook como passo do plano de chamadas, acima dos passos que reencaminham a chamada
4. Deixe Utilizar menu desativado
5. Encaminhe o caminho HTTP e menu bem-sucedidos para o seu encaminhamento normal e o caminho HTTP ou menu falhado para o correio de voz
6. Em Definições > Integrações > Voys, em Encaminhamento de chamadas, assinale Correio de voz automático no Voys

Enquanto estiver desativado, não vê Enviar chamadas para o correio de voz no perfil do cliente.

Depois, ative o correio de voz automático para cada cliente:

1. Abra o perfil do cliente e vá ao separador Comunicação
2. Em Definições de comunicação, assinale a opção Enviar chamadas para o correio de voz
3. Clique em Guardar

Assim funciona a resposta:

• ACK - quem liga pode passar. Isto também vale para números desconhecidos e para chamadores com número oculto.
• NAK - o número pertence a um cliente com correio de voz automático. O Voys segue o caminho falhado.

O Tillor compara o número de quem liga com o número de telefone no perfil do cliente, independentemente de espaços ou da notação do indicativo do país. Os números de telefone das pessoas de contacto não contam.

Este webhook não tem em conta o horário de abertura. Combine-o com o webhook de horário de abertura ou de encaminhamento, colocando ambos como passos separados no plano de chamadas.

Documentação do Voys: Webhooks.

Encaminhamento fixo por chamadorCopiar a ligação para esta secção

O mesmo Webhook de encaminhamento pode reencaminhar logo um chamador para um telefone Voys próprio, uma extensão ou um número de telefone. Isto só vale para clientes para os quais escolheu um destino, e só se Encaminhamento fixo no Voys estiver ativado.

1. Coloque o Webhook de encaminhamento no plano de chamadas, como no horário de abertura
2. No passo bem-sucedido, configure Variável destino final
3. Em Definições > Integrações > Voys, em Encaminhamento de chamadas, assinale Encaminhamento fixo no Voys

Enquanto estiver desativado, não vê Encaminhamento fixo de chamadas no perfil do cliente. O webhook utiliza então apenas o telefone para aberto ou fechado.

Depois, defina o destino para cada cliente:

1. Abra o perfil do cliente e vá ao separador Comunicação
2. Em Encaminhamento fixo de chamadas, escolha um telefone Voys ou Outro para um número de telefone ou extensão (por exemplo 411)
3. Escolha Nenhum para desativar o encaminhamento fixo
4. Clique em Guardar

Assim o webhook de encaminhamento escolhe o destino:

• Se existir um destino fixo para este chamador, esse é o destination.
• Caso contrário, o destination é o telefone Voys para aberto ou fechado.
• NAK - não existe destino fixo nem telefone para o estado atual. Isto também vale para números desconhecidos e para chamadores com número oculto, enquanto não houver telefone para aberto ou fechado.

O Tillor compara o número de quem liga com o número de telefone no perfil do cliente, independentemente de espaços ou da notação do indicativo do país. Os números de telefone das pessoas de contacto não contam.

Em caso de erro ou timeout, o Voys segue o caminho falhado.

Documentação do Voys: Webhooks.

O que acontece a seguir?Copiar a ligação para esta secção

• Cada chamada que entra ou sai fica em ComunicaçãoChamadas telefónicas, com o cliente associado se o número corresponder. Veja Chamadas telefónicas.
• Numa chamada recebida, quem liga aparece como cartão no canto inferior direito do Tillor, com os dados do cliente.
• As gravações e transcrições chegam assim que a chamada termina, se as gravações de chamadas estiverem ativadas na sua conta Voys.

Problemas?Copiar a ligação para esta secção

Ver tambémCopiar a ligação para esta secção