Artigos sobre: Configurações

Como mover um negócio no Groner a partir de outro sistema

Seu sistema, o n8n ou o Make podem mudar o status de um negócio no Groner automaticamente, com uma chamada à API. As automações do status rodam como se alguém tivesse movido o card na tela.

Resumo do processo

Criar um usuário para a integração (uma vez).
Gerar o token de acesso, que vale por 500 dias (uma vez).
Anotar os Ids dos status que você vai usar (uma vez).
Mover o negócio, com uma chamada para cada movimentação (sempre que precisar).

Antes de começar

Em todos os endereços abaixo, troque sua-empresa pelo nome que aparece no endereço do seu Groner. Se você acessa solarx.groner.app, a API fica em solarx.api.groner.app.

Você vai precisar de uma ferramenta que faça chamadas HTTP: o próprio sistema da sua empresa, o n8n, o Make ou o Postman para testar.

Passo 1: crie um usuário para a integração

Assim o histórico do negócio mostra claramente o que foi feito pela integração.

Acesse Configurações > Geral & Conta > Equipe > Usuários e crie um usuário, por exemplo Integração, com um e-mail que a sua empresa controle.
Dê a ele um perfil que possa mover negócios: Administrador, Gerente, Supervisor, Vendedor, Pré-vendedor ou Técnico.
Defina uma senha forte e guarde-a junto com o e-mail.

Bom saber: esse usuário ocupa uma vaga de usuário ativo da sua conta, como qualquer outro usuário.

Passo 2: gere o token de acesso

Faça isso uma vez. O token vale por 500 dias; depois, basta gerar outro.

POST https://sua-empresa.api.groner.app/api/Conta/GerarToken
Content-Type: application/json

{
  "email": "integracao@suaempresa.com.br",
  "senha": "a-senha-do-usuario"
}

Na resposta, copie o valor de Content.accessToken. É o seu token.

{
  "StatusCode": 200,
  "Content": {
    "authenticated": true,
    "accessToken": "eyJhbGciOi...",
    "expiration": "..."
  }
}

Se vier "authenticated": false, confira o e-mail e a senha.

Atenção: quem tiver o token consegue fazer no Groner tudo o que o usuário da integração faz. Guarde-o nas credenciais do n8n, do Make ou do seu sistema, nunca em planilhas ou mensagens.

Passo 3: anote os Ids que você vai usar

Id do negócio

É o número que aparece no endereço quando você abre o negócio. Em sua-empresa.groner.app/negocio/196299, o Id é 196299.

Para a automação funcionar, o seu sistema precisa saber o Id do negócio que vai mover. O mais prático é gravar esse Id no seu sistema quando o negócio for criado.

Id de cada status

Liste os status do seu funil, agrupados por etapa, com o token do passo 2:

GET https://sua-empresa.api.groner.app/api/StatusProjeto/AgrupadoPorEtapa
Authorization: Bearer SEU_TOKEN

A resposta traz cada status com o seu Id e o seu nome. Anote o Id dos status para onde a integração vai mover os negócios.

Passo 4: mova o negócio

Esta é a chamada que o seu sistema faz sempre que precisar mover um negócio:

POST https://sua-empresa.api.groner.app/api/Projeto/AdicionarStatus/ID_DO_NEGOCIO
Authorization: Bearer SEU_TOKEN
Content-Type: application/json

{
  "StatusId": 123
}

A etapa acompanha o status automaticamente. As automações configuradas para aquele status rodam normalmente: fila de distribuição, notificações, mensagens de WhatsApp, webhooks de saída e status automáticos.

No n8n ou no Make

Use o módulo HTTP Request com estes campos:

Método: POST
URL: https://sua-empresa.api.groner.app/api/Projeto/AdicionarStatus/ seguido do Id do negócio
Cabeçalho: Authorization com o valor Bearer SEU_TOKEN
Corpo (JSON): {"StatusId": 123}

Opções do corpo da chamada

StatusId (obrigatório): Id do status de destino, anotado no passo 3.
ProcessarRegras (padrão true): roda as automações do status. Deixe como está.
ValidaStatusDisponivel (padrão true): só aceita mover para os Status Disponíveis configurados no status atual, as mesmas regras de quem move pela tela. Com false, move para qualquer status.

Respostas que você pode receber

200: o negócio foi movido. A resposta traz o negócio atualizado.
400 com "Status … não pode ser alterado para o Status …, pois esse status não está configurado para ser movido!": inclua o status de destino nos Status Disponíveis do status atual, ou envie "ValidaStatusDisponivel": false.
400 com "Status … já foi definido!": o negócio já está nesse status. Pode ignorar.
401: token ausente, vencido ou de outra empresa. Confira o cabeçalho Authorization e o endereço sua-empresa. Se o token venceu, gere outro (passo 2).

Outras ações úteis

Tirar um status do negócio

DELETE https://sua-empresa.api.groner.app/api/Projeto/ID_DO_NEGOCIO/RemoverStatus/ID_DO_STATUS
Authorization: Bearer SEU_TOKEN

Marcar como perdido ou ganho

Mova o negócio para o status que a sua empresa usa para isso: um status da etapa de perda ou o status de venda do seu funil. É a mesma chamada do passo 4.

Dicas

Teste primeiro com um negócio de teste, pelo Postman, antes de ligar a automação.
Ao mover pela integração, o histórico do negócio mostra o usuário da integração como autor.
Anote a data em que gerou o token e agende um lembrete para gerar outro antes dos 500 dias.

Veja também

Atualizado em: 08/10/2026

Este artigo foi útil?

Obrigado!