Melhoria nas Tabelas Complementares na API e App
Dados de tabelas agora mais estruturados para integrações e aplicativos
Time de Produto
Product Education
O que você precisa saber
- ✓ Informação mais detalhada: Os dados gravados em formato de tabela (grid) agora retornam com seus atributos específicos (grid_parentid, grid_chave, grid_rownumber, grid_colnumber)
- ✓ Visibilidade estruturada: Facilita o consumo dos dados por aplicativos externos e integrações sem depender apenas do texto renderizado
- ✓ Mapeamento completo: Foram adicionados 4 novos campos identificadores nos retornos de tabelas complementares
- ✓ Compatibilidade mantida: O formato visual da tabela em HTML permanece disponível como padrão de sistema
Benefícios diretos
Dados Estruturados
Leitura precisa de linhas e colunas por sistemas externos
Integração Facilitada
Menos esforço técnico para extrair valores específicos de tabelas
Zero Perda de Informação
Acesso direto à referência de cada item cadastrado no grid
Maior Confiabilidade
Informações de campos complementares mais completas nas consultas
O que mudou no VocallContact?
Aprimoramos o retorno das informações de campos complementares do tipo tabela (grid) via API e Aplicativo. Agora, além do formato estruturado de exibição, o sistema entrega os campos identificadores da tabela (linha, coluna, chave e ID pai), permitindo que sistemas e relatórios consumam os dados exatos sem complicações.
Se a sua operação utiliza relatórios personalizados ou aplicativos integrados para ler dados complementares de chamados ou atendimentos, atualize suas rotinas para consumir diretamente as novas chaves de linha e coluna (grid_rownumber e grid_colnumber).
Por que isso importa para você
Benefício
Acesso direto aos valores de tabelas complementares de forma organizada e estruturada em integrações.
Aplicação
Na consulta de dados de atendimentos/chamados via API ou App que possuem tabelas complementares.
Simplicidade
Os dados das linhas da tabela agora contêm identificadores diretos de posição e referência.
Execução
Ao realizar uma requisição GET na API de dados complementares, os atributos do grid serão retornados automaticamente no JSON.
O problema que existia
Dificuldade de leitura em integrações
Os campos do tipo tabela retornavam o bloco completo, dificultando a extração de um valor específico de uma célula sem tratar o texto.
Falta de referências de posição
Não havia indicação clara da linha e coluna de cada item retornado.
Mapeamento incompleto
Quatro valores importantes de referência da tabela complementar não eram enviados na resposta da consulta.
Antes x Depois
Como consultar dados complementares estruturados
Faça a chamada na API
Realize a busca de dados complementares do atendimento ou chamado desejado.
Localize o bloco do Grid
No retorno em JSON, identifique o item com field_type: “Grid” ou os itens vinculados ao registro principal.
Identifique a posição
Utilize as chaves adicionadas (grid_rownumber e grid_colnumber) para identificar exatamente em qual linha e coluna o valor está inserido.
O campo principal da tabela (field_type: “Grid”) continua mantendo seu retorno padrão no atributo valor para fins de exibição e compatibilidade.
Os novos atributos são exibidos nos itens vinculados ao grid (grid_parentid).
Perguntas frequentes
Aproveite dados mais precisos nas suas integrações!
Consulte a documentação atualizada da API e otimize a leitura de relatórios e aplicativos.