Aprenda Mokapen.

3CX

O 3CX liga a central ao Mokapen para o popup do contacto, o diário de chamadas e, se o configurar, o click-to-call. O Mokapen não se torna a central: gera uma API key e um modelo XML que carrega no admin 3CX. A partir daí o 3CX pergunta ao Mokapen quem é o número, e o Mokapen pode escrever a nota de chamada no contacto ou na empresa.

Panorâmica: Integrações.

Requisitos

• Uma instalação 3CX em que possa abrir Admin → Integrations → CRM e carregar um modelo.
• Plano Mokapen Medium.
• Para o click-to-call, além disso: plano 3CX com Call Control / WebAPI (Enterprise), um host 3CX alcançável a partir do Mokapen, e um ramal mapeado ao utilizador que clica.

API key e modelo

Menu de utilizador → Integrações → 3CX. O Mokapen mostra a API key a usar no modelo CRM: como nome de utilizador da Basic auth, ou no cabeçalho X-Api-Key. Descarregue o modelo XML. A chave já está inserida como valor predefinido. Carregue-o em 3CX Admin → Integrations → CRM.

Na página encontra também o URL base das API CRM: é o endereço que o modelo chama. Se o 3CX estiver atrás de uma rede que não alcança o Mokapen, o popup não abre mesmo com o modelo carregado.

Pode regenerar a chave ao guardar. A anterior deixa de valer: é preciso recarregar o modelo, ou atualizar a chave já colada no 3CX. Deixar a chave antiga na central produz erros de autenticação, não uma segunda ligação.

Notas de chamada e click-to-call

Dois interruptores decidem o comportamento para a agenda:

• Guardar notas de chamada em contactos e empresas — no fim da chamada o Mokapen escreve a nota na ficha encontrada.
• Permitir criação de contactos a partir do 3CX se o número for desconhecido — se o número não estiver na agenda, o Mokapen cria o contacto. Desligue-o se a central receber tráfego genérico (central de sede, números de cortesia): caso contrário cada desconhecido torna-se uma ficha.

O click-to-call é separado. São precisos host 3CX (FQDN) e chave WebAPI / Call Control. Sem chave, o Mokapen diz que a chave Call Control não está configurada. Sem host, que falta o FQDN. Sem mapeamento, a chamada não sabe que ramal fazer tocar.

O mapeamento é uma linha por pessoa, na forma ramal=user_id (exemplo 102=15). Serve tanto para atribuir a nota de chamada ao utilizador certo como para o click-to-call. Se o seu utilizador não tiver uma linha, o Mokapen diz que não há um ramal mapeado. O clique normal chama com 3CX; Shift, Ctrl ou Alt junto com o clique abre o marcador do dispositivo.

Se o 3CX recusar o pedido, verifique por esta ordem FQDN, chave Call Control e ramal. A mensagem na página é que o 3CX não aceitou a chamada.

Quando o popup não sai

• O modelo não foi carregado, ou foi carregado antes da regeneração da chave.
• O número de entrada não coincide com um telefone na agenda e a criação automática está desligada. O popup não tem ficha a abrir.
• Procura a videochamada da marcação. O 3CX não põe Meet ou Teams na ficha de marcação.