Perguntas frequentes | Kit Voximplant

F.A.Q.

P: O que é o Kit Voximplant ?

R: O kit Voximplant é uma ferramenta inteligente e flexível que ajuda você a criar URA inteligente e campanhas de chamadas saintes. Você precisa criar um cenário de chamada, fazer upload dos detalhes de contato dos clientes e configurar os parâmetros de chamada. O resto acontece automaticamente.

P: Como posso testar o Kit Voximplant ?

R: Você pode testar qualquer cenário: o sistema irá ligar para você em seu número de telefone pessoal. Para fazer isso, clique em Teste no editor visual. Observe que as chamadas de teste são cobradas. Certifique-se de que sua conta tenha saldo suficiente. Para usar o Kit Voximplant por completo, compre e verifique um número de telefone.

P: Quero fazer uma chamada de teste, mas o sistema exige que eu verifique o meu número de telefone. O que devo fazer?

R: Basta verificar seu número de telefone :) Leva cerca de 20 segundos para verificar seu número de telefone pessoal: você receberá um SMS com um código e você deve inseri-lo em uma caixa especial.

P: O que é verificação? É realmente necessária?

R: Verificação significa o upload de documentos que confirmam a identidade de um indivíduo ou pessoa jurídica para o sistema. Este procedimento é obrigatório de acordo com a legislação de alguns países. Para passar na verificação como pessoa física, faça o upload das cópias dos documentos necessários. O tamanho máximo do arquivo é de 5 MB. Para passar na verificação como pessoa jurídica, você será solicitado a fazer o download do Contrato de oferta. Preencha o acordo e anexe-o ao formulário de verificação. Você pode monitorar o status da sua aplicação na aba Verificação. Você será notificado por e-mail assim que sua aplicação for rejeitada ou aprovada.

P: Posso fazer chamadas de teste após ter comprado um número de telefone?

R: Com certeza, você pode. Você se lembra do botão Teste no editor visual? Ele sempre funciona :)

P: Posso comprar um número de telefone de outro país?

R: Sim, você pode. Para ver a lista de países disponíveis, vá para a aba Comprar um número.

P: Como o número de telefone é pago?

Preencha o Acordo e anexe-o ao formulário de verificação, você pode monitorar o status do seu aplicativo na aba Verificação. Uma notificação será enviada por e-mail assim que sua inscrição for aprovada ou rejeitada.

P: Poso pagar para alugar um número de telefone por mais de 1 mês?

R: Infelizmente não é possível, pois o Kit Voximplant estende automaticamente o período de aluguel, e o valor correspondente é debitado do saldo da sua conta a cada mês, até que você se recuse a continuar usando o número de telefone.

P: O sistema não conseguiu estender o período de aluguel (por exemplo, não há dinheiro suficiente). Vou perder meu número de telefone?

R: Não, você não vai. O número será colocado em espera por 1 mês enquanto aguarda o pagamento. Assim que houve dinheiro suficiente em sua conta para estender o período de aluguel, o número ficará ativo novamente.

P: Eu decidi parar de usar o número de telefone que eu comprei. Você irá reembolsar meu dinheiro?

R: Depende se você passou na verificação. Após recusar a continuar usando o número, você vai perdê-lo imediatamente, e ele estará disponível para compra novamente em 2 meses.

Se você passou na verificação, nenhum reembolso é possível.

Se você não passou na verificação, você receberá um reembolso em até 10 dias úteis.

P: Usei o número comprado para ligar para os clientes. O que irá acontecer se os meus clientes me ligarem nesse número?

R: O seu cliente poderá te ligar de volta e você poderá responder à chamada caso tenha configura o encaminhamento de chamadas para o número de telefone da sua central de atendimento, ou para seu número pessoal (isso é obrigatório de acordo com a legislação russa). Para configurar o encaminhamento de chamadas, vá para a seção Meus números de telefone. Você pode configurar o encaminhamento de chamadas separadamente para cada número de telefone. IMPORTANTE! Uma campanha de chamada não vai começar sem o encaminhamento de chamadas configurado.

P: Outra pessoa pode usar meu número de telefone?

R: Não. Você verifica seu número de telefone individualmente e assume a responsabilidade pessoal pela forma como você usa o número verificado.

P: Quais são as minhas responsabilidades ao usar o Kit Voximplant ?

R: Ao criar uma campanha de chamada, você atesta:

1) que você obteve legalmente os detalhes de contato dos clientes para ligar;

2) que os clientes concordaram em ser notificados de tal forma.

Ao criar uma campanha, você deve selecionar as caixas de seleção com os requisitos correspondentes. Portanto, criar uma campanha de chamada significa que você aceitou as responsabilidades de acordo com a legislação russa.

P: Quais navegadores são suportados pelo Kit Voximplant ?

R: Os seguintes navegadores são suportados: Edge 16+, Firefox 58+, Chrome 61+, Opera 48+, Safari 11+, Yandex Browser, a última versão

Não é recomendável usar o internet Explorer 11, porque alguns elementos do site não puderam ser processados corretamente.

P: O que é um Gerente de campanha?

R: É uma ferramenta passo a passo para especificar uma lógica de campanha de chamada e enviar os detalhes de contato dos clientes. Siga as instruções na tela para criar e iniciar uma campanha.

P: Não consigo fazer o upload do meu arquivo em Excel, há erros o tempo todo. Por quê?

R: Verifique o formato do arquivo: deve ser XLS ou XLSX. O tamanho do arquivo não deve exceder 20 MB. Se esses requisitos forem atendidos, mas se mesmo assim ainda houver erros, por favor nos envie uma captura da tela com a descrição do problema para support@kit.voximplant.com

P: Quero usar dois cenários de chamada, é possível?

R: É possível. No Kit Voximplant, uma campanha sempre contém um cenário, mas você pode iniciar duas campanhas com dois cenários diferentes.

P: Quais valores posso usar como o fuso horário de um cliente?

R: Você pode usar todos os valores UTC existentes de -12:00 a +14:00. Para definir o fuso horário, especifique um valor da tabela. Por exemplo, para configurar UTC +03: 00, especifique os valores UTC Europa / Moscou.

P: Qual deve ser o formato de números de telefone no meu arquivo Excel?

R: Você deve usar o formato E.164: +(código do país) (código de destino nacional (DDD) (número do assinante). Exemplo para os EUA: +14155552671.

Não use caracteres especiais, como pontuação, espaços, traços, sublinhados, parênteses, etc.

O código do país é necessário, pois sua ausência leva ao status de campanha “Erro”.

P: Salvei uma campanha, mas não consegui iniciá-la em uma semana. Por que isso pode ter acontecido?

R: Você pode ter tentado iniciar a campanha após o horário de término especificado. Corrija o horário de término e inicie a campanha novamente. Se o erro persistir, envie uma captura de tela e a descrição do problema para support@kit.voximplant.com

P: Posso testar minha campanha com meus amigos?

R: Apenas se eles não se importarem :)

P: O que são variáveis? Como eu as utilizo?

R: Uma variável é um armazenamento para dados. Por exemplo, o kit Voximplant tem variáveis padrão {{ phone }} e {{ UTC }}. A variável {{ phone }} é usada para armazenar os números de telefone; a variável {{ UTC }} armazena o fuso horário do cliente. Você pode usar variáveis padrão ou criar suas próprias variáveis.

Exemplo 1. Usando uma variável padrão no kit Voximplant.

O conjunto mínimo de blocos acima executa o seguinte:

Inicia um cenário

Liga para um cliente

Se o cliente atender o telefone, o cenário termina com um status de sucesso

O bloco Chamada para Número cobre a etapa 2. Clicar neste bloco abrirá suas configurações. É um bloco simples com apenas um parâmetro: telefone.

Por padrão, o valor do parâmetro é a variável {{ phone }}. A variável {{ phone }} contém os números de telefone dos clientes de seu arquivo Excel (ver New Campaign, passo 4, Mapa). Usando uma variável padrão {{phone}} com base no exemplo do bloco de síntese de fala:

Exemplo 2. Criando e usando uma nova variável.

O bloco de modificação de dados permite que você altere e crie variáveis. Adicione este bloco ao seu cenário e clique nele. As configurações do bloco têm campos Variável e Valor. Clique no campo Variável para selecionar uma variável na lista ou digite um nome para uma nova variável. IMPORTANTE! O nome da variável só pode conter letras e números latinos. Você deve colocar o nome entre chaves. Os nomes das variáveis são sensíveis a maiúsculas e minúsculas; {{Phone}} e {{phone}} são duas variáveis diferentes. Vamos supor que você deseja adicionar o status VIP para um cliente. Para fazer isso, crie uma variável chamada {{VIP}}, defina-a para sim, e clique em salvar. É isso! Agora você pode usar sua nova variável nos próximos blocos.

P: Posso nomear as variáveis como eu quiser?

R: O nome da variável só pode conter letras e números latinos. Você deve colocar o nome entre chaves. Por exemplo: {{name}} ou {{email}}. O nome é sensível a maiúsculas e minúsculas; {{Phone}} e {{phone}} são duas variáveis diferentes.

P: Se eu precisar usar os mesmos valores em cenários diferentes, devo criar as mesmas variáveis em cada cenário manualmente?

R: Não, você não deve. Existem variáveis globais, onde você pode criar variáveis e atribuir a elas os valores necessários. Após criar essa variável, você pode usá-la em qualquer número de cenários.Exemplo. Criando e usando uma variável para cumprimentar um cliente.Vá para Integrações, guia da seção Variáveis globais. Clique em Adicionar parâmetro, preencha os campos Chave e Valor, em seguida, clique em Salvar. É isso! Agora você pode usar a variável de título em qualquer cenário.

Para usar a variável {{GLOBAL.title}}, siga a seguinte sintaxe: {{title}}

Como resultado, temos um texto: “Querido cliente! Temos um desconto para você!”

To use the {{title}} variable, stick to the following syntax: {{GLOBAL.title}}

As a result, we have a text: “Dear customer! We have a discount for you!”

P: Quais são as variáveis usadas com mais frequência?

R: Você pode usar variáveis para armazenar quaisquer dados e nomeá-los como quiser. Recomendamos usar as seguintes combinações de nome e função:

Nome da variável	Objetivo da variável
{{name}}	Nome do cliente usado para se dirigir a ele ou ela pessoalmente
{{email}}	Endereço de e-mail
{{date}}	Data e hora no seguinte formato: DD-MM-AAAA e HH: mm: ss. Por exemplo, 01-12-2017 12:00:00
{{status}}	status da entrega, pedido, cliente e assim por diante
{{address}}	Endereço geográfico (para a entrega, residência do cliente e assim por diante)
{{orderID}}	Número do pedido
{{content}}	Qualquer conteúdo

Você pode usar nomes de variáveis arbitrárias que sejam convenientes para você.

P: Meus clientes me telefonam. Posso usar os números deles em cenários?

R: Sim, você pode. O número que inicia uma chamada é armazenado na variável {{CALL.phone_a}}. Pode ser o ID de chamada de seu cliente ou o ID de chamada de sua campanha telefônica.' Enquanto isso, a variável {{CALL.phone_b}} contém o número do receptor, por exemplo, o número que está sendo chamado pelo seu cliente/campanha.

P: Existem mais variáveis relacionadas à chamada?

R: {{CALL.record_url}} Contém o URL da gravação da chamada, se a gravação foi habilitada. {{CALL.id}} Contém o ID da tentativa. Ele é preenchido apenas após o término da chamada. Usado em hooks HTTP (os blocos “Início do cenário” e “Chamada entrante”). {{CALL.result_code}} O código de término da chamada. É zero durante uma chamada. Valores de exemplo: “2: 'Iniciado pelo receptor'”, “3: 'Fim do cenário'. Exemplo de uso: você pode obter o código do hook HTTP e ver se o receptor desligou ou se ele chegou no bloco “Fim do cenário”. {{CALL.attempt_num}} O número da sequência da tentativa. Relevante somente para chamadas de campanha saintes. Para outras chamadas, é igual a 1. {{CALL.session_id}} O ID da sessão Voximplant. Usado para o número exclusivo de chamada. {{CALL.callerid}} Para chamadas entrantes SIP. Repete o comportamento da variável CALL.phone_a. {{CALL.destination}} Para chamadas entrantes SIP. Repete o comportamento da variável CALL.phone_b. {{CALL.display_name}} O nome do chamador em caso de chamada SIP; é um número de telefone em caso de chamadas de rede telefônica.

P: O que é Detecção de atendedor de chamadas (AMD)?

R: É um recurso que detecta correio de voz e respostas automatizadas: o telefone celular está desligado, a sua chamada não pôde ser conectada, etc. Se o AMD for acionado, um cenário não será executado, e apenas a taxa de AMD será debitada da sua conta. A detecção é realizada durante os 5 primeiros segundos após o cliente ter sido alcançado.

P: Quais são as limitações da detecção de atendedor de chamadas?

1. A precisão pode variar; para países onde treinamos a AMD a precisão é de até 99%.
2. A detecção leva tempo, até 2,5 segundos.
3. Ela é executada por 50 segundos no máximo.

P: Quais tipos de síntese de fala estão disponíveis?

R: A síntese de fala básica é gratuita. A síntese de fala premium, que fornece a melhor qualidade de fala, está disponível nas configurações de bloco de texto para fala (consulte a lista suspensa de idiomas). A síntese em inglês é alimentada por WaveNet. A síntese em russo é alimentada por Yandex SpeechKit: voz masculina (Erkanyavas) e voz feminina (Oksana).

P: E as configurações de síntese?

Você pode usar a SSML (linguagem de marcação de síntese de fala) para melhorar a qualidade do texto sintetizado, pois a SSML afeta os diferentes estágios do processo de síntese. Atualmente, suportamos a tag <break> para todos os idiomas. Essa tag define a pausa entre quaisquer palavras. Você pode usar o atributo de tempo para especificar a duração da pausa em segundos ou em milissegundos, por exemplo, '2s' or '250ms'. Se não houver nenhuma tag <break> entre as palavras, a pausa é determinada automaticamente com base no contexto linguístico. Exemplo. Obrigado pelo seu feedback!<break time='200ms'/> Tchau!

P: Posso usar meus próprios arquivos de mídia em cenários?

R: Claro. Para fazer isso, vá até a seção de áudio na parte superior da tela e envie seu arquivo. Este arquivo estará disponível no menu interativo e nos blocos do Player. O formato suportado é mp3; o tamanho máximo é de 10 MB.

P: Quero encaminhar chamadas para o SIP, é possível?

R: Sim, há o bloco “Encaminhamento de chamadas” com a chave “Número de telefone”/”SIP” nele.

P: Quais campos devo preencher para configurar o encaminhamento de chamadas SIP?

R: Digite um URI SIP no campo apropriado no formato username@host . UDP é usado por padrão para transferência de dados; se houver necessidade de usar TCP, você deve especificá-lo no parâmetro ;transport=tcp, da seguinte forma: alice@example.org;transport=tcp. O valor do ID do chamador deve ser um número de telefone que será exibido para um usuário chamado. Usuário de autenticação (opcional) – um nome de usuário para autenticação SIP. Se não for especificado, o valor do ID do chamador é usado. Nome de exibição (opcional) - um nome do usuário de chamada, que será enviado se o cabeçalho From. Se não for especificado, o campo From estaria no formato xxxxx.kit.voximplant.com, onde o xxxxx é o seu nome da conta. Senha (opcional) - uma senha para autenticação SIP. Proxy sainte (opcional) — um proxy adicional para uma chamada.

P: Uso um firewall, quais endereços de IP e portas devo especificar para receber tráfego?

R: Portas para tráfego UDP: 8000-18000, 20000-30000. Lista de IP:

185.164.148.0/22
69.167.178.6
89.184.65.247
89.219.34.163
95.213.198.99
18.229.108.9
13.48.50.139
3.123.246.217
18.140.111.54
13.55.250.61
51.77.85.41
79.137.19.50
149.202.24.238
66.242.4.112
149.56.83.167
35.187.244.139
35.199.91.11
178.159.33.225
173.0.146.133
35.199.101.147
173.0.146.163
35.197.173.8
203.195.121.227
188.42.37.36
89.184.83.207
89.184.82.139
88.212.234.226

P: Existe uma maneira “avançada” de gerenciar variáveis?

Sim, existem modelos especiais no kit Voximplant para isso; ao usá-los, você pode adicionar uma verificação do horário de trabalho, converter o formato de data, arredondar os valores recuperados, etc.

CEIL

Arredonde para um número inteiro acima. Números com mais de 20 dígitos escritos em notação exponencial e strings causam o erro.

Por exemplo, variável test = 2,344

{{CEIL 5.344}} >>> 6
{{CEIL test}} >>> 3
{{CEIL -1.1}} >>> -1

FLOOR

Arredonde para um número inteiro abaixo. Números com mais de 20 dígitos escritos em notação exponencial e strings causam o erro.

Por exemplo, variável test = 2,344

{{FLOOR 5.344}} >>> 5
{{FLOOR test}} >>> 2
{{FLOOR -1.1}} >>> -2

CHECK_HOURS

Verifique se a hora de uma chamada de função corresponde ao intervalo especificado.

{{CHECK_HOURS '09:30''19:30''+3''all'}} >>> 1 or 0

COMPARE

Comparação de dois valores/variáveis.

Os seguintes caracteres de comparação são suportados: ==, ! = (significa não é igual), >, <, <=, >=

{{#COMPAREv1operatorv2}} if_true {{else}} if_false {{/COMPARE}}

É obrigatório definir explicitamente os valores retornados durante a comparação (e.g., “yes” if the condition is met and “NO” otherwise)

{{#COMPARE\'test\'\'==\'\'tust\'}} true {{else}} false {{/COMPARE}} >>> false

Por exemplo, a variável order_found = sim

{{#COMPAREorder_found\'==\'\'yes\'}}
order found {{else}}
order not found {{/COMPARE}}
>>> order found

CALC

Funções matemáticas: adição, subtração, multiplicação, divisão.

{{#CALC}} equations {{/CALC}}

As variáveis dentro de CALC devem estar entre chaves. Por exemplo, preço variável = 10

{{#CALC}}
' + '{{price}} * 5' + '{{/CALC}}
>>> 50

DATE_CONVERT

Conversão de formato de data.

Por exemplo, variável order_data = 12:00 25.12.2019

{{DATE_CONVERTorder_data\'HH:mm DD.MM.YYYY\'\'DD/MM/YYY\'}}
>>> 25/12/2019

Data original 12:00 23.01.2018
Formato original: HH:mm DD.MM.YYYY

Novo formato	Resultado
MM/DD/AA	01/23/18
MM/DD/AAAA	01/23/2018
AA.MM.DD	18.01.23
AAAA.MM.DD	2018.01.23
DD/MM/AA	23/01/18
DD/MM/AAAA	23/01/2018
DD.MM.AA	23.01.18
DD.MM.AAAA	23.01.2018
DD-MM-AA	23-01-18
DD-MM-AAAA	23-01-2018
HH:mm:SS	12:00:00
MM-DD-AA	01-23-18
MM-DD-AAAA	01-23-2018
AA/MM/DD	18/01/23
AAAA/MM/DD	2018/01/23
AAMMDD	180123
AAAAMMDD	20180123
DD MMM	23 Mar
DD MMMM	23 de março
DD MMMM AAAA	23 de março de 2018
DD MMMM AA	23 de março de 2018
dddd, MMMM D, AAAA	Sexta, 23 de março de 2018
HH:mm:ss.SSS	13:20:00.000
M/D/AA	3/23/18
MMM D, AAAA	Mar 23, 2018
MMMM D, AAAA	23 de março, 2018

PLUCK

Criar um array a partir dos valores de um antigo array com base na chave.

Por exemplo, variável array_sample = [{"id": 1, "value": "q"}, {"id": 2, "value": "w"}, {"id": 3, "value": "e"}]

{{PLUCK array_sample'id'}}
>>> [1,2,3]

FILTERBY

Filtrar dados pelo parâmetro especificado e seu valor. Um novo array é retornado, pois um array de origem não foi modificado.

Por exemplo, variável array_sample = [{"id": 1, "value": "q"}, {"id": 2, "value": "w"}, {"id": 1, "value": "e"}]

{{FILTERBY array_sample'id'1}}
>>> [{"id":1,"value":"q"},{"id":1,"value":"e"}]

FINDBY

Encontrar o primeiro elemento do array que satisfaça o valor de chave fornecido.

Por exemplo, variável array_sample = [{"id": 1, "value": "q"}, {"id": 2, "value": "w"}, {"id": 3, "value": "e"}]

{{FINDBY array_sample'id'1}}
>>> {"id": 1, "value": "q"}

JOIN

Converter um array para uma string com o delimitador especificado.

Por exemplo, variável test = ["summer","autumn","winter","spring"]

{{JOIN test '|'}}
>>> summer|autumn|winter|spring

LENGHT

O comprimento da string/array.

Um array com aspas simples [ 1 , 2 , 3 ] é tratado como uma string (LENGTH - 15). Por exemplo, variável test_str = 'exemplo de texto'
variable test_array = ["apple", "banana", "carrot", "coconut"]
variable test_obj = {"key1": 1, "key2": 2, "key3": 3}

{{LENGTH test_str}} >>> 12
{{LENGTH test_array}} >>> 4
{{LENGTH test_obj}} >>> 3 (number of keys)

LOWERCASE

Converter uma string para minúscula.

Por exemplo, variável test = 'WONDERFUL order'

{{LOWERCASE test}} >>> wonderful order

UPPERCASE

Converter uma string para maiúscula.

Por exemplo, variável test = 'WONDERFUL order'

{{UPPERCASE test}} >>> WONDERFUL ORDER

PHONE_FORMAT

Remova todos os não dígitos da string especificada.

Por exemplo, variável test = '+7-917 562 02 -34'

{{PHONE_FORMAT test}} >>> 79175620234

REPLACE

Substituir um valor por outro na string especificada.

Por exemplo, variável test = 'John'

{{REPLACE 'Hello, my name is NAME''NAME'test}}
>>> Hello, my name is John

REVERSE

Reverter a string/array especificada.

Por exemplo, variável test_str = 'Some text'
variável test_arr = [1,2,3,4,5]

{{REVERSE test_str}} >>> txet emoS
{{REVERSE test_arr}} >>> [5,4,3,2,1]

SORT

Classificar os valores do array em ordem ascendente. Os números são classificados primeiro, e então seguidos pelas letras.

Para ordem descendente, use a opção reverse = 1.
Por exemplo, variável test_array = ['banana', 'apple', 'coconut', 'carrot']

{{SORT test_array}} >>> ["apple","banana","carrot","coconut"]
{{SORT test_arrayreverse=1}} >>> ["coconut","carrot","banana","apple"]

SORTBY

Classificar um array por um argumento específico em ordem ascendente.

Para ordem descendente, use a opção reverse = 1.
Por exemplo, variável array_sample = [{"id": 1, "value": "z"}, {"id": 2, "value": "a"}, {"id": 1, "value": "x"}]

{{SORTBY array_sample 'value'}}
>>> [{"id":2,"value":"a"},{"id":1,"value":"x"},{"id":1,"value":"z"}]

SPLIT

Converter uma string para um array em relação ao delimitador especificado.

Por exemplo, variável test = 'summer;autumn;winter;spring'

{{SPLIT test‘;’}} >>> ["summer","autumn","winter","spring"]

P: Posso conectar o Kit Voximplant com outro serviço?

R: Definitivamente você pode. Existe a funcionalidade de solicitação HTTP no Editor visual: você pode ajustar e testar uma solicitação dentro do bloco. Em seguida, escolha os dados necessários de uma resposta e armazene-os em uma variável para uso posterior.

P: Existem exemplos solicitações HTTP?

R: Vá para a aba de Integrações; existem modelos padrão para solicitações HTTP Você pode editar e testar qualquer um deles; você também pode criar seus próprios modelos para solicitações. Todas as solicitações da aba estão disponíveis em cenários.

P: Como uso solicitações HTTP em cenários?

R: Existe um bloco dedicado para esse fim no Editor visual. Adicione-o ao esquema de uma chamada e abra as configurações do bloco. Primeiro, escolha um modelo ou adicione um em branco de uma lista suspensa e clique em “Copiar”. Se você adicionar um modelo em branco, ele estará ativo apenas no cenário atual e não estará disponível na aba “Integrações”.

Aqui, o botão “Obter dados” executa uma solicitação HTTP e você vê a resposta de um serviço externo como um JSON. Clique em um parâmetro necessário em JSON e veja o nome da variável para o parâmetro na parte direita da caixa de teste; um nome para uma variável pode ser arbitrário. Há também o campo “Padrão” que contém um valor padrão para a variável no caso da solicitação HTTP falhar. Em seguida, clique em “Salvar”. Agora você tem as variáveis nas configurações da solicitação. Finalmente, clique em “Salvar”. É isso! As variáveis recém-criadas podem ser usadas no bloco subsequente.