Para usar a telefonia Verimor no Mavibot, você precisa obter uma chave de API da sua conta Verimor e inseri-la nas configurações de integração.

A Verimor é uma provedora de telecomunicações turca. Seu produto Bulut Santralim é um PABX em nuvem: os funcionários trabalham com ramais internos, e as chamadas são roteadas por esses ramais.

O bot pode conectar um funcionário a um cliente, transferir e encerrar chamadas, recuperar gravações e enviar eventos de chamada para a conversa.

Obtendo os dados necessários

  1. Ative o serviço Bulut Santralim com a Verimor e crie ramais internos para seus funcionários.
  2. Abra Online İşlem Merkezi → Bulut Santralim → Santral Ayarlarım e copie a chave de API. Ela se parece com isto:
K12345678-1234-5678-4321-123456789012
  1. Anote os ramais internos dos funcionários. Você precisará especificá-los nas configurações de acesso.

A chave de API é compartilhada em todo o PABX e é usada tanto para chamadas quanto para recebimento de eventos. Se você regenerá-la no painel da Verimor, certifique-se de salvar novamente o formulário de conexão. Caso contrário, tanto as chamadas quanto os eventos de conversa deixarão de funcionar.

Conexão

Na aba de telefonia, selecione Verimor e insira:

  • Chave de API — a chave da seção Santral Ayarlarım.
  • Número de saída — o número externo que o cliente verá, no formato 908505320000. Este campo é opcional. Se deixado vazio, o número atribuído ao ramal interno do funcionário será usado.

A integração agora está conectada.

Para desconectar a integração, limpe o campo Chave de API e salve as configurações.

Você não precisa configurar o URL de notificação manualmente. O Mavibot o define automaticamente no seu PABX quando a chave de API é salva.

Funcionários

Nas configurações do funcionário, preencha o ramal interno (dahili) — geralmente 3–4 dígitos, por exemplo 1001.

Insira o ramal interno do PABX, não o número de telefone celular do funcionário. Sem ele, o botão de chamada no cartão do cliente não funcionará para esse funcionário.

Chamada a partir do cartão do cliente

Um botão de chamada aparecerá ao lado do número de telefone do cliente no cartão da conversa.

O PABX primeiro chama o ramal interno do funcionário. Somente após o funcionário atender, ele chama o cliente.

Esta ordem é intencional: o cliente não ouvirá silêncio na linha porque o funcionário já está conectado quando o telefone do cliente começa a tocar.

Funções da Calculadora

Chamada de Funcionário para Cliente

verimor_employee_call(client_phone, employee_extension, caller_id)

Parâmetros:

  • client_phone — o número de telefone do cliente. Obrigatório. Use o formato turco 908505320000, ou 00493027590915 para chamadas internacionais.
  • employee_extension — o ramal interno do funcionário cujo telefone tocará. Obrigatório.
  • caller_id — o número que o cliente verá. Opcional. Se omitido, o número de saída das configurações de conexão é usado.

A função retorna call_uuid — o identificador da chamada. Ele também é salvo na variável verimor_call_uuid.

Transferir Chamada

verimor_transfer_call(employee_extension, call_uuid)

Transfere a chamada atual para outro ramal interno.

Parâmetros:

  • employee_extension — o ramal interno para o qual a chamada será transferida. Obrigatório.
  • call_uuid — o identificador da chamada. Opcional. Se omitido, a chamada mais recente do cliente é usada.

Encerrar Chamada

verimor_hangup_call(call_uuid)

Parâmetros:

  • call_uuid — o identificador da chamada. Opcional. Se omitido, a chamada mais recente do cliente é usada.
verimor_get_record_link(call_uuid)

Solicita um link novo para a gravação da chamada.

Parâmetros:

  • call_uuid — o identificador da chamada. Opcional. Se omitido, a chamada mais recente do cliente é usada.

Callbacks Durante uma Chamada

Conforme a chamada progride, callbacks são enviados para a conversa no seguinte formato:

verimor_call_event answer

Eventos possíveis:

Evento Quando é acionado
ringing A chamada está tocando
answer A chamada foi atendida
hangup A chamada foi encerrada
user_hangup O funcionário encerrou a chamada

Chamadas entre funcionários não aparecem na conversa.

Um cenário típico de "sem resposta → enviar mensagem no mensageiro" pode ser acionado por hangup e verificação da variável verimor_call_answered.

Variáveis do Cliente Após uma Chamada

Variável Valor
verimor_call_uuid Identificador da chamada
verimor_call_direction Direção: inbound — o cliente liga para você, outbound — você liga para o cliente
verimor_call_extension Ramal interno do funcionário que atendeu a chamada
verimor_call_duration Duração da chamada em segundos
verimor_call_answered 1 — a chamada foi atendida, 0 — não foi
verimor_hangup_cause Código que indica por que a chamada terminou
verimor_has_record 1 — existe uma gravação, 0 — não existe gravação
verimor_record_link Link para a gravação da chamada após chamar verimor_get_record_link()

Códigos de Motivo de Encerramento

Os valores mais comuns de verimor_hangup_cause são:

Código Significado
NORMAL_CLEARING A chamada foi concluída e terminou normalmente
USER_BUSY Ocupado
NO_ANSWER Sem resposta
ORIGINATOR_CANCEL O chamador desligou antes da chamada ser atendida
CALL_REJECTED A chamada foi rejeitada
UNALLOCATED_NUMBER Número inválido
NO_USER_RESPONSE O assinante está indisponível
NOT_ALLOWED_BY_IYS Sem permissão no İYS, o registro de consentimento turco para chamadas comerciais

Gravações de Chamadas

A gravação de chamadas deve estar habilitada nas configurações do seu PABX Verimor. As gravações são armazenadas na sua conta Verimor.

⏳ Os links de gravação permanecem válidos por 60 minutos a partir do momento em que são solicitados. Depois disso, eles param de funcionar. A Verimor também permite no máximo cinco solicitações de link de gravação por minuto por chave de API.

O que isso significa:

  • A variável verimor_record_link não é preenchida automaticamente. Você deve primeiro chamar verimor_get_record_link().
  • Em um cenário que envia uma gravação, chame verimor_get_record_link() no momento em que a gravação é enviada, não antecipadamente.
  • Verifique verimor_has_record primeiro para não desperdiçar o limite de solicitações em chamadas que não têm gravação.
  • Se você precisar manter uma gravação permanentemente, salve o arquivo no seu próprio armazenamento imediatamente após a chamada.
  • O arquivo de gravações permanece disponível no painel da Verimor, onde as gravações podem ser reproduzidas e baixadas posteriormente.

A gravação de chamadas é regulamentada por lei. Na Turquia, está sujeita aos requisitos da KVKK: o cliente deve ser informado sobre a gravação, e o armazenamento de dados pessoais deve ter uma base legal. O proprietário da conta Verimor é responsável por cumprir os requisitos aplicáveis.

Solução de Problemas

Erro Causa / Solução
Gecersiz anahtar Chave de API inválida. Obtenha a chave atual na seção Santral Ayarlarım.
extension 1005 not found O ramal interno não existe no seu PABX. Certifique-se de que as configurações do funcionário contenham um dahili existente.
"Ramal interno Verimor não especificado" As configurações do funcionário estão vazias ou contêm um número de telefone celular em vez de um ramal interno.
As chamadas funcionam, mas nenhum callback aparece na conversa O URL de notificação não foi configurado. Salve novamente o formulário de conexão.
As chamadas pararam de funcionar após alterar a chave de API A chave foi regenerada no painel da Verimor. Insira a nova chave no formulário de conexão e salve.
O link de gravação não abre O link expirou. Solicite um novo com verimor_get_record_link() ou abra a gravação no painel da Verimor.
O link de gravação não é retornado O limite de cinco solicitações por minuto foi atingido, ou a chamada não tem gravação. Verifique verimor_has_record.