OmnichannelCentral de conhecimento
Integrações e backups

Preparar a integração com um PABX externo

Planeje o conector necessário para trocar eventos, histórico e comandos de telefonia.

Onde encontrarIntegração técnica de telefonia → API e conector externo

Antes de começar

  • Confira a licença de telefonia e a versão instalada.
  • Tenha o fabricante, a versão e o endereço do PABX da empresa. O fornecedor ou responsável técnico precisa confirmar o conector compatível.

Passo a passo

  1. Informe ao responsável técnico qual PABX, versão e recursos a empresa pretende utilizar.
  2. Confirme que existe um conector compatível ou que ele será implementado para a API de telefonia do Omnichannel.
  3. Defina empresa, ramais e capacidades permitidas. O responsável configura a credencial própria e protege seu armazenamento.
  4. Homologue a chegada de eventos e o histórico com uma conta e chamadas de teste autorizadas, sem pressupor que o discador já faça essa integração.
  5. Habilite comandos somente depois de conferir os ramais permitidos, a entrega ao conector e o retorno real do PABX.
  6. Registre os recursos que foram homologados e mantenha desabilitadas as operações ainda não verificadas.

Resultado esperado

O escopo de telefonia fica definido e pode operar pelas funções efetivamente homologadas no conector.

Observações importantes

  • A API padronizada está documentada no pacote comercial 1.0.44 e preservada na base 1.0.67. Ela não é um conector pronto para todos os fabricantes.
  • O PABX continua externo. Não existe um painel universal de credenciais: use o endereço e o método fornecidos pelo administrador da central.
  • O conector precisa traduzir os eventos e comandos entre o PABX e a API do Omnichannel. Essa configuração é trabalho técnico separado.
  • Credenciais são próprias por empresa. Ramais e capacidades permitidas limitam originação, desligamento e transferência quando habilitados.
  • Solicitação aceita ou entregue ao conector não significa ligação concluída. Confira o resultado devolvido pelo PABX.
  • A API não fornece motor SIP ou mídia. Sua presença não comprova discador, gravação, transcrição ou chamadas WhatsApp homologados na instalação.

Se precisar de ajuda

  • Sem histórico: confira se o conector está autorizado e enviando os eventos do PABX.
  • Comando recusado: confira ativação, capacidade e ramal permitidos antes de repetir.
  • Resultado desconhecido: consulte o conector e o PABX; não conclua que a chamada falhou ou terminou só pela ausência do retorno.