Referência de campos e JQL
Todos os campos que o Gambit adiciona ao Jira, as propriedades que você pode pesquisar e JQL pronta para usar para encontrar clientes, oportunidades, e-mails e receita pelo nome.
Pesquisar por nome
O Gambit armazena nomes, e não apenas códigos, para que você encontre pessoas e empresas do jeito que fala sobre elas. As contas aparecem como “Acme Corp (RBDIR-12)” e as pessoas como “Jane Doe, Raj Patel +2” em qualquer lugar em que o Jira mostra um campo: tickets de software e de serviço, resultados de pesquisa, o aplicativo móvel do Jira e exportações em CSV.
Account.name ~ "acme"
People.names ~ "jane doe"
"Revenue impact.accountNames" ~ "acme"
project = RBDIR AND type = Contact AND summary ~ "jane doe"
O resumo de um Account é o nome da empresa e o resumo de um Contact é o nome completo da pessoa, então a pesquisa de texto comum do Jira também os encontra. Quando uma conta ou um contato é renomeado, o Gambit atualiza o nome em todos os tickets que se referem a ele em até 24 horas.
Se o seu site já tinha um campo chamado “Account” (o Tempo adiciona um, por exemplo), o campo do Gambit se chama “Customer account”: escreva "Customer account".name ~ "acme".
Espaços e tipos de ticket
O assistente de configuração inicial cria três espaços. Estas são as chaves padrão; as suas podem ser diferentes se você escolheu outras.
| Espaço | Chave padrão | Tipos de ticket |
|---|---|---|
| CRM | RBCRM | Deal, Lead, Follow-up, Renewal, Commitment, Approval request, além de tipos de pacote, como Quote e SOW, quando você aplica o pacote Serviços profissionais |
| Directory | RBDIR | Account, Contact |
| Activity | RBACT | Conversation (uma por thread de e-mail), Meeting |
O espaço CRM também contém um ticket Gambit Archive que só os membros de rainbook-admins podem abrir.
Campos próprios do Gambit
Quatro campos pertencem ao Gambit. Você pode pesquisá-los em JQL e adicioná-los a quadros e filtros para tickets de software e de serviço.
| Campo | Em | JQL |
|---|---|---|
Account | Deals, leads, follow-ups, renewals, contacts, Conversations, Meetings e tickets em espaços de software e de serviço aos quais você o adiciona | Account.key = RBDIR-12, Account.name ~ "acme", Account.tier = Enterprise, Account.arr > 50000 |
People | Deals, leads, follow-ups, renewals, Conversations, Meetings | People.contacts = RBDIR-88, People.names ~ "doe", People.roles = champion, People.contactRoles = "RBDIR-88:champion", People.primary = RBDIR-88 |
Revenue impact | Tickets de software e de serviço com clientes vinculados | Veja abaixo |
Health | Accounts, deals, renewals | Health < 40 |
As funções em People são champion, economic-buyer, decision-maker, influencer, user, blocker e other (os pacotes podem adicionar outras). A saúde vai de 0 a 100: “Healthy” é 70 ou mais, “Watch” vai de 40 a 69 e “At risk” é abaixo de 40.
Revenue impact guarda o dinheiro em jogo e todas as contas vinculadas:
| O quê | JQL |
|---|---|
| Receita das contas vinculadas | "Revenue impact.arr" > 100000 |
| Pipeline em aberto dessas contas | "Revenue impact.pipeline" > 0 |
| Receita em contas com saúde abaixo de 40 | "Revenue impact.atRiskArr" > 0 |
| Contas vinculadas | "Revenue impact.accounts" = RBDIR-12, "Revenue impact.accountNames" ~ "acme" |
| Número de contas vinculadas | "Revenue impact.accountCount" >= 3 |
| Maior tier | "Revenue impact.topTier" = Enterprise |
| Renovação mais próxima | "Revenue impact.renewalDate" <= endOfDay("+90d") |
| Solicitações de clientes | "Revenue impact.requests" >= 2 |
| Última atualização | "Revenue impact.asOf" >= -7d |
Os valores ficam na moeda de relatórios do seu site. Para ordenar pelo dinheiro em jogo, use ORDER BY frArr DESC (ou ORDER BY "Revenue impact.arr" DESC); ordenar pela própria coluna Revenue impact ordena os tickets pelas contas vinculadas, e não pelo valor.
Campos do Jira que o Gambit configura
O Gambit também cria campos comuns do Jira, que você pesquisa como qualquer outro campo (por exemplo, "Close date" <= endOfMonth() ou Tier = Enterprise). O proprietário é o campo Responsável do Jira.
| Tipo de ticket | Campos |
|---|---|
| Account | Domain, Other domains, Tier, ARR, Currency, Renewal date, Industry, Employees, Account team, Next step, Gambit summary |
| Contact | Email, Other emails, Phone, Mobile, Title, LinkedIn URL, Do not contact, Account key |
| Deal | Amount, Currency, Close date, Probability, Forecast category, Loss reason, Next step, Gambit summary, Account key, Shared with |
| Lead | Lead company, Lead email, Lead phone, Lead source, Disqualify reason |
| Renewal | Amount, Currency, ARR, Renewal date, Probability, Forecast category, Loss reason |
| Commitment | Promised date, Source quote |
| Conversation | Sent at (última mensagem), First sent at, Direction, Message count, Capture source |
| Meeting | Meeting start, Meeting end, Join link, Location, Capture source |
| Approval request | Approval kind, Approvers, Requested by, Expires at, Reject reason |
| Registros importados | Source system, Source ID, Original created |
Account key guarda a chave da conta (por exemplo, RBDIR-12) em todo ticket do Gambit que se refere a uma conta, então "Account key" ~ "RBDIR-12" funciona em qualquer pesquisa. Shared with lista as pessoas de uma oportunidade privada.
Mover registros para outra conta com a automação
Para mover um contato, uma oportunidade ou um lead para outra conta por meio da automação do Jira, de uma alteração em massa, de uma atualização por CSV ou da API REST, defina um destes dois campos:
- Account key (mais simples): na ação Editar ticket da automação, escolha
Account keye informe a chave da nova conta, por exemploRBDIR-12. O Gambit define o campoAccountcom essa conta. - Account: em Mais opções › Campos adicionais da mesma ação, informe os quatro valores da conta, em que
idé o ID do ticket da conta enameé o resumo dele:
{ "fields": { "Account": { "v": 1, "key": "RBDIR-12", "id": "10123", "name": "Acme" } } }
Nos dois casos, o Gambit move o registro da mesma forma que os editores do próprio aplicativo: o vínculo com a conta antiga é removido, o vínculo empregatício de um contato passa para a nova conta e a visibilidade do registro acompanha a nova conta. Uma alteração em massa move os registros nos próximos minutos. Se for grande demais para o limite do Jira naquela hora, ela termina na hora seguinte.
O Gambit recusa uma chave ou um valor que não seja uma conta do espaço Directory, um campo Account key limpo e um campo Account limpo quando a tela de edição exige o campo. Nesses casos, ele restaura a conta que o registro mantém.
Propriedades que você pode pesquisar
O Gambit também mantém propriedades prontas para pesquisa nos tickets. Pesquise por elas usando os aliases abaixo.
| Alias | O que encontra |
|---|---|
frType | O tipo de registro do Gambit: deal, lead, renewal, conversation e assim por diante |
frAccount | Todos os tickets do Gambit de uma conta |
frContacts | Tickets que envolvem um contato |
frDeals, frPrimaryDeal | Tickets vinculados a uma oportunidade |
frSourceId | O ID de um registro no seu CRM anterior |
frEmail | Um contato pelo endereço de e-mail |
frContactDomain, frEmployer | Contatos pelo domínio de e-mail ou pela conta em que trabalham |
frDomain | Uma conta pelo domínio da web |
frJsmOrg | A conta mapeada para uma organização do Jira Service Management |
frHealth, frHealthBand | Pontuação de saúde e faixa healthy, watch ou at-risk |
frArr, frPipelineValue, frAtRiskArr | Valores de impacto na receita |
frImpactAccounts, frTopTier | Contas do impacto na receita e nível superior |
frThreadEmail | Todas as threads de e-mail com uma pessoa |
frPrivate | Threads que alguém tornou privadas ("true") |
frThreadKey, frRootMsg, frProviderThread | Uma thread pelos identificadores de e-mail |
frEventKey | Uma reunião pelo identificador do calendário |
frProposalKind, frTargets | Solicitações de aprovação por tipo e pelos registros que elas alteram |
frImportRunId, frImportBatchId | Tudo o que uma importação criou |
frHandoffRunId | Tudo o que uma passagem de entrega criou |
Exemplos de pesquisa
Clientes e pessoas:
frEmail = "jane@acme.com"
frDomain = "acme.com"
project = RBDIR AND type = Account AND frHealthBand = "at-risk" ORDER BY ARR DESC
project = RBDIR AND type = Account AND "Renewal date" <= endOfDay("+90d") AND Health < 70
Oportunidades e pipeline:
project = RBCRM AND type = Deal AND statusCategory != Done AND Account.name ~ "acme"
project = RBCRM AND type = Deal AND People.roles = champion AND "Close date" <= endOfQuarter()
frAccount = RBDIR-12 ORDER BY updated DESC
E-mail e reuniões:
frThreadEmail = "jane@acme.com" ORDER BY "Sent at" DESC
project = RBACT AND type = Conversation AND Account.name ~ "acme" AND "Sent at" >= -14d
project = RBACT AND type = Meeting AND "Meeting start" >= startOfDay() AND "Meeting start" <= endOfWeek()
Receita em tickets de produto e suporte:
"Revenue impact.arr" > 100000 AND statusCategory != Done ORDER BY frArr DESC
project = SUP AND "Revenue impact.topTier" = Enterprise AND priority in (High, Highest)
type = Bug AND "Revenue impact.accountNames" ~ "acme"
Substitua RBCRM, RBDIR, RBACT e SUP pelas chaves dos seus espaços. As pesquisas retornam apenas os tickets que você pode abrir, como em todo o Jira.
Comentários em threads de e-mail
Cada mensagem capturada é um comentário na conversa correspondente, com remetente, destinatários, horário de envio, uma prévia curta e os arquivos anexados. As propriedades dos comentários não podem ser pesquisadas em JQL; pesquise o thread, por participante com frThreadEmail ou por texto com text ~ "renewal".
Se você desinstalar
- Os campos, comentários, anexos, vínculos, status e filtros do próprio Jira continuam, assim como o
Account keyem todos os tickets. - Os quatro campos do Gambit (Account, People, Revenue impact e Health) são campos de aplicativo: os valores deles desaparecem na desinstalação e voltam se você reinstalar em até 30 dias.
- As propriedades de pesquisa do Gambit continuam nos seus tickets, mas a pesquisa por elas deixa de funcionar até que o Gambit seja instalado novamente.
O Guia do administrador lista tudo o que você mantém.