> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://ajuda.groner.app/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # 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 1. **Criar um usuário para a integração** (uma vez). 2. **Gerar o token de acesso**, que vale por 500 dias (uma vez). 3. **Anotar os Ids** dos status que você vai usar (uma vez). 4. **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. 1. 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. 2. Dê a ele um perfil que possa mover negócios: **Administrador**, **Gerente**, **Supervisor**, **Vendedor**, **Pré-vendedor** ou **Técnico**. 3. 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 - [Como gerar um token de API para integrar o Groner com outros sistemas](https://ajuda.groner.app/pt-br/article/como-gerar-um-token-de-api-para-integrar-o-groner-com-outros-sistemas-2okhj6/) - [Como criar leads (novos negócios) e contatos pela API](https://ajuda.groner.app/pt-br/article/como-criar-leads-novos-negocios-e-contatos-pela-api-1eudxx5/) - [Como configurar os status disponíveis na Groner](https://ajuda.groner.app/pt-br/article/como-configurar-os-status-disponiveis-na-groner-vjpiwb/) - [Documentação da API Groner CRM](https://ajuda.groner.app/pt-br/article/documentacao-da-api-groner-crm-vz2bq2/)