Configure o painel do seu CRM

O que o Painel mostra e posso compartilhar widgets com a minha equipe?

O Painel é a tela em que você cai depois do login. Ele mostra widgets sobre os dados do seu CRM: funis de vendas, contagens de tarefas, atividade recente, o que você configurar. Todo widget é seu. Os colegas só o veem depois que você ativa Compartilhar como modelo no editor dele, e então cada um começa a própria cópia a partir dele. Adicionar widgets não exige permissão de função, mas um gráfico conta só os registros que a sua função pode ler, então a cópia de um colega pode mostrar outros números. Adicionar widget só aparece se a sua função pode ler pelo menos uma lista. Em um espaço de trabalho sem listas, o Painel avisa isso e oferece Criar lista a quem gerencia o modelo de dados.

Posso ter vários painéis?

Pode. As etiquetas de visualização acima dos widgets alternam entre os seus próprios painéis com nome, por exemplo um por equipe ou por finalidade; sem nenhuma selecionada, você vê o painel principal, e clicar de novo na visualização selecionada volta a ele. Nova visualização adiciona uma, e V abre o seletor de visualizações, como em uma lista. Cada visualização mantém os próprios widgets e a própria disposição, um novo widget vai para a visualização que você está olhando, e um link para uma visualização abre esse painel para você. As visualizações e os widgets delas são seus até você compartilhá-los: Compartilhar… no menu de uma visualização a mostra a todos no espaço de trabalho ou a funções selecionadas, como em uma lista. Os colegas a encontram então depois das próprias visualizações, como uma etiqueta com a sua foto, e veem os mesmos widgets e o mesmo layout, somente para leitura; todos os números são calculados com o acesso de cada um. Só você pode alterar os widgets; Duplicar como nova visualização dá ao colega uma cópia própria com todos os widgets e a disposição deles, que ele pode alterar à vontade sem mexer na sua. Duplicar uma das suas próprias visualizações copia os widgets dela do mesmo jeito. O painel principal não pode ser compartilhado; compartilhe uma visualização com nome. Um colega que abre o link de uma visualização que não foi compartilhada com ele vê o próprio painel. Excluir uma visualização a move para a Lixeira junto com os widgets dela, e a confirmação os cita; Desfazer ou Restaurar traz os dois de volta.

Posso compartilhar um painel com pessoas de fora do espaço de trabalho?

Pode, com um link público. Em uma visualização de painel que é sua, abra Compartilhar…, escolha Qualquer pessoa com o link e clique em Salvar; o link é criado e copiado, e todos no espaço de trabalho também veem a visualização. Qualquer pessoa com o link vê então os gráficos e os números dessa visualização ao vivo, somente para leitura e sem fazer login, em um endereço que termina em /p/…; a página mostra o nome da visualização e o nome do seu espaço de trabalho. Os números são calculados com o seu acesso, então um link público nunca mostra mais do que você mesmo pode ver. Clicar em uma barra ou em um número abre os registros por trás dele, somente para leitura e com o seu acesso, mostrando o nome do registro e os campos pelos quais o gráfico agrupa ou soma; os visitantes podem pesquisar, filtrar, ordenar e ajustar colunas no painel lateral, mas só nas colunas exibidas, e nada é salvo; nada pode ser alterado, e os registros não abrem nas próprias páginas. Listas, calendários, mapas e linhas do tempo de atividades ficam de fora. Qualquer pessoa com o link vê esses gráficos e registros, então publique só quadros que você se sinta à vontade para mostrar. Copiar copia o link de novo a qualquer momento, Último dia em que o link funciona (UTC) define uma data final opcional, e a caixa mostra quantas vezes o link foi aberto. Escolher outra opção e salvar interrompe o link na hora; escolher Qualquer pessoa com o link de novo cria um novo endereço. As visualizações de lista salvas podem ser publicadas do mesmo jeito (Listas). Enquanto o link está ativo, a etiqueta da sua visualização mostra um globo.

Publicar exige Criar na linha Links públicos da sua função; a função Administrador a tem. Permitir links públicos em Geral desliga e liga de novo todos os links públicos do espaço de trabalho; enquanto está desligado, cada link mostra Link indisponível. Um link também deixa de funcionar quando expira, quando a visualização vai para a Lixeira, ou quando quem o criou perde a permissão, é desativado ou sai do espaço de trabalho. Criar e desligar um link aparecem no Registro de auditoria. O painel principal não pode ser publicado; publique uma visualização com nome. O Mate e outros clientes MCP publicam com manage_data_views ação publish, e o endpoint REST é POST /api/v1/data-views/publish; publicar por lá também mostra a visualização a todos no espaço de trabalho, e compartilhá-la de forma privada ou com funções desliga o link.

Quais tipos de widget existem e quais gráficos eles podem mostrar?

Clique em Adicionar widget para abrir Escolher um widget. Começar do zero vem primeiro, com um cartão por estilo de gráfico (Número, Gráfico de barras, Barras horizontais, Área ao longo do tempo, Tabela de ranking, Rosca, Funil e Radar) mais Linha do tempo de atividades, Próximos, Visão geral do mês e Mapa; um cartão abre o editor com esse estilo já escolhido, e você escolhe os dados. Começar com um modelo lista os widgets que os colegas compartilharam. Para ter um widget montado para você, descreva-o com Perguntar ao Mate no editor de widgets.

• Um gráfico agrega uma lista: contagem, soma, média, mínimo ou máximo de um campo numérico. Agrupe por um campo, por cada registro, por Atribuído a (um registro com dois responsáveis conta para os dois) ou por uma relação, por exemplo Valor do negócio por etapa ou valores dos itens de linha por serviço. Cada registro de origem conta uma vez por grupo, então um negócio vinculado a duas organizações conta inteiro para as duas. Para traçar uma série temporal, agrupe por um campo de data, Criado em ou Atualizado em e escolha um Intervalo de tempo (dia, semana começando na segunda, mês, trimestre ou ano). Os horários são agrupados no fuso horário do navegador que salvou o widget; valores só de data nunca se deslocam, e os registros sem data são contados abaixo do gráfico.
• Linha do tempo de atividades é um feed, do mais recente para o mais antigo, de alterações, mensagens e atividade de canais. Os filtros dela pertencem a esse widget, então várias linhas do tempo podem mostrar coisas diferentes sem afetar umas às outras nem a visualização Atividades de um registro.
• Próximos lista os registros de uma lista por um campo de data ou de data e hora para os próximos dias (14 por padrão, até 90), com uma seção Atrasados para datas anteriores e uma coluna de valor opcional. Filtre os registros concluídos, por exemplo tarefas feitas, para que só os abertos contem como atrasados.
• Visão geral do mês colore cada dia de um mês pela quantidade de registros que caem nele ou pela soma de um campo numérico ou de moeda. As setas mudam o mês, e um dia abre uma lista dos registros dele.
• Mapa posiciona os registros de uma lista na posição armazenada com um campo de endereço e agrupa os registros próximos em clusters numerados. Um campo de escolha única colore os pinos com as cores das opções dele, igual aos gráficos, um campo numérico ou de moeda define o tamanho deles, e um pino abre um cartão com o nome, o endereço, um campo de detalhe opcional e Abrir registro. Um cluster assume a cor de mais da metade dos registros dele; sem essa maioria, ele é um anel sem cor, que a legenda lista como Misto.

Em Aparência, um gráfico pode ser de barras verticais ou horizontais (com ou sem rótulos), uma rosca ou um gráfico de radar, ou um destes:

Um estilo que não combina com o agrupamento fica desativado, com uma dica. Valores calculados exigem acesso às entradas deles.

O que uma linha do tempo de atividades pode mostrar, inclusive eventos de calendário?

Uma linha do tempo mostra as mesmas entradas do Registro de auditoria: alterações de registros com os valores anterior e atual, alterações de administração e de configuração, mensagens, atividade de canais, como conexões do LinkedIn aceitas, e reuniões do calendário de uma conta conectada do Gmail ou do Outlook (o layout de calendário de uma lista e os widgets de calendário mostram registros pelos campos de data, não reuniões). Filtre por Tipo de atividade, Provedor, Canal, Conversa ou Registros relacionados, e limite a tipos de registro ou a registros, ou a uma data De e Até. Os registros relacionados usam Inclui qualquer um de, Exclui todos de, Tem um registro vinculado e Não tem registro vinculado. Filtros diferentes precisam coincidir todos; vários valores em um mesmo filtro coincidem com qualquer um deles.

Carregar itens mais antigos mostra a próxima página. Uma linha pode vincular um registro principal e até três registros relacionados, e uma mensagem pode abrir a conversa dela na Caixa de entrada. Linhas sem registro continuam visíveis sem link.

Como os widgets de calendário tratam datas e fusos horários?

Um campo só de data é um dia do calendário e nunca se desloca. Um campo de data e hora é colocado no dia em que cai no fuso horário do widget, que é o fuso horário do navegador que criou o widget; "hoje" e Atrasados seguem o mesmo fuso horário. O campo de data também pode ser um intervalo de datas ou de data e hora: o registro aparece no dia em que o intervalo dele começa e conta como atrasado quando o intervalo termina. Próximos mostra até 100 registros e até 20 atrasados com o total deles. Visão geral do mês conta ou soma todos os registros do mês, e um dia lista até 100 dos registros dele. Os dois usam os mesmos filtros, o mesmo acesso a registros e as mesmas permissões de campo dos gráficos, então a cópia de um modelo compartilhado de um colega mostra só o que esse colega pode ler.

De onde vem o mapa e quais registros não aparecem nele?

O mapa mostra fronteiras de países, regiões e cidades do Natural Earth (domínio público). Esses arquivos de mapa vêm com o Customermates e são servidos pelo seu próprio servidor Customermates, então abrir um mapa não envia nenhuma requisição a um serviço externo de mapas, tiles, fontes ou geocodificação, e um servidor hospedado por conta própria mostra mapas sem acesso à internet. Os arquivos de mapa só são carregados quando um widget de mapa está na tela.

Um registro aparece onde o campo de endereço dele armazena uma posição: o centro da área do CEP, quando o diretório de códigos postais conhece o código, ou o prédio, depois de uma busca de endereço em um servidor hospedado por conta própria com Photon (veja Como informo um endereço?). Os registros sem endereço, sem posição armazenada ou cujo endereço você não pode ler são contados na dica abaixo do mapa. Um mapa mostra no máximo 2.000 registros; restrinja os filtros se o widget disser que mostra só parte deles. Dê zoom com os botões, com o teclado (+ e -, setas para mover, 0 para redefinir) ou com a roda do mouse segurando Cmd/Ctrl; depois de selecionar o mapa, a roda dá zoom sem a tecla. Em uma tela de toque, um dedo rola a página e dois dedos movem e dão zoom no mapa. Selecione um cluster para dar zoom nele.

Quem vê o quê em uma linha do tempo?

As duas permissões são as linhas Registro de atividades e Mensagens da caixa de entrada da função do membro em Funções, cada uma com Acesso de leitura Todos. Mensagens, atividade de canais e reuniões também exigem o Customermates Cloud e um plano com mensagens (Pro e superiores); as alterações continuam visíveis sem isso. Um valor de filtro excluído ou que deixou de ser acessível para de coincidir e aparece como Filtro indisponível na etiqueta e Seleção indisponível no seletor, para que você possa removê-lo.

Como crio ou edito um widget de gráfico ou de linha do tempo no editor de widgets?

Escolha um estilo de gráfico, Linha do tempo de atividades, Próximos, Visão geral do mês, Mapa ou um modelo em Escolher um widget; todos abrem o mesmo editor. Dê um nome ao widget e depois alterne entre Dados e Aparência. Dados guarda a origem e o que contar; filtros e agrupamento são seções recolhíveis dentro dele, e depois que você agrupa, Filtros de grupos limita quais registros aparecem como grupos. As duas seções de filtros mostram a mesma paleta de Filtros pesquisável de uma lista, e os campos vinculados aparecem como Lista › Campo. Aparência guarda o estilo do gráfico, as cores, a legenda, Mostrar métrica e filtros e Compartilhar como modelo. A Pré-visualização ao vivo acima das configurações mostra o widget com dados reais e se atualiza conforme você muda as coisas; selecione Tamanho no painel para vê-lo nas proporções que ele assume no painel. Clique em Salvar no rodapé.

Clique em um gráfico ou em uma das barras dele para abrir o painel lateral de dados: o gráfico continua no alto e os registros que contribuem aparecem abaixo, com os filtros normais da lista e a paginação. Selecionar outro grupo muda os registros. Abrir na lista abre a visão geral normal com a mesma seleção e os filtros extras; ele consulta todos os dados correspondentes, e não uma amostra de IDs de registro. Clicar em uma linha abre o registro dela. Para editar um widget, use o lápis exibido ao passar o cursor ou ao focar pelo teclado, ou escolha Editar no menu local dele (também disponível com o botão direito). Clicar em uma etiqueta de filtro abre o editor nesse filtro. Redefinir restaura os valores salvos depois que você mudou algo, e o ícone de lixeira no cabeçalho do editor move o widget para a Lixeira depois de uma confirmação. Um novo widget ocupa o primeiro espaço livre. Arraste um widget para movê-lo e arraste uma borda ou um canto para redimensioná-lo (mover fica desativado em dispositivos de toque); a disposição é salva só para você. As alturas se ajustam a linhas de 54 px; os widgets de gráfico e de Número têm no mínimo duas linhas de altura, uma Linha do tempo de atividades no mínimo seis linhas de altura e duas colunas de largura, um widget de calendário no mínimo cinco linhas de altura e duas colunas de largura, e um Mapa no mínimo cinco linhas de altura e três colunas de largura.

Quais controles a barra lateral acrescenta?

A barra lateral guarda o seu trabalho e tem a mesma aparência em todas as telas. No alto estão Pesquisar (Cmd/Ctrl+K, veja Busca global), Perguntar ao Mate (Cmd/Ctrl+J, veja o assistente) e Adicionar (C). Abaixo estão Visão geral com o Painel, a Base de conhecimento, o Calendário, a Caixa de entrada e as Rotinas, depois Dados com as suas listas e, por fim, as suas seções pessoais. As entradas que a sua função não pode abrir ficam ocultas. Caixa de entrada conta as conversas não lidas.

A barra lateral é sua: arraste uma entrada para reordená-la ou movê-la para outra seção, ou use o menu … dela para Mover para cima, Mover para baixo, Mover para a seção (inclusive Nova seção) e Ocultar da barra lateral. Clique no título de uma seção para recolhê-la; o menu … dela (ou o botão direito) oferece Mover para cima e Mover para baixo, e nas seções que você criou também Renomear e Excluir seção. Excluir uma seção move as entradas dela de volta ao lugar padrão; as entradas ocultas continuam ocultas. Personalizar barra lateral no menu pessoal abre uma caixa com uma chave por entrada para mostrá-la ou ocultá-la, Nova seção e, depois que você mudou algo, Restaurar padrão, que, depois de uma confirmação, restaura o layout padrão. Ninguém mais vê as suas mudanças.

O nome do espaço de trabalho no alto abre o menu do espaço de trabalho: os espaços de trabalho de que você faz parte, para alternar entre eles, Criar espaço de trabalho, Convidar membros (se você pode convidar), Membros, Configurações, Faturamento com uma etiqueta do seu plano e do status dele e, para operadores do Customermates, Console do operador. O seu avatar abre o menu pessoal: Perfil e preferências, Tema (Sistema, Claro ou Escuro), Idioma, Atalhos de teclado, Documentação, Enviar feedback, Personalizar barra lateral e Sair. Configurações e G e depois S abrem Perfil e preferências, e a barra lateral passa para a navegação das configurações com Conta (Perfil e preferências, Espaços de trabalho, Canais e calendários, Chaves de API e conectores) e Espaço de trabalho (Geral, Membros, Funções, Faturamento, Registro de auditoria, Webhooks); Voltar, no alto dela, leva de volta à página de onde você veio. Personalizar barra lateral não é oferecido enquanto a navegação das configurações está sendo exibida. Até você confirmar o seu endereço, o seu avatar e a entrada Perfil e preferências mostram E-mail não verificado.

Quais atalhos de teclado existem?

Pressione ? ou escolha Atalhos de teclado no menu pessoal para ver todos os atalhos com as teclas do seu computador (⌘ em um Mac, Ctrl nos demais), agrupados e pesquisáveis. Os atalhos com Cmd/Ctrl e o Esc funcionam em qualquer lugar, até enquanto você digita. As teclas isoladas e as sequências com G só funcionam quando nenhum campo de texto está com o foco e nenhum menu ou caixa de diálogo está aberto.

Depois do G, você tem cerca de um segundo para a segunda tecla; uma dica mostra que o app está esperando. Os atalhos de páginas que a sua função não pode abrir ficam de fora. A pesquisa lista os mesmos comandos com as teclas deles: Perguntar ao Mate no topo, as visualizações da lista em que você está, as páginas, Adicionar e, com mais de um espaço de trabalho, Trocar de espaço de trabalho…. Se você usa entrada por voz ou pressiona teclas sem querer, desative Atalhos de uma tecla no pé da caixa de atalhos; os atalhos com Cmd/Ctrl continuam funcionando. A configuração é pessoal e acompanha você em todos os dispositivos.

O que acontece na primeira execução?

As contas novas passam pelo assistente de boas-vindas antes de ver o Painel: o seu perfil, a Base de conhecimento, os convites da equipe e a conexão de um cliente de IA. O dono pode pular a importação do site, os convites e a conexão de IA; os membros convidados veem só o próprio perfil.

Para agentes

Crie e altere widgets com manage_widgets em vez de operar o editor; ele aceita as mesmas opções do app. Leia um widget antes de atualizá-lo, porque um objeto measure ou displayOptions informado substitui o objeto inteiro, e passe o expectedRevision atual, uma idempotencyKey e, nas atualizações, expectedVersion. Uma série temporal define groupBy.dateInterval e um groupBy.timeZone IANA; linhas do tempo usam activityQuery, widgets de calendário calendarQuery (layout upcoming ou month, o campo de data, um timeZone IANA) e mapas mapQuery (o campo de endereço mais campos opcionais de cor, tamanho e detalhe). get lê um widget de calendário para outra window de até 42 dias, como um mês ou um dia. O tipo do widget não pode mudar. Um layout opcional posiciona um widget na mesma chamada: x e w contam colunas da grade de 12 colunas, y e h contam linhas de 54 px. Widgets de gráfico e de Número precisam de h de pelo menos 2, uma linha do tempo de atividades de w de pelo menos 2 e h de pelo menos 6, um calendário de w de pelo menos 2 e h de pelo menos 5, um mapa de w de pelo menos 3 e h de pelo menos 5, e posições que se sobrepõem são recusadas. Linhas vazias entre widgets são permitidas; o painel move os widgets para cima, para dentro delas. get_calendars lê eventos de calendário. Os esquemas exatos estão no catálogo do MCP.

Quais endpoints REST gerenciam widgets?

Por REST, POST /api/v1/widgets/list devolve todos os widgets das suas visualizações de painel com o viewId e o layout deles, POST /api/v1/widgets/save cria ou atualiza um, POST /api/v1/widgets/layout move e redimensiona vários de uma vez, e POST /api/v1/widgets/delete move um para a Lixeira. Para criar uma linha do tempo, um calendário ou um mapa com widgets/save, envie kind: "activityTimeline", "calendar" ou "map"; sem kind, um novo widget é um gráfico, uma atualização pode omitir as configurações que continuam iguais, e um kind diferente em uma atualização é recusado com widgetKindImmutable. POST /api/v1/widgets/read devolve um widget com os resultados atuais; para um widget de calendário, ele também aceita uma window com from e to. As visualizações de painel são visualizações salvas da superfície dashboard em /api/v1/data-views/.

Relacionados

• Guia rápido
• Guia do app, Registros