Resumo: em Configurações > Integrações, na área CRM, no cartão HubSpot, você cola o token de um app privado do HubSpot, define as regras (funil, estágio e o que rodar) e diz de que campo vem cada dado. A GYRA+ procura negócios novos na frequência escolhida e grava a situação da proposta em campos do grupo “Gyra+” do negócio.
A integração cria propostas, então ela exige o módulo de Propostas e a permissão de configurar a organização. Sem os dois, a área CRM não aparece em Integrações. Veja Módulos e capacidades.
Como funciona
1
O negócio chega ao estágio gatilho
O seu time move o negócio no funil do HubSpot, como sempre.
2
A GYRA+ encontra o negócio
Na próxima sincronização, a GYRA+ lê os negócios dos estágios gatilho que mudaram desde a última rodada.
3
A proposta nasce
A GYRA+ lê o CPF ou CNPJ, o valor, o prazo, o produto e o contato pelos campos que você mapeou e cria a proposta com a origem CRM. O nome do negócio vira o nome da proposta.
4
A análise roda
A regra dispara a política (relatório) ou a esteira escolhida. Se o produto pede documentos, a GYRA+ abre a solicitação para o cliente e a análise roda quando ela for concluída.
5
A situação volta para o negócio
A cada rodada, a GYRA+ atualiza os campos “Gyra+” do negócio com a situação, o limite, a validade e o link da proposta. Com a decisão final, ela pode mover o negócio de estágio.
Conectar a conta
1
Crie um app privado no HubSpot
Na sua conta do HubSpot, crie um app privado com os escopos
crm.objects.deals.read e crm.objects.deals.write, crm.objects.companies.read, crm.schemas.deals.read e crm.schemas.deals.write e crm.schemas.companies.read. Copie o token do app.2
Abra a integração
No toolbox, vá em Configurações > Integrações. Na área CRM, clique em Conectar no cartão do HubSpot.
3
Cole o token
No cartão Conta, cole o token e clique em Conectar. A GYRA+ testa o token no HubSpot antes de salvar e mostra “Conectada à conta” com o número da sua conta.
Regras: o que dispara a proposta
Cada regra diz: quando um negócio entra neste estágio deste funil, rode isto.
Cada política e cada esteira analisa um tipo de documento só, por isso a regra escolhe uma para CNPJ e outra para CPF. Cada seletor mostra só as do tipo dele, e em Relatório aparecem só as políticas de uso Relatório. Você pode deixar um dos tipos em Nenhuma: o negócio daquele tipo recebe o status Erro com o motivo, e nenhuma proposta nasce.
Você pode ter várias regras, em funis e estágios diferentes. Duas regras não podem usar o mesmo estágio para a mesma ação.
Campos da proposta
Em Campos da proposta, você escolhe de onde vem cada dado. A lista mostra os campos da sua conta do HubSpot, inclusive os que a sua equipe criou.
O documento aceita CPF, CNPJ e CNPJ alfanumérico, com ou sem pontuação. O valor aceita o número do HubSpot e também o formato brasileiro digitado num campo de texto (por exemplo, “1.500,50”).
Produto da proposta
- Desligado o Produto por campo do negócio, vale o produto de cada regra.
- Ligado, cada opção do campo de seleção aponta para um produto. A opção mapeada vence o produto da regra. Uma opção sem produto usa o da regra; se a regra também não tem produto, o negócio recebe o status Erro.
Sincronização
Clique em Salvar e ligar. Ao salvar, a GYRA+ confere a configuração contra a sua conta (funis, estágios e campos precisam existir), cria no negócio o grupo de campos “Gyra+” e começa a primeira sincronização em instantes.
No topo da página, Sincronizar agora antecipa a próxima rodada: os negócios novos entram em até 1 minuto. Desligar integração para de criar propostas; nada é apagado.
Cada rodada cria no máximo 50 propostas. O restante entra na rodada seguinte, do negócio mais antigo para o mais novo.
O que volta para o negócio
Ao salvar, a GYRA+ cria no negócio o grupo “Gyra+” com estes campos. Os campos da análise existem em dois blocos, um para regras de Relatório e outro para regras de Esteira, e cada proposta preenche o bloco da sua regra.
Cada bloco também tem o campo rating, que hoje fica vazio.
A GYRA+ só grava no HubSpot o que mudou. Com Aprovado, Reprovado ou Erro, o negócio deixa de ser acompanhado.
Um negócio, uma proposta por regra
Cada negócio vira no máximo uma proposta por regra. Se o negócio sai do estágio e volta, ou é editado, nenhuma proposta nova nasce. Uma falha no meio do caminho também não duplica: na rodada seguinte, a GYRA+ reencontra a proposta já criada para aquele negócio.Quando o negócio não vira proposta
O negócio recebe o status Erro e o motivo em Gyra+ mensagem. A integração não tenta aquele negócio de novo naquela regra: corrija o dado e, se o pedido continua valendo, crie a proposta pela tela.A situação da integração
O cartão do HubSpot e o topo da página mostram em que pé a integração está:
Se o HubSpot limitar as chamadas, a GYRA+ espera o tempo que ele pedir e segue sozinha.
Na proposta
A proposta criada pelo HubSpot é uma proposta como as outras: aparece em Propostas com a entrada CRM, roda a mesma análise e segue o mesmo caminho até a formalização. A proposta nasce em nome da pessoa que salvou a integração.Próximos passos
Propostas
Situações, origens e como a proposta se liga ao resto.
Integrações no toolbox
Onde ficam os conectores, o CRM e as conexões de API.

