55PBX

Adicionando a fonte de dados

O 55PBX é um PABX virtual na nuvem que conta com URA, monitoramento de agentes, gravação de ligações e discador.

Adicionando o conector

Instruções

Para adicionar o conector do 55PBX na plataforma da Kondado, siga os passos abaixo.

1) Faça login na plataforma do 55PBX e, no menu à esquerda vá em Integrações, depois Webservice (API)

2) Na nova página, marque a opção "Habilitar uso do webservice" e clique em "Adicionar" à direita

3) Copie a chave gerada

4) Na plataforma da Kondado, vá para a página de adicionar conectores e selecione o conector do 55PBX

5) Dê um nome para o seu conector e copie e cole a Chave obtida no passo (3)

6) Clique em salvar

Agora está tudo pronto para que você crie seus modelos e obtenha informações como tempo de resposta, renitência, tempo falado e taxa de contato da sua operação!

Pipelines

Diagrama de relacionamento

Clique para expandir

Ligações

Tipo de replicacao: Incremental

Parametros:

Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos

Relacionamentos:

call_id > dynamicfields → Ligações > call_id

Objeto principal

[pt] Registro de ligações telefônicas, uma por linha, com data e horários da chamada, tipo e duração, tempos de espera/URA/conversa, números e DDD/DDI, fila e ramal de atendimento, agente/usuário, custo, tipo de desconexão, URL do áudio e dados do contato vinculado a campanhas de discagem ativa. Cada linha representa uma ligação.

Campo	Tipo
call_id	text	[pt] ID da ligação
wl_attended_hour	text	[pt] Horário do atendimento
ws_ticket_id	text	[pt] ID do Ticket
wu_call_cost	float	[pt] Custo da ligação
wv_campaign_id	text	[pt] ID da campanha de discagem ativa associada à ligação
call_id_origin	text	[pt] Identificador de origem da chamada (campo opcional/legado, ausente na maior parte das ligações).
wx_queue_id	text	[pt] ID da fila de atendimento da ligação
call_area_code	text	[pt] Código de área(DDD)
wx_branch_number_agent	text	[pt] Número do Ramal interno
call_date	timestamp	[pt] Data da Ligação
branch_number	text	[pt] Número do Ramal interno
wl_time_attended	text	[pt] Data e Hora do atendimento
wv_campaign_name	text	[pt] Nome da campanha de discagem ativa associada à ligação
type_call	text	[pt] Tipo/situação da ligação; assume um conjunto fechado de valores (ex.: atendida, não atendida).
wv_data_sobrenome	text	[pt] Sobrenome do contato (dado da lista da campanha de discagem)
wv_campaign_list_name	text	[pt] Nome da lista de contatos da campanha de discagem
wb_call_hour	text	[pt] Horário de entrada da ligação
call_time_waiting	text	[pt] Tempo de espera até o atendimento
call_time_ura	text	[pt] Tempo máximo de duração das chamadas (ativo)
wv_contact_phones_0	text	[pt] Telefone do contato (primeiro número cadastrado na campanha de discagem)
name	text	[pt] Nome do usuário cadastrado no Ramal
week_day	text	[pt] Dia da Semana da ligação
wv_data_id	text	[pt] ID do registro do contato na lista da campanha de discagem
call_document	text	[pt] Documento
call_time_total_duration	text	[pt] Duração total da chamada
call_time_spoken	text	[pt] Tempo Falado
wf_states	text	[pt] Código interno de localidade/região atribuído à ligação pela plataforma (não é o país; o código de país/DDI fica em wg_country_code).
call_disconnection	text	[pt] Tipo da Desconexão (Interna – Ramal / Externa - Cliente)
call_url_audio	text	[pt] URL do áudio (gravação) da ligação; disponível apenas quando há gravação para a chamada.
call_order	float	[pt] ID Pedido
call_number	text	[pt] Número de Telefone
call_number_input	text	[pt] Número de entrada da ligação
queue_name	text	[pt] Fila de atendimento da ligação
wg_country_code	text	[pt] Código de País(DDI)
wv_contact_id	text	[pt] ID do contato associado à ligação na campanha de discagem
wv_contact_name	text	[pt] Nome do contato associado à ligação na campanha de discagem
wv_campaign_list_id	text	[pt] ID da lista de contatos da campanha de discagem
wx_queue_overflow	text	[pt] Lista das filas para as quais a ligação transbordou; vem vazia quando não houve transbordo.
wl_attended_date	timestamp	[pt] Data do atendimento da ligação; preenchida apenas para ligações efetivamente atendidas.
type_call_validate	text	[pt] Indicador de validação do tipo da ligação
way_ura	text	[pt] Tempo na URA
wv_data_nome	text	[pt] Primeiro nome do contato (dado da lista da campanha de discagem)
wt_agents_called	text	[pt] Agentes chamados

pbx55_calls__dynamicfields

[pt] Campos dinâmicos adicionais enviados pela API para cada ligação, no formato chave/valor. Cada linha é um campo dinâmico de uma ligação, relacionando-se com a tabela pbx55_calls pelo identificador da ligação.

Campo	Tipo
call_id	text	[pt] Identificador da ligação à qual este campo dinâmico pertence; cada linha desta tabela é um par chave/valor de uma ligação, e várias linhas compartilham o mesmo identificador (relação N:1 com a tabela principal de ligações). Ligações > > call_id
dynamicfield_key	text	[pt] Nome/chave do campo dinâmico
dynamicfield_value	text	[pt] Valor do campo dinâmico correspondente à chave

Campo

Tipo

call_id

text

[pt] Identificador da ligação à qual este campo dinâmico pertence; cada linha desta tabela é um par chave/valor de uma ligação, e várias linhas compartilham o mesmo identificador (relação N:1 com a tabela principal de ligações).

Ligações > > call_id

dynamicfield_key

text

[pt] Nome/chave do campo dinâmico

dynamicfield_value

text

[pt] Valor do campo dinâmico correspondente à chave

Status dos agentes

Tipo de replicacao: Incremental

Parametros:

Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos

[pt] Histórico de ações de status dos agentes (login e pausas), uma por linha, com data e horários de início/fim, duração, tipo e razão da pausa, ramal/número e nome do agente, fila associada e dados cadastrais do agente (e-mail, IP, jornada e carga horária). Cada linha representa uma ação de status de um agente.

Campo	Tipo
_kdd_rowkey	text	[pt] Chave de replicação da tabela (gerada pela Kondado)
branch	text	[pt] Máscara do Ramal
date	date	[pt] Data da ação
date_end	date	[pt] Hora de fim da ação
diftime	text	[pt] Tempo Restante de Pausa
duration	text	[pt] Duração da ação
event	text	[pt] Ação tomada(Login/Pausa)
hour_end	text	[pt] Hora de fim da ação (HH:MM:SS)
hour_start	text	[pt] Hora de Inicio da ação (HH:MM:SS)
name	text	[pt] Nome do usuário cadastrado no Ramal
number	text	[pt] Número/ramal do agente associado à ação
pause_id	text	[pt] ID da Pausa (Associado apenas a ações de Pausa)
pause_reason	text	[pt] Razão da Pausa (cód - Nome)
quantity	text	[pt] Quantidade associada à ação (quando aplicável)
queue_name	text	[pt] Nome da Fila
event_time	timestamp	[pt] Horário
pis_pasep	text	[pt] Número do PIS/PASEP do agente
local_work	text	[pt] Local de trabalho do agente
pause_type	text	[pt] Tipo da pausa do agente
work_journey	text	[pt] Jornada de trabalho do agente
work_type	text	[pt] Tipo de trabalho/contrato do agente
workload	text	[pt] Carga horária de trabalho do agente
user_ip	text	[pt] Endereço IP a partir do qual o agente realizou a ação
user_email	text	[pt] E-mail do agente
emails	text	[pt] E-mails associados ao agente

Notas

Aviso
1) A API disponibilizada pelo 55PBX é instável e suas integrações podem sofrer com falhas de execução. Fazemos o nosso melhor para contorná-las, mas por vezes suas integrações podem ser desabilitadas caso a API fique indisponível (algo que avisamos por e-mail e notificação em nossa plataforma). Geralmente, basta que você reabilite estas integrações que voltarão a funcionar caso a API do conector já esteja disponível
2) Para todas as integrações, a cada execução, são lidos registros de 24 horas anteriores ao savepoint até a data atual. Esta janela visa garantir que os dados estarão atualizados e corrigir dados do passado que possam ter sofrido alteração
3) Devido à limitações da API, onde o intervalo de datas requisitado para obtenção dos dados aplica-se ao intervalo do registro ao invés de apenas seu início/fim, combinado à ajustes que foram necessários para possibilitar a leitura dos dados sem paginação (não suportado pela API), é possível que alguns registros não sejam lidos caso seu intervalo inteiro não encaixe-se completamente nas divisões do período de leitura realizado pelo nosso algoritmo

Parte desta documentacao foi gerada automaticamente por IA e pode conter erros. Recomendamos verificar informacoes críticas

Integrar o 55PBX à Kondado

Configure o conector do 55PBX na Kondado para extrair dados de ligações e status de agentes diretamente ao seu data warehouse.

1

Habilitar a API no 55PBX

Faça login na plataforma do 55PBX, acesse o menu Integrações e depois Webservice (API). Marque a opção "Habilitar uso do webservice" e clique em "Adicionar" para gerar sua chave de acesso.

2

Copiar a chave de API

Copie a chave gerada no passo anterior. Essa chave será necessária para autenticar a conexão entre o 55PBX e a plataforma de integração de dados da Kondado.

3

Adicionar o conector na Kondado

Na Kondado, vá para a página de adicionar conectores e selecione o conector do 55PBX. Dê um nome para o conector e cole a chave obtida no passo anterior.

4

Salvar e validar a conexão

Clique em salvar para finalizar a configuração. Agora você pode criar modelos e obter métricas como tempo de resposta, retenção, tempo falado e taxa de contato da sua operação telefônica.

5

Escolher o destino dos dados

Defina para qual destino os dados do 55PBX serão enviados, como data warehouse, data lake ou planilhas, para realizar análises e construir dashboards.

Perguntas frequentes

O que é o 55PBX e quais dados posso extrair com a Kondado?▼

O 55PBX é um PABX virtual na nuvem com URA, monitoramento de agentes, gravação de ligações e discador. Com a Kondado, você extrai dados de ligações (tempo de espera, duração, custo, URL do áudio, fila de atendimento) e status dos agentes (login, pausas, duração das ações, filas), permitindo analisar tempo de resposta, retenção, tempo falado e taxa de contato.

Por que minhas integrações do 55PBX são desabilitadas automaticamente?▼

A API do 55PBX é instável e suas integrações podem sofrer falhas de execução. Quando a API fica indisponível, a Kondado desabilita as integrações temporariamente e notifica por e-mail e na plataforma. Geralmente, basta reabilitar as integrações na plataforma para que voltem a funcionar assim que a API estiver disponível novamente.

Como funciona a janela de leitura de dados do conector 55PBX?▼

A cada execução, o conector lê registros das 24 horas anteriores ao savepoint até a data atual. Essa janela de 24 horas garante que os dados estejam atualizados e corrige possíveis alterações em registros do passado, mesmo que já tenham sido extraídos anteriormente.

Alguns registros do 55PBX podem não aparecer nos meus dados?▼

Sim, devido a limitações da API. O intervalo de datas requisitado aplica-se ao intervalo do registro completo (início e fim), não apenas ao início. Além disso, ajustes foram necessários para possibilitar a leitura sem paginação (não suportada pela API). Isso pode fazer com que registros cujo intervalo inteiro não se encaixe nas divisões do período de leitura do algoritmo não sejam extraídos.

Para quais ferramentas posso enviar os dados do 55PBX?▼

Os dados do 55PBX podem ser enviados para diversos destinos suportados pela Kondado, incluindo data warehouses, data lakes, planilhas e ferramentas de BI. Você também pode utilizar os dados para criar dashboards prontos e visualizações personalizadas da sua operação telefônica.

O que são os campos dinâmicos (dynamicfields) na tabela de ligações?▼

A tabela pbx55_calls__dynamicfields armazena campos personalizados associados a cada ligação. Ela contém o call_id (herdado da tabela principal), a dynamicfield_key (nome/chave do campo) e o dynamicfield_value (valor correspondente), permitindo capturar informações customizadas que sua operação configura no 55PBX.

Escrito por

Thassyo Pereira·Publicado em 2020-03-19·Atualizado em 2026-06-01